@flyingrobots/bijou-mcp 7.0.0 → 7.2.0

package/dist/tools/docs-catalog/motion.js

@@ -0,0 +1,174 @@
+export const MOTION_DOCS_CATALOG = [
+    {
+        toolName: 'bijou_spinner',
+        family: 'spinnerFrame() / createSpinner()',
+        category: 'Feedback and Status',
+        summary: 'Inline spinner glyphs and live spinner controller for indeterminate work.',
+        aliases: ['spinner', 'loading spinner', 'busy indicator', 'working'],
+        useWhen: [
+            'Work is in flight but there is no honest percentage yet.',
+            'You need a compact live-status affordance rather than a large placeholder.',
+        ],
+        avoidWhen: [
+            'Progress is determinate enough for a progress bar or stepper.',
+            'The load state wants a full skeleton or empty-state narrative instead.',
+        ],
+        related: ['progressBar()', 'skeleton()', 'timer()'],
+        exampleArgs: {
+            tick: 3,
+            label: 'Build',
+        },
+    },
+    {
+        toolName: 'bijou_timer',
+        family: 'timer() / createTimer() / createStopwatch()',
+        category: 'Feedback and Status',
+        summary: 'Static and live timer family for countdowns, stopwatches, and elapsed-time readouts.',
+        aliases: ['timer', 'countdown', 'stopwatch', 'elapsed time'],
+        useWhen: [
+            'Time remaining or elapsed time is the core signal.',
+            'You need a compact time readout that can degrade across output modes.',
+        ],
+        avoidWhen: [
+            'The user needs task progression rather than wall-clock duration.',
+            'A timestamp label is enough and no live timer semantics are needed.',
+        ],
+        related: ['progressBar()', 'spinnerFrame() / createSpinner()', 'perfOverlaySurface()'],
+        exampleArgs: {
+            ms: 150000,
+            label: 'Deploy',
+        },
+    },
+    {
+        toolName: 'bijou_sparkline',
+        family: 'sparkline()',
+        category: 'Data Visualization',
+        summary: 'Compact inline trend graph using Unicode block characters.',
+        aliases: ['sparkline', 'inline chart', 'trend line', 'micro chart'],
+        useWhen: [
+            'You need a tiny trend summary inline with a metric.',
+            'A full chart would be too heavy for the available space.',
+        ],
+        avoidWhen: [
+            'The chart needs axes, dense labels, or higher detail.',
+            'The audience needs exact values rather than a quick trend read.',
+        ],
+        related: ['brailleChartSurface()', 'statsPanelSurface()', 'perfOverlaySurface()'],
+        exampleArgs: {
+            values: [1, 5, 3, 8, 2, 7],
+            width: 8,
+        },
+    },
+    {
+        toolName: 'bijou_braille_chart',
+        family: 'brailleChartSurface()',
+        category: 'Data Visualization',
+        summary: 'High-density filled area chart using Unicode Braille sub-pixels.',
+        aliases: ['braille chart', 'area chart', 'dense chart', 'tiny chart'],
+        useWhen: [
+            'You need more visual density than a sparkline can provide.',
+            'The chart should stay text-native but still show trend shape clearly.',
+        ],
+        avoidWhen: [
+            'Exact values or labeled axes matter more than density.',
+            'A single metric trend is compact enough for sparkline().',
+        ],
+        related: ['sparkline()', 'statsPanelSurface()', 'perfOverlaySurface()'],
+        exampleArgs: {
+            values: [1, 4, 2, 8, 3, 7, 5],
+            width: 16,
+            height: 4,
+        },
+    },
+    {
+        toolName: 'bijou_stats_panel',
+        family: 'statsPanelSurface()',
+        category: 'Data Visualization',
+        summary: 'Aligned metrics panel with labels, values, and optional inline sparklines.',
+        aliases: ['stats panel', 'metrics panel', 'telemetry panel', 'perf panel'],
+        useWhen: [
+            'Several metrics belong together inside one compact panel.',
+            'Labels, values, and small trends should stay aligned and readable.',
+        ],
+        avoidWhen: [
+            'You only need one metric and a badge or inline value would do.',
+            'The content is narrative or workflow guidance rather than telemetry.',
+        ],
+        related: ['sparkline()', 'brailleChartSurface()', 'perfOverlaySurface()'],
+        exampleArgs: {
+            entries: [
+                { label: 'FPS', value: '60' },
+                { label: 'frame', value: '16.7 ms', sparkline: [15.8, 16.1, 16.7, 16.4, 17.0] },
+            ],
+            title: 'Perf',
+            width: 28,
+        },
+    },
+    {
+        toolName: 'bijou_perf_overlay',
+        family: 'perfOverlaySurface()',
+        category: 'Data Visualization',
+        summary: 'Prebuilt performance dashboard combining a stats panel and braille chart.',
+        aliases: ['perf overlay', 'performance overlay', 'telemetry overlay', 'fps overlay'],
+        useWhen: [
+            'You need an immediately useful perf HUD without composing several primitives yourself.',
+            'Frame timing, terminal size, and memory should be visible together as one overlay.',
+        ],
+        avoidWhen: [
+            'The app only needs one inline metric or a small sparkline.',
+            'The shell should stay clean and no telemetry overlay belongs on screen.',
+        ],
+        related: ['statsPanelSurface()', 'brailleChartSurface()', 'sparkline()'],
+        exampleArgs: {
+            fps: 60,
+            frameTimeMs: 16.7,
+            frameTimeHistory: [15.8, 16.1, 16.7, 16.4, 17.0],
+            width: 80,
+            height: 24,
+            title: 'Perf',
+        },
+    },
+    {
+        toolName: 'bijou_branding',
+        family: 'loadRandomLogo() / gradientText()',
+        category: 'Narrative and Content',
+        summary: 'Expressive branding helpers for deliberate splash, celebratory, and docs-opening moments.',
+        aliases: ['branding', 'logo', 'gradient text', 'splash', 'hero'],
+        useWhen: [
+            'The interface needs a deliberate branded or celebratory moment.',
+            'Expressive emphasis helps open or orient the experience without carrying critical state.',
+        ],
+        avoidWhen: [
+            'Routine app chrome or task-critical labels need maximum scanability.',
+            'Decoration would compete with the actual work or hide meaning behind color.',
+        ],
+        related: ['markdown()', 'box()', 'renderByMode()'],
+        exampleArgs: {
+            logo: 'BIJOU',
+            headline: 'Release ready',
+        },
+    },
+    {
+        toolName: 'bijou_mode_aware_authoring',
+        family: 'renderByMode()',
+        category: 'Utility',
+        summary: 'Authoring helper for building one semantic primitive that lowers honestly across output modes.',
+        aliases: ['renderByMode', 'mode-aware primitive', 'custom primitive', 'lowering'],
+        useWhen: [
+            'An app needs a domain-specific primitive that does not belong in the shared component catalog.',
+            'The same semantic thing must lower honestly across interactive, pipe, and accessible modes.',
+        ],
+        avoidWhen: [
+            'An existing Bijou family already matches the job.',
+            'Mode branching would only chase cosmetics instead of preserving meaning.',
+        ],
+        related: ['note()', 'badge()', 'markdown()'],
+        exampleArgs: {
+            semanticThing: 'build health',
+            interactive: '[build][healthy]',
+            pipe: 'build health: healthy',
+            accessible: 'Build health is healthy.',
+        },
+    },
+];
+//# sourceMappingURL=motion.js.map

