nteract/semiotic

Получает инструкции по использованию для именованного пресета темы Semiotic. Возвращает примеры ThemeProvider, пользовательские свойства CSS и паттерны экспорта design-токенов. Доступные темы: light, dark, high-contrast, pastels, pastels-dark, bi-tool, bi-tool-dark, italian, italian-dark, tufte, tufte-dark, journalist, journalist-dark, playful, playful-dark, carbon, carbon-dark.

Проверяет конфигурацию диаграммы Semiotic на соответствие фреймворку доступности Chartability (POUR-CAF): Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Статически оценивает конфигурацию (без DOM/AT): засчитывает встроенные возможности, которые поставляются с каждым HOC (навигация с клавиатуры, фокусное кольцо, ссылка для пропуска, таблица данных для скринридера, reduced-motion + forced-colors, состояние с возможностью обмена), отмечает пробелы, которые автор может исправить (отсутствие заголовка/описания/сводки, низкий контраст, мелкий текст, кодирование только цветом, неописанные тренды, плотность данных), и направляет всё, что требует реального тестирования с ассистивными технологиями, в пункт 'manual'. Возвращает отчёт по каждому принципу с отмеченными 14 критическими эвристиками. Принимает inChartContainer=true, чтобы засчитать возможности скачивания и обмена данными. Сочетается с ручным тестированием NVDA/JAWS/VoiceOver: Chartability не сертификация pass/fail.

Оценивает диаграмму и её явный контракт артефакта в рамках именованной политики. Инструмент проверяет только предоставленные утверждения, доказательства, идентичность источника, состояние проверки и состояние времени; отсутствующие факты остаются отсутствующими или неизвестными. Результаты ограничены, а усечение явно указывается.

Проверяет конфигурацию графика Semiotic на риски мобильной визуализации. Используйте перед созданием графиков под размер телефона или при адаптации десктопного графика под мобильный. Отмечает фиксированные ширины для десктопа, грубую перегрузку плотности меток, детали, доступные только при наведении, мелкие области нажатия, сложные жесты без элементов управления, зависимость от легенды, перегрузку аннотациями и отсутствие подсказок по мобильной трансформации. Только статический анализ: всё равно проверяйте отрендеренные графики на ширине телефона.

Диагностирует конфигурацию диаграммы Semiotic на типичные проблемы (пустые данные, неправильные размеры, отсутствующие аксессоры, неверная структура данных, проблемы с контрастностью цветов и т. д.). Для ref-based React HOC, которые намеренно не указывают данные, передавайте usageMode='push'; для renderChart/MCP/серверных конфигураций, где данные обязательны, не указывайте usageMode или передавайте 'static'. Проверяет коэффициенты контрастности WCAG и предлагает COLOR_BLIND_SAFE_CATEGORICAL для доступности. Возвращает удобочитаемый диагностический отчёт с конкретными исправлениями.

Оценивает диаграмму Semiotic за один детерминированный проход контроля качества: контракты числовых данных, проверки конфигурации и представления/введения в заблуждение, а также статические эвристики доступности Chartability. Возвращает независимые отчёты аудита, а также список находок, ранжированный по серьёзности, и ленту уведомлений. Передавайте data отдельно, когда оно должно переопределять props.data; используйте inChartContainer, describe или navigable, чтобы описать предполагаемую обёртку доступности. Это статический анализ, он не заменяет ручное тестирование с вспомогательными технологиями или свидетельства рендеринга.

Оценивает явный контракт артефакта по именованной политике и объясняет, почему публикацию или действие отклоняют. Недостающие факты о доказательствах, источнике, проверке и времени остаются явными, а не додумываются.

Возвращает схему пропсов для компонента диаграммы Semiotic. Передайте { component: '<name>' }, чтобы получить его пропсы, или пропустите component, чтобы вывести список всех доступных компонентов. Компоненты с пометкой [renderable] можно передать в renderChart для статичного вывода SVG.

Собирает payload для привязки agent-reader к графику Semiotic: многоуровневое описание на естественном языке L1-L3, предложение коммуникативного акта L4 (что график просит читателя сделать) и структурированное дерево навигации (график → оси/серии → datum). Используйте это, чтобы достоверно интерпретировать график без пикселей.

Диалоговый опрос диаграммы Semiotic. Извлекает статистическую сводку и отвечает на вопросы на естественном языке о данных, трендах и выбросах. Возвращает сводку и рекомендации для ИИ, чтобы сгенерировать текстовый ответ и визуальные аннотации.

Предлагает и оценивает варианты диаграмм для выбранного компонента Semiotic. Использует реестр возможностей и эвристический поиск вариантов: зарегистрированные варианты, консервативные преобразования и кросс-семейные альтернативы с тем же назначением. Возвращает ранжированные предложения с оценками соответствия/новизны/риска, обоснованием и готовыми к использованию props. Используйте после suggestCharts, когда агент хочет активно исследовать варианты, а не остановиться на первой рекомендации диаграммы.

