@flyingrobots/bijou-mcp 7.2.0 → 8.0.0-rc.1

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

@@ -1 +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"}
+{"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;AAIvD,eAAO,MAAM,sBAAsB,EAAE,SAAS,oBAAoB,EAGjE,CAAC"}

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

@@ -1,232 +1,7 @@
+import { STRUCTURE_DOCS_CATALOG_PART_01 } from "./structure-part01.js";
+import { STRUCTURE_DOCS_CATALOG_PART_02 } from "./structure-part02.js";
 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,
-        },
-    },
+    ...STRUCTURE_DOCS_CATALOG_PART_01,
+    ...STRUCTURE_DOCS_CATALOG_PART_02,
 ];
 //# sourceMappingURL=structure.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/tools/docs-catalog/structure.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/tools/docs-catalog/structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,CAAC,MAAM,sBAAsB,GAAoC;IACrE,GAAG,8BAA8B;IACjC,GAAG,8BAA8B;CAClC,CAAC"}

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

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

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

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

package/dist/tools/docs-catalog/workflow-part01.js

@@ -0,0 +1,124 @@
+export const WORKFLOW_DOCS_CATALOG_PART_01 = [
+    {
+        toolName: "bijou_stepper",
+        family: "stepper()",
+        category: "Feedback and Status",
+        summary: "Horizontal step-progress indicator with completed and active states.",
+        aliases: ["stepper", "steps", "wizard progress", "workflow"],
+        useWhen: [
+            "The process has named sequential stages.",
+            "You want to show both completed and upcoming steps.",
+        ],
+        avoidWhen: [
+            "The flow branches or loops like a graph.",
+            "Only a raw percentage matters.",
+        ],
+        related: ["timeline()", "progressBar()", "tabs()"],
+        exampleArgs: {
+            steps: [{ label: "Build" }, { label: "Test" }, { label: "Deploy" }],
+            current: 1,
+        },
+    },
+    {
+        toolName: "bijou_timeline",
+        family: "timeline()",
+        category: "Feedback and Status",
+        summary: "Vertical sequence of timestamp-like events with status markers.",
+        aliases: ["timeline", "history", "event stream", "chronology"],
+        useWhen: [
+            "Order over time is the main story.",
+            "Each event needs a short label and optional detail.",
+        ],
+        avoidWhen: [
+            "The relationship is graph-shaped rather than sequential.",
+            "You only need the current step, not the event history.",
+        ],
+        related: ["stepper()", "log()", "dag()"],
+        exampleArgs: {
+            events: [
+                { label: "Build", status: "success" },
+                { label: "Deploy", description: "Canary 25%", status: "active" },
+            ],
+        },
+    },
+    {
+        toolName: "bijou_log",
+        family: "log()",
+        category: "Feedback and Status",
+        summary: "Single structured log line with severity treatment.",
+        aliases: ["log", "log line", "event", "status line"],
+        useWhen: [
+            "You need terse operational events.",
+            "Severity should be visible without a full alert box.",
+        ],
+        avoidWhen: [
+            "The message needs explanation, evidence, or grouped detail.",
+            "You are rendering a multi-row history rather than one event.",
+        ],
+        related: ["timeline()", "alert()", "badge()"],
+        exampleArgs: {
+            level: "info",
+            message: "Deployment completed.",
+        },
+    },
+    {
+        toolName: "bijou_badge",
+        family: "badge()",
+        category: "Feedback and Status",
+        summary: "Compact inline status pill.",
+        aliases: ["badge", "pill", "status chip", "label"],
+        useWhen: [
+            "A short state label should stay inline with surrounding content.",
+            "You need low-chrome categorical emphasis.",
+        ],
+        avoidWhen: [
+            "The message needs body text or explanation.",
+            "The state changes over time and deserves a richer progress surface.",
+        ],
+        related: ["alert()", "log()", "progressBar()"],
+        exampleArgs: {
+            text: "LIVE",
+            variant: "success",
+        },
+    },
+    {
+        toolName: "bijou_tabs",
+        family: "tabs()",
+        category: "Navigation",
+        summary: "Horizontal section switcher with one active tab.",
+        aliases: ["tabs", "tab bar", "sections", "navigation tabs"],
+        useWhen: [
+            "People switch between peer views or sections.",
+            "One active choice should be visible at a glance.",
+        ],
+        avoidWhen: [
+            "The choices are sequential workflow steps.",
+            "The navigation is path-like rather than peer-to-peer.",
+        ],
+        related: ["breadcrumb()", "paginator()", "stepper()"],
+        exampleArgs: {
+            items: [{ label: "Overview" }, { label: "Logs" }, { label: "Settings" }],
+            active: 1,
+        },
+    },
+    {
+        toolName: "bijou_breadcrumb",
+        family: "breadcrumb()",
+        category: "Navigation",
+        summary: "Path trail showing where the current surface sits inside a hierarchy.",
+        aliases: ["breadcrumb", "path", "location trail"],
+        useWhen: [
+            "Location context matters more than peer switching.",
+            "You need to show depth inside a hierarchy.",
+        ],
+        avoidWhen: [
+            "Users choose between peer views rather than nested locations.",
+            "The hierarchy is dense enough to need a tree.",
+        ],
+        related: ["tabs()", "tree()", "paginator()"],
+        exampleArgs: {
+            items: ["Home", "Docs", "API"],
+        },
+    },
+];
+//# sourceMappingURL=workflow-part01.js.map