package/dist/tools/docs-catalog/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","sourceRoot":"","sources":["../../../src/tools/docs-catalog/motion.ts"],"names":[],"mappings":"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"}

package/dist/tools/docs-catalog/structure.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDocsCatalogEntry } from './types.js';
+export declare const STRUCTURE_DOCS_CATALOG: readonly ToolDocsCatalogEntry[];
+//# sourceMappingURL=structure.d.ts.map

package/dist/tools/docs-catalog/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/tools/docs-catalog/structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,SAAS,oBAAoB,EAsOjE,CAAC"}

package/dist/tools/docs-catalog/structure.js

@@ -0,0 +1,232 @@
+export const STRUCTURE_DOCS_CATALOG = [
+    {
+        toolName: 'bijou_table',
+        family: 'table()',
+        category: 'Data and Structure',
+        summary: 'Rectangular data grid with headers and box-drawing borders.',
+        aliases: ['table', 'grid', 'rows', 'columns'],
+        useWhen: [
+            'Your data is naturally row-and-column shaped.',
+            'People need to compare values across consistent fields.',
+        ],
+        avoidWhen: [
+            'The structure is hierarchical rather than tabular.',
+            'You need narrative prose more than aligned comparison.',
+        ],
+        related: ['dag()', 'tree()', 'enumeratedList()'],
+        exampleArgs: {
+            columns: [{ header: 'Service' }, { header: 'Status' }],
+            rows: [['api', 'healthy'], ['worker', 'healthy']],
+            width: 40,
+        },
+    },
+    {
+        toolName: 'bijou_tree',
+        family: 'tree()',
+        category: 'Data and Structure',
+        summary: 'Nested hierarchy with Unicode connectors.',
+        aliases: ['tree', 'hierarchy', 'outline', 'nested'],
+        useWhen: [
+            'The data has parent-child nesting.',
+            'Expansion order matters more than cross-node comparison.',
+        ],
+        avoidWhen: [
+            'You need many-to-many relationships or cross-links.',
+            'The data is better scanned as rows and columns.',
+        ],
+        related: ['dag()', 'enumeratedList()', 'table()'],
+        exampleArgs: {
+            nodes: [
+                {
+                    label: 'docs',
+                    children: [{ label: 'design-system' }, { label: 'release' }],
+                },
+            ],
+        },
+    },
+    {
+        toolName: 'bijou_dag',
+        family: 'dag()',
+        category: 'Data and Structure',
+        summary: 'Directed graph with boxed nodes and routed edges.',
+        aliases: ['dag', 'graph', 'dependency graph', 'flow graph'],
+        useWhen: [
+            'Relationships are graph-shaped rather than purely hierarchical.',
+            'You need to show dependencies, branches, or converging flows.',
+        ],
+        avoidWhen: [
+            'A linear timeline or step list would explain the flow more clearly.',
+            'The structure is simple enough for a tree or breadcrumb.',
+        ],
+        related: ['tree()', 'timeline()', 'table()'],
+        exampleArgs: {
+            nodes: [
+                { id: 'build', label: 'Build', edges: ['test'] },
+                { id: 'test', label: 'Test', edges: ['deploy'] },
+                { id: 'deploy', label: 'Deploy' },
+            ],
+            maxWidth: 60,
+        },
+    },
+    {
+        toolName: 'bijou_enumerated_list',
+        family: 'enumeratedList()',
+        category: 'Data and Structure',
+        summary: 'List renderer for bullets, ordered steps, letters, or roman numerals.',
+        aliases: ['enumerated list', 'list', 'bullet list', 'ordered list'],
+        useWhen: [
+            'You need a lightweight ordered or unordered list.',
+            'Sequence matters but rich container chrome would be overkill.',
+        ],
+        avoidWhen: [
+            'Items need per-row metadata or aligned fields.',
+            'The structure is better represented as tabs, steps, or a tree.',
+        ],
+        related: ['stepper()', 'timeline()', 'table()'],
+        exampleArgs: {
+            items: ['Build', 'Test', 'Deploy'],
+            style: 'arabic',
+        },
+    },
+    {
+        toolName: 'bijou_box',
+        family: 'box()',
+        category: 'Containers and Layout',
+        summary: 'Generic bordered container for prose, status, or grouped content.',
+        aliases: ['box', 'panel', 'container'],
+        useWhen: [
+            'Content needs a visible boundary or title.',
+            'You want a neutral container that does not imply workflow state.',
+        ],
+        avoidWhen: [
+            'The content wants a more opinionated component such as alert or inspector.',
+            'The output is simple enough to stay as plain text.',
+        ],
+        related: ['headerBox()', 'alert()', 'inspector()'],
+        exampleArgs: {
+            content: 'Release ready for canary.',
+            title: 'status',
+        },
+    },
+    {
+        toolName: 'bijou_header_box',
+        family: 'headerBox()',
+        category: 'Containers and Layout',
+        summary: 'Compact labeled container with a heading and optional detail line.',
+        aliases: ['header box', 'summary panel', 'heading panel'],
+        useWhen: [
+            'A compact callout needs a strong label up front.',
+            'You want a container with more voice than a generic box.',
+        ],
+        avoidWhen: [
+            'You need multi-section detail instead of a headline summary.',
+            'The content is only one line and does not need chrome.',
+        ],
+        related: ['box()', 'inspector()', 'alert()'],
+        exampleArgs: {
+            label: 'Release',
+            detail: 'stable',
+        },
+    },
+    {
+        toolName: 'bijou_separator',
+        family: 'separator()',
+        category: 'Containers and Layout',
+        summary: 'Horizontal rule with optional centered label.',
+        aliases: ['separator', 'divider', 'rule'],
+        useWhen: [
+            'You need a clear break between sections.',
+            'A short label should orient the next block of content.',
+        ],
+        avoidWhen: [
+            'You need an actual container rather than a visual divider.',
+            'The surrounding layout already makes section boundaries obvious.',
+        ],
+        related: ['box()', 'headerBox()', 'tabs()'],
+        exampleArgs: {
+            label: 'release queue',
+            width: 32,
+        },
+    },
+    {
+        toolName: 'bijou_constrain',
+        family: 'constrain()',
+        category: 'Containers and Layout',
+        summary: 'Text truncation helper for bounded width and height.',
+        aliases: ['constrain', 'truncate', 'clamp', 'ellipsis'],
+        useWhen: [
+            'Free-form text must fit a strict width or height.',
+            'A preview should stay honest without rewriting the source text.',
+        ],
+        avoidWhen: [
+            'You actually need wrapping instead of truncation.',
+            'The source content is important enough to merit a scrollable container.',
+        ],
+        related: ['box()', 'markdown()', 'table()'],
+        exampleArgs: {
+            content: 'This is a long release note preview that should be clipped before it overruns the surrounding layout.',
+            maxWidth: 26,
+        },
+    },
+    {
+        toolName: 'bijou_alert',
+        family: 'alert()',
+        category: 'Feedback and Status',
+        summary: 'Severity callout with icon and bordered container.',
+        aliases: ['alert', 'warning', 'error', 'success', 'info'],
+        useWhen: [
+            'A message needs strong severity signaling.',
+            'The reader should treat the content as a callout rather than ambient copy.',
+        ],
+        avoidWhen: [
+            'You need transient notification behavior rather than a static panel.',
+            'The state is low-stakes enough for a badge or note.',
+        ],
+        related: ['badge()', 'log()', 'explainability()'],
+        exampleArgs: {
+            message: 'Canary error budget is almost exhausted.',
+            variant: 'warning',
+        },
+    },
+    {
+        toolName: 'bijou_note',
+        family: 'note()',
+        category: 'Feedback and Status',
+        summary: 'Calm explanatory note for form flows and inline guidance without alert-level urgency.',
+        aliases: ['note', 'helper text', 'supporting note', 'inline guidance'],
+        useWhen: [
+            'You need supportive explanatory text that should not compete with primary status messaging.',
+            'A form, guided flow, or inspector needs clarifying context without turning into an alert.',
+        ],
+        avoidWhen: [
+            'The message carries urgency, severity, or a required next action.',
+            'The content is long-form prose that should live in markdown() or guidedFlow().',
+        ],
+        related: ['alert()', 'markdown()', 'group() / wizard()'],
+        exampleArgs: {
+            title: 'Deploy window',
+            message: 'Rotate credentials after the canary completes.',
+        },
+    },
+    {
+        toolName: 'bijou_progress_bar',
+        family: 'progressBar()',
+        category: 'Feedback and Status',
+        summary: 'Static completion bar with optional percent label.',
+        aliases: ['progress', 'progress bar', 'percent', 'completion'],
+        useWhen: [
+            'A single bounded percentage is the important state.',
+            'You need a compact progress signal inside another surface.',
+        ],
+        avoidWhen: [
+            'The workflow has named steps rather than a pure percent.',
+            'The state is indeterminate and should be shown as loading instead.',
+        ],
+        related: ['stepper()', 'timeline()', 'skeleton()'],
+        exampleArgs: {
+            percent: 72,
+            width: 20,
+        },
+    },
+];
+//# sourceMappingURL=structure.js.map