Рекомендует результаты с графиком и без графика на основе явных данных и явного контракта артефакта. Факты о доказательствах, источнике, проверке и времени никогда не синтезируются. Именованная политика может рекомендовать подождать, собрать данные или воздержаться от утверждений вместо того чтобы принудительно строить график.

Рендерит график Semiotic в статический SVG или PNG. Это путь статического снимка: props должны сразу содержать данные, а графики в режиме ref/push через этот инструмент отрендерить нельзя. По умолчанию возвращает текст SVG, а при format='png' - артефакт image/png, плюс блок JSON "Render evidence" (количество меток по типам, разрешённые домены осей, флаг пустоты, число аннотаций, доступное имя). Читайте evidence вместо разбора SVG, чтобы убедиться, что график действительно отрисовал метки данных. Необязательный явный контракт сохраняется в render evidence вместе со своим статусом передачи; отсутствующие факты контракта не выводятся. При необходимости передайте пользовательские CSS-свойства темы (--semiotic-bg, --semiotic-text и т. д.), чтобы задать стиль вывода. Для PNG нужен установленный пакет 'sharp'. Доступные компоненты: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Отрисовывает диаграмму Semiotic со статическими данными как виджет ChatGPT Apps. Использует этот инструмент после suggestCharts/getSchema/diagnoseConfig, когда пользователь хочет увидеть интерактивную диаграмму внутри ChatGPT. Сервер отрисовывает Semiotic в SVG, а виджет добавляет элементы управления для подгонки, масштабирования, данных, наведения и render-evidence. Доступные компоненты: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Предлагает исправления для чарта и явный контракт артефакта. По умолчанию это только предложение. Если включено, безопасное применение заполняет только отсутствующие поля компонента и идентичности конфигурации/данных; существующие привязки никогда не перезаписываются. Несоответствия требуют явной ревизии и переоценки утверждения. Факты об источнике, доказательствах, проверке, одобрении и времени никогда не выдумываются. Возвращаемые контракты не включают образцы доказательств, сообщают о потерях при передаче и не выдаются при превышении лимита в 64 KiB UTF-8.

Проверяет, подходит ли компонент диаграммы для набора данных, и если нет, предлагает ранжированные альтернативы, которые подойдут. Возвращает структурированный статус: ok, alternative или unknown.

Создаёт URL issue на GitHub для сообщений об ошибках Semiotic или запросов на новые функции. Возвращает URL, который пользователь может открыть для отправки. Для ошибок рендеринга включает в тело название компонента, сводку по props и любой вывод diagnoseConfig.

Рекомендует графики на основе лёгкой эвристики для небольшой выборки данных (1-5 строк) с фильтрацией по возможностям (push API, linked hover, SSR, selection, legend). Возвращает ранжированные рекомендации с примерами props. Для более богатого ранжирования по дескрипторам возможностей (оценки, причины, предостережения) и полной таксономии из 13 интентов предпочтителен suggestCharts (множественное число).

Рекомендует диаграммы Semiotic для набора данных с помощью эвристических дескрипторов возможностей. Возвращает ранжированные структурированные предложения с оценками, причинами, оговорками и готовыми к использованию props; вызов LLM не делается.

Создаёт дашборд из взаимодополняющих панелей с диаграммами для набора данных: каждая панель отвечает на отдельную аналитическую задачу (тренд, ранжирование, распределение, корреляция и т.д.), а движок по умолчанию выбирает разные семейства диаграмм. Только эвристика, без вызова LLM. Используйте, когда пользователь просит «покажи эти данные» или «построй дашборд», а не выбирает одну диаграмму.

Рекомендует потоковые графики Semiotic для схемы (не для строковых данных). Принимает fields и, опционально, throughput (band или rows/sec), retention, shape ('append'|'keyed'|'aggregate') и keyFields. Ранжирует XY-графики в реальном времени, а также порядковые/числовые графики с поддержкой push (BarChart, PieChart, BigNumber, GaugeChart, …). Возвращает рекомендации, причины исключения подходящих вариантов и, опционально, дополнительные варианты, когда параметр audience задан.

Собирает многопанельный дашборд из одной или нескольких схем потоков. Учитывает политику компоновки AudienceProfile.dashboard (cellBudget, leadFamilies, windowPreference).

Рекомендует подборки графиков для роста грамотности для набора данных с учётом AudienceProfile. Возвращает графики, которые данные поддерживают, но аудитория с ними не знакома (familiarity ≤ 3 или ≤ 4 при exposureLevel 2), каждый в паре со знакомым графиком, который он может заменить, и с обоснованием. Используйте, когда потребитель хочет мягко познакомить пользователей с менее знакомыми, но более подходящими для анализа визуализациями.

Рекомендует семантическую кодировку token / ISOTYPE для задачи читателя. Используйте перед отрисовкой повторяющихся точек, иконок, глифов, сеток естественных частот, квантильных точечных диаграмм или гибридных представлений bar-token. Возвращает рекомендованный tokenEncoding, предупреждения, альтернативы и соответствующие capability intents для suggestCharts. Принимает канонические token intents (precise-comparison, probability-estimation, risk-communication, memory, support-decision и т. д.) и удобные псевдонимы (measure, estimate probability, understand risk, remember, decide).