package/dist/tools/docs-catalog/workflow-part01.js.map

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

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

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

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

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

package/dist/tools/docs-catalog/workflow-part02.js

@@ -0,0 +1,115 @@
+export const WORKFLOW_DOCS_CATALOG_PART_02 = [
+    {
+        toolName: "bijou_paginator",
+        family: "paginator()",
+        category: "Navigation",
+        summary: "Compact indicator for current page or viewport position.",
+        aliases: ["paginator", "pagination", "page indicator", "page dots"],
+        useWhen: [
+            "The user needs lightweight position awareness across pages.",
+            "Full tabs or breadcrumbs would be too heavy for the surface.",
+        ],
+        avoidWhen: [
+            "Page labels matter more than page count.",
+            "The navigation is hierarchical rather than sequential.",
+        ],
+        related: ["tabs()", "breadcrumb()", "stepper()"],
+        exampleArgs: {
+            current: 2,
+            total: 5,
+            style: "dots",
+        },
+    },
+    {
+        toolName: "bijou_explainability",
+        family: "explainability()",
+        category: "Rich Panels",
+        summary: "Decision card with rationale, evidence, confidence, and next action.",
+        aliases: ["explainability", "explanation", "decision card", "ai rationale"],
+        useWhen: [
+            "A recommendation or decision needs supporting evidence.",
+            "You want the reader to audit reasoning, not just accept output.",
+        ],
+        avoidWhen: [
+            "The content is simple status or prose without structured rationale.",
+            "A generic box or inspector already carries enough context.",
+        ],
+        related: ["inspector()", "alert()", "note()"],
+        exampleArgs: {
+            title: "Choose table()",
+            label: "Recommendation",
+            rationale: "The data is rectangular and the reader needs aligned field comparison.",
+            evidence: [
+                { label: "Shape", value: "rows × columns" },
+                { label: "Need", value: "compare values side by side" },
+            ],
+            confidence: "high",
+        },
+    },
+    {
+        toolName: "bijou_inspector",
+        family: "inspector()",
+        category: "Rich Panels",
+        summary: "Detail panel with a primary value and structured supporting sections.",
+        aliases: ["inspector", "detail panel", "detail view", "property panel"],
+        useWhen: [
+            "A single object or resource needs focused inspection.",
+            "You need a primary value plus labeled supporting sections.",
+        ],
+        avoidWhen: [
+            "The content is really an alert or recommendation.",
+            "A flat table or list is enough.",
+        ],
+        related: ["explainability()", "box()", "headerBox()"],
+        exampleArgs: {
+            title: "Service",
+            currentValue: "healthy",
+            currentValueLabel: "Status",
+            supportingText: "us-west-2",
+            supportingTextLabel: "Region",
+            sections: [{ title: "Deploy", content: "Canary complete." }],
+        },
+    },
+    {
+        toolName: "bijou_accordion",
+        family: "accordion()",
+        category: "Rich Panels",
+        summary: "Collapsible sections for progressive disclosure.",
+        aliases: ["accordion", "collapsible", "disclosure", "expand/collapse"],
+        useWhen: [
+            "Not every section should be open at once.",
+            "The reader benefits from progressive disclosure.",
+        ],
+        avoidWhen: [
+            "Everything should remain visible together for comparison.",
+            "The user is switching peer views rather than expanding sections.",
+        ],
+        related: ["tabs()", "inspector()", "box()"],
+        exampleArgs: {
+            sections: [
+                { title: "Deploy", content: "Roll canaries to 25%.", expanded: true },
+                { title: "Rollback", content: "Restore the previous stable build." },
+            ],
+        },
+    },
+    {
+        toolName: "bijou_kbd",
+        family: "kbd()",
+        category: "Utility",
+        summary: "Keyboard keycap renderer for inline shortcut hints.",
+        aliases: ["kbd", "keycap", "shortcut key", "keyboard hint"],
+        useWhen: [
+            "You need to show a shortcut inline.",
+            "The key label should read like UI chrome rather than plain prose.",
+        ],
+        avoidWhen: [
+            "The shortcut is incidental and plain text is enough.",
+            "You need a full help table rather than one key hint.",
+        ],
+        related: ["hyperlink()", "badge()", "tabs()"],
+        exampleArgs: {
+            key: "Ctrl+P",
+        },
+    },
+];
+//# sourceMappingURL=workflow-part02.js.map

package/dist/tools/docs-catalog/workflow-part02.js.map

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

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

@@ -1,3 +1,3 @@
-import type { ToolDocsCatalogEntry } from './types.js';
+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

@@ -1 +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"}
+{"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;AAIvD,eAAO,MAAM,qBAAqB,EAAE,SAAS,oBAAoB,EAGhE,CAAC"}