package/dist/tools/docs-catalog/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/tools/docs-catalog/structure.ts"],"names":[],"mappings":"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"}

package/dist/tools/docs-catalog/types.d.ts

@@ -0,0 +1,21 @@
+export interface ToolInteractionProfiles {
+    readonly interactive: string;
+    readonly static: string;
+    readonly pipe: string;
+    readonly accessible: string;
+}
+export interface ToolDocsCatalogEntry {
+    readonly toolName: string;
+    readonly family: string;
+    readonly category: string;
+    readonly summary: string;
+    readonly aliases: readonly string[];
+    readonly useWhen: readonly string[];
+    readonly avoidWhen: readonly string[];
+    readonly interactionProfiles?: Partial<ToolInteractionProfiles>;
+    readonly related: readonly string[];
+    readonly exampleArgs?: Record<string, unknown>;
+}
+export declare const DEFAULT_INTERACTION_PROFILES: ToolInteractionProfiles;
+export declare const DEFAULT_DOCS_ONLY_INTERACTION_PROFILES: ToolInteractionProfiles;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/docs-catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/docs-catalog/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,4BAA4B,EAAE,uBAK1C,CAAC;AAEF,eAAO,MAAM,sCAAsC,EAAE,uBAKpD,CAAC"}

package/dist/tools/docs-catalog/types.js

@@ -0,0 +1,13 @@
+export const DEFAULT_INTERACTION_PROFILES = {
+    interactive: 'Rendered through a plain-style interactive context with Unicode structure and no ANSI color.',
+    static: 'Matches the interactive MCP output because the wrapper returns a plain-text rendering rather than a live terminal state.',
+    pipe: 'Not separately lowered by the MCP wrapper; the returned result is already plain text suitable for logs, prompts, and transcripts.',
+    accessible: 'No dedicated accessible lowering is exposed by this MCP wrapper yet, so callers should treat the plain-text structure as the accessible fallback.',
+};
+export const DEFAULT_DOCS_ONLY_INTERACTION_PROFILES = {
+    interactive: 'No dedicated MCP render tool is exposed today. bijou_docs documents this first-party family directly and can synthesize a representative plain-text example when examples are requested.',
+    static: 'Matches the docs-only interactive sample because bijou_docs returns a plain-text reference rendering rather than a live terminal session.',
+    pipe: 'The synthesized example output is already plain text suitable for logs, prompts, and transcripts.',
+    accessible: 'No dedicated accessible lowering is exposed for this docs-only entry yet, so callers should treat the plain-text sample and guidance as the accessible fallback.',
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/docs-catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/docs-catalog/types.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,4BAA4B,GAA4B;IACnE,WAAW,EAAE,8FAA8F;IAC3G,MAAM,EAAE,0HAA0H;IAClI,IAAI,EAAE,mIAAmI;IACzI,UAAU,EAAE,mJAAmJ;CAChK,CAAC;AAEF,MAAM,CAAC,MAAM,sCAAsC,GAA4B;IAC7E,WAAW,EAAE,0LAA0L;IACvM,MAAM,EAAE,2IAA2I;IACnJ,IAAI,EAAE,mGAAmG;IACzG,UAAU,EAAE,kKAAkK;CAC/K,CAAC"}

package/dist/tools/docs-catalog/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDocsCatalogEntry } from './types.js';
+export declare const WORKFLOW_DOCS_CATALOG: readonly ToolDocsCatalogEntry[];
+//# sourceMappingURL=workflow.d.ts.map

package/dist/tools/docs-catalog/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/tools/docs-catalog/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,SAAS,oBAAoB,EA0OhE,CAAC"}