@lando-labs/lando-ds-mcp 4.0.0

package/build/tools/get-component-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-props.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAY7E,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBxF"}

package/build/tools/get-component-props.js

@@ -0,0 +1,46 @@
+/**
+ * get_component_props Tool — meta-backed (v3.0.0).
+ *
+ * Returns a TypeScript interface for the requested component's props,
+ * derived from `meta.components[X].props`. Names in meta are PascalCase
+ * (Button, DatePicker) — this tool accepts them as-is.
+ *
+ * Post-#40: props already come from meta in structured form (type,
+ * required, default, description). This tool renders that as a TS
+ * interface for AI consumers who want a familiar shape. A future
+ * `format: 'jsonSchema'` param can expose the raw structured form.
+ */
+import { z } from 'zod';
+import { getComponent, getComponentNames, renderHtmlAttrsFooter } from '../utils/meta-loader.js';
+const componentNames = getComponentNames();
+export const getComponentPropsSchema = z.object({
+    componentName: z.enum(componentNames).describe('PascalCase name of the component (e.g. "Button", "DatePicker"). Must be a name in `list_components`.'),
+});
+function renderPropLine(name, prop) {
+    const optional = prop.required ? '' : '?';
+    const jsdocParts = [];
+    if (prop.description)
+        jsdocParts.push(prop.description);
+    if (prop.default)
+        jsdocParts.push(`@default ${prop.default}`);
+    const jsdoc = jsdocParts.length > 0 ? `  /** ${jsdocParts.join(' — ')} */\n` : '';
+    return `${jsdoc}  ${name}${optional}: ${prop.type}\n`;
+}
+export async function getComponentProps(params) {
+    const { componentName } = params;
+    const cmp = getComponent(componentName);
+    if (!cmp) {
+        // Should be prevented by the Zod enum, but keep the guard for safety.
+        throw new Error(`Component "${componentName}" not found in DS meta.`);
+    }
+    const propNames = Object.keys(cmp.props).sort();
+    const propLines = propNames.map((n) => renderPropLine(n, cmp.props[n])).join('');
+    let out = `/**\n * ${componentName}Props\n * Category: ${cmp.category}\n`;
+    if (cmp.deprecated) {
+        out += ` * DEPRECATED since ${cmp.deprecated.since} — use ${cmp.deprecated.replacedBy} (removal ${cmp.deprecated.removeAt})\n`;
+    }
+    out += ` */\ninterface ${componentName}Props {\n${propLines}}\n`;
+    out += renderHtmlAttrsFooter(cmp);
+    return out;
+}
+//# sourceMappingURL=get-component-props.js.map

package/build/tools/get-component-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-props.js","sourceRoot":"","sources":["../../src/tools/get-component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEhG,MAAM,cAAc,GAAG,iBAAiB,EAA2B,CAAA;AAEnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,sGAAsG,CAAC;CACvJ,CAAC,CAAA;AAIF,SAAS,cAAc,CAAC,IAAY,EAAE,IAAuF;IAC3H,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IACzC,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,IAAI,CAAC,WAAW;QAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACvD,IAAI,IAAI,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAE7D,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IACjF,OAAO,GAAG,KAAK,KAAK,IAAI,GAAG,QAAQ,KAAK,IAAI,CAAC,IAAI,IAAI,CAAA;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAA+B;IACrE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;IAChC,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAA;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,sEAAsE;QACtE,MAAM,IAAI,KAAK,CAAC,cAAc,aAAa,yBAAyB,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEhF,IAAI,GAAG,GAAG,WAAW,aAAa,uBAAuB,GAAG,CAAC,QAAQ,IAAI,CAAA;IACzE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,GAAG,IAAI,uBAAuB,GAAG,CAAC,UAAU,CAAC,KAAK,UAAU,GAAG,CAAC,UAAU,CAAC,UAAU,aAAa,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,CAAA;IAChI,CAAC;IACD,GAAG,IAAI,kBAAkB,aAAa,YAAY,SAAS,KAAK,CAAA;IAChE,GAAG,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAA;IAEjC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/tools/get-component-reference.d.ts

@@ -0,0 +1,25 @@
+/**
+ * get_component_reference Tool — merged docs + examples (v3.0.0).
+ *
+ * Single-call full component context, replacing v2.x's split between
+ * `get_component_docs` and `get_usage_example`. Reads from verbose meta
+ * (description, examples, composes, appliesClassNames) and augments with
+ * light meta (category, platforms, deprecation).
+ *
+ * The `include` array is optional; omitting it returns all sections.
+ * Consumers who need a lighter payload can pass e.g. `include: ['examples']`.
+ */
+import { z } from 'zod';
+export declare const getComponentReferenceSchema: z.ZodObject<{
+    componentName: z.ZodEnum<[string, ...string[]]>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<["description", "examples", "composes", "props", "appliesClassNames"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    componentName: string;
+    include?: ("props" | "description" | "examples" | "composes" | "appliesClassNames")[] | undefined;
+}, {
+    componentName: string;
+    include?: ("props" | "description" | "examples" | "composes" | "appliesClassNames")[] | undefined;
+}>;
+export type GetComponentReferenceParams = z.infer<typeof getComponentReferenceSchema>;
+export declare function getComponentReference(params: GetComponentReferenceParams): Promise<string>;
+//# sourceMappingURL=get-component-reference.d.ts.map

package/build/tools/get-component-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-reference.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,2BAA2B;;;;;;;;;EAStC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAwCrF,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDhG"}

package/build/tools/get-component-reference.js

@@ -0,0 +1,112 @@
+/**
+ * get_component_reference Tool — merged docs + examples (v3.0.0).
+ *
+ * Single-call full component context, replacing v2.x's split between
+ * `get_component_docs` and `get_usage_example`. Reads from verbose meta
+ * (description, examples, composes, appliesClassNames) and augments with
+ * light meta (category, platforms, deprecation).
+ *
+ * The `include` array is optional; omitting it returns all sections.
+ * Consumers who need a lighter payload can pass e.g. `include: ['examples']`.
+ */
+import { z } from 'zod';
+import { getVerboseComponent, getComponentNames, renderHtmlAttrsFooter, } from '../utils/meta-loader.js';
+const componentNames = getComponentNames();
+export const getComponentReferenceSchema = z.object({
+    componentName: z.enum(componentNames).describe('PascalCase name of the component (e.g. "Button", "DatePicker").'),
+    include: z
+        .array(z.enum(['description', 'examples', 'composes', 'props', 'appliesClassNames']))
+        .max(5)
+        .optional()
+        .describe("Sections to include (default: description + examples + composes + props). Omit or pass all values for full reference. 'appliesClassNames' is only present for components whose maintainer chose to expose theming class-name maps."),
+});
+const DEFAULT_INCLUDE = ['description', 'examples', 'composes', 'props'];
+function renderPropsSection(props) {
+    const names = Object.keys(props).sort();
+    if (names.length === 0)
+        return '_No props._\n';
+    let out = '';
+    for (const name of names) {
+        const p = props[name];
+        const req = p.required ? '**required**' : 'optional';
+        out += `- \`${name}\` (${req}, type: \`${p.type}\`)`;
+        if (p.default)
+            out += `, default: \`${p.default}\``;
+        out += `\n`;
+        if (p.description)
+            out += `  - ${p.description}\n`;
+    }
+    return out;
+}
+function renderComposesSection(composes) {
+    if (!composes || Object.keys(composes).length === 0)
+        return '_No formal composition hints._\n';
+    let out = '';
+    for (const [prop, hint] of Object.entries(composes)) {
+        out += `- \`${prop}\` accepts a \`${hint.accepts}\` (as \`${hint.as}\`)\n`;
+    }
+    return out;
+}
+function renderAppliesClassNames(map) {
+    if (!map || Object.keys(map).length === 0)
+        return '_No theming class-name maps exposed._\n';
+    let out = '';
+    for (const [variantProp, classMap] of Object.entries(map)) {
+        out += `- **${variantProp}**\n`;
+        for (const [variant, className] of Object.entries(classMap)) {
+            out += `  - \`${variant}\` → \`${className}\`\n`;
+        }
+    }
+    return out;
+}
+export async function getComponentReference(params) {
+    const { componentName } = params;
+    const include = new Set(params.include ?? DEFAULT_INCLUDE);
+    const cmp = getVerboseComponent(componentName);
+    if (!cmp) {
+        return `Error: \`${componentName}\` is not registered in DS meta.`;
+    }
+    let out = `# ${componentName}\n\n`;
+    out += `**Category**: ${cmp.category}\n`;
+    out += `**Subpath**: \`${cmp.subpath}\`\n`;
+    if (cmp.ref)
+        out += `**Ref**: forwards to \`${cmp.ref}\`\n`;
+    if (cmp.polymorphic)
+        out += `**Polymorphic**: yes (\`as\` / \`asChild\`)\n`;
+    if (cmp.serverSafe)
+        out += `**RSC-safe**: yes\n`;
+    if (cmp.deprecated) {
+        out += `**⚠ Deprecated**: since v${cmp.deprecated.since}; use \`${cmp.deprecated.replacedBy}\`; removal at v${cmp.deprecated.removeAt}\n`;
+    }
+    out += '\n';
+    if (include.has('description')) {
+        out += `## Description\n\n${cmp.description || '_No description in meta._'}\n\n`;
+    }
+    if (include.has('examples')) {
+        out += `## Examples\n\n`;
+        if (cmp.examples.length === 0) {
+            out += '_No examples in meta yet._\n\n';
+        }
+        else {
+            cmp.examples.forEach((ex, idx) => {
+                out += `### ${idx + 1}. ${ex.name}\n\n`;
+                out += '```tsx\n';
+                out += ex.code + '\n';
+                out += '```\n\n';
+            });
+        }
+    }
+    if (include.has('composes')) {
+        out += `## Composition\n\n${renderComposesSection(cmp.composes)}\n`;
+    }
+    if (include.has('props')) {
+        out += `## Props\n\n${renderPropsSection(cmp.props)}`;
+        out += renderHtmlAttrsFooter(cmp);
+        out += '\n';
+    }
+    if (include.has('appliesClassNames')) {
+        out += `## Theming Class Names\n\n${renderAppliesClassNames(cmp.appliesClassNames)}\n`;
+    }
+    return out;
+}
+//# sourceMappingURL=get-component-reference.js.map

package/build/tools/get-component-reference.js.map

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

package/build/tools/get-component.d.ts

@@ -0,0 +1,25 @@
+/**
+ * get_component Tool — meta-backed (v3.0.0; RN param stripped in v4.0.0).
+ *
+ * Generates a ready-to-use JSX snippet: import + component element with
+ * the supplied props/children. Prop keys and string values are validated
+ * against jsx-safety before interpolation (v2.7.1 #19). Component name +
+ * import package come from DS meta (v3.0.0 #47).
+ */
+import { z } from 'zod';
+export declare const getComponentSchema: z.ZodObject<{
+    componentName: z.ZodEnum<[string, ...string[]]>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../utils/jsx-safety.js").PropValue, z.ZodTypeDef, import("../utils/jsx-safety.js").PropValue>>>;
+    children: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    componentName: string;
+    props?: Record<string, import("../utils/jsx-safety.js").PropValue> | undefined;
+    children?: string | undefined;
+}, {
+    componentName: string;
+    props?: Record<string, import("../utils/jsx-safety.js").PropValue> | undefined;
+    children?: string | undefined;
+}>;
+export type GetComponentParams = z.infer<typeof getComponentSchema>;
+export declare function getComponent(params: GetComponentParams): Promise<string>;
+//# sourceMappingURL=get-component.d.ts.map

package/build/tools/get-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component.d.ts","sourceRoot":"","sources":["../../src/tools/get-component.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAcvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAsBnE,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9E"}

package/build/tools/get-component.js

@@ -0,0 +1,60 @@
+/**
+ * get_component Tool — meta-backed (v3.0.0; RN param stripped in v4.0.0).
+ *
+ * Generates a ready-to-use JSX snippet: import + component element with
+ * the supplied props/children. Prop keys and string values are validated
+ * against jsx-safety before interpolation (v2.7.1 #19). Component name +
+ * import package come from DS meta (v3.0.0 #47).
+ */
+import { z } from 'zod';
+import { getComponent as metaGetComponent, getComponentNames, getDsPackageName, } from '../utils/meta-loader.js';
+import { assertSafeJsxAttrString, assertSafeJsxPropKey, propsRecordSchema, } from '../utils/jsx-safety.js';
+const componentNames = getComponentNames();
+export const getComponentSchema = z.object({
+    componentName: z.enum(componentNames).describe('PascalCase name of the component to generate (e.g. "Button", "DatePicker").'),
+    props: propsRecordSchema.optional().describe('Component props as key-value pairs (string|number|boolean primitives, optionally nested in objects/arrays).'),
+    children: z.string().max(8_000).optional().describe('Children content for the component (JSX or text).'),
+});
+function buildPropsString(props) {
+    return Object.entries(props)
+        .map(([key, value]) => {
+        assertSafeJsxPropKey(key);
+        if (typeof value === 'string') {
+            assertSafeJsxAttrString(value, key);
+            return `${key}="${value}"`;
+        }
+        else if (typeof value === 'boolean') {
+            return value ? key : '';
+        }
+        else if (typeof value === 'number') {
+            return `${key}={${value}}`;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            return `${key}={${JSON.stringify(value)}}`;
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join(' ');
+}
+export async function getComponent(params) {
+    const { componentName, props = {}, children } = params;
+    const cmp = metaGetComponent(componentName);
+    if (!cmp) {
+        return `Error: \`${componentName}\` is not registered in DS meta.`;
+    }
+    const propsString = buildPropsString(props);
+    const propsWithSpace = propsString ? ` ${propsString}` : '';
+    const importStatement = `import { ${componentName} } from '${getDsPackageName()}'`;
+    // Deprecation warning header (surfaces meta.deprecated so agents don't
+    // silently emit deprecated components).
+    const deprecationHeader = cmp.deprecated
+        ? `// ⚠ ${componentName} is deprecated since v${cmp.deprecated.since}; use ${cmp.deprecated.replacedBy} (removal at v${cmp.deprecated.removeAt}).\n`
+        : '';
+    const hasChildren = children && children.trim().length > 0;
+    const snippet = hasChildren
+        ? `${importStatement}\n\n<${componentName}${propsWithSpace}>\n  ${children}\n</${componentName}>`
+        : `${importStatement}\n\n<${componentName}${propsWithSpace} />`;
+    return `${deprecationHeader}${snippet}`;
+}
+//# sourceMappingURL=get-component.js.map

package/build/tools/get-component.js.map

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

package/build/tools/get-composition-hints.d.ts

@@ -0,0 +1,22 @@
+/**
+ * get_composition_hints Tool (new in v3.0.0).
+ *
+ * Returns the DS's authoritative composition hints for a component —
+ * `meta.verbose.components[X].composes` — which prop of X naturally
+ * accepts which other component as its value. Populated for the obvious
+ * cases (Button.leftIcon → Icon, Card → CardHeader/Body/Footer, etc.).
+ *
+ * Agents use this to know what other components officially pair with the
+ * one they're rendering, without having to grep through examples.
+ */
+import { z } from 'zod';
+export declare const getCompositionHintsSchema: z.ZodObject<{
+    componentName: z.ZodEnum<[string, ...string[]]>;
+}, "strip", z.ZodTypeAny, {
+    componentName: string;
+}, {
+    componentName: string;
+}>;
+export type GetCompositionHintsParams = z.infer<typeof getCompositionHintsSchema>;
+export declare function getCompositionHints(params: GetCompositionHintsParams): Promise<string>;
+//# sourceMappingURL=get-composition-hints.d.ts.map

package/build/tools/get-composition-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-composition-hints.d.ts","sourceRoot":"","sources":["../../src/tools/get-composition-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,yBAAyB;;;;;;EAIpC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5F"}

package/build/tools/get-composition-hints.js

@@ -0,0 +1,39 @@
+/**
+ * get_composition_hints Tool (new in v3.0.0).
+ *
+ * Returns the DS's authoritative composition hints for a component —
+ * `meta.verbose.components[X].composes` — which prop of X naturally
+ * accepts which other component as its value. Populated for the obvious
+ * cases (Button.leftIcon → Icon, Card → CardHeader/Body/Footer, etc.).
+ *
+ * Agents use this to know what other components officially pair with the
+ * one they're rendering, without having to grep through examples.
+ */
+import { z } from 'zod';
+import { getVerboseComponent, getComponentNames } from '../utils/meta-loader.js';
+const componentNames = getComponentNames();
+export const getCompositionHintsSchema = z.object({
+    componentName: z
+        .enum(componentNames)
+        .describe('PascalCase name of the component (e.g. "Button", "Card") to fetch composition hints for.'),
+});
+export async function getCompositionHints(params) {
+    const { componentName } = params;
+    const cmp = getVerboseComponent(componentName);
+    if (!cmp) {
+        return `Error: \`${componentName}\` is not registered in DS meta.`;
+    }
+    let out = `# Composition Hints: ${componentName}\n\n`;
+    if (!cmp.composes || Object.keys(cmp.composes).length === 0) {
+        out += '_No formal composition hints in DS meta for this component. This does not necessarily mean nothing pairs with it — the DS only populates the obvious cases (e.g. `Button.leftIcon → Icon`)._\n';
+        return out;
+    }
+    out += 'These are the DS-authoritative composition hints — for each of the listed props, the DS expects the specified component (or shape) as the value.\n\n';
+    for (const [prop, hint] of Object.entries(cmp.composes)) {
+        out += `- **\`${prop}\`** accepts a \`${hint.accepts}\` (as \`${hint.as}\`)\n`;
+    }
+    out += '\n';
+    out += 'Use `get_component_reference` for the full component reference including these hints and examples.\n';
+    return out;
+}
+//# sourceMappingURL=get-composition-hints.js.map

package/build/tools/get-composition-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-composition-hints.js","sourceRoot":"","sources":["../../src/tools/get-composition-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhF,MAAM,cAAc,GAAG,iBAAiB,EAA2B,CAAA;AAEnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAiC;IACzE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;IAEhC,MAAM,GAAG,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAA;IAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,YAAY,aAAa,kCAAkC,CAAA;IACpE,CAAC;IAED,IAAI,GAAG,GAAG,wBAAwB,aAAa,MAAM,CAAA;IAErD,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,GAAG,IAAI,gMAAgM,CAAA;QACvM,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,GAAG,IAAI,sJAAsJ,CAAA;IAE7J,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,GAAG,IAAI,SAAS,IAAI,oBAAoB,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,EAAE,OAAO,CAAA;IAChF,CAAC;IAED,GAAG,IAAI,IAAI,CAAA;IACX,GAAG,IAAI,sGAAsG,CAAA;IAE7G,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/tools/get-design-tokens.d.ts

@@ -0,0 +1,24 @@
+/**
+ * get_design_tokens Tool — meta-backed (v3.0.0; RN branch stripped in v4.0.0).
+ *
+ * Returns DS tokens (colors, spacing, typography, radius, shadows, motion)
+ * from `meta.tokens`. Post-brand-neutralization: no baked brand framing —
+ * output describes what meta actually declares.
+ *
+ * Format parameter:
+ *   - 'css'  (default) — CSS variable references (`var(--color-*)`).
+ *                        Resolves to OKLCH values at runtime in the browser.
+ *   - 'hex'            — Raw hex strings from meta (source of truth in JS).
+ *   - 'both'           — Both forms per token for agents that need to pick.
+ */
+import { z } from 'zod';
+export declare const getDesignTokensSchema: z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<["css", "hex", "both"]>>;
+}, "strip", z.ZodTypeAny, {
+    format?: "css" | "hex" | "both" | undefined;
+}, {
+    format?: "css" | "hex" | "both" | undefined;
+}>;
+export type GetDesignTokensParams = z.infer<typeof getDesignTokensSchema>;
+export declare function getDesignTokens(params?: GetDesignTokensParams): Promise<string>;
+//# sourceMappingURL=get-design-tokens.d.ts.map

package/build/tools/get-design-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-design-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/get-design-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,qBAAqB;;;;;;EAOhC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AA+CzE,wBAAsB,eAAe,CAAC,MAAM,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCzF"}

package/build/tools/get-design-tokens.js

@@ -0,0 +1,96 @@
+/**
+ * get_design_tokens Tool — meta-backed (v3.0.0; RN branch stripped in v4.0.0).
+ *
+ * Returns DS tokens (colors, spacing, typography, radius, shadows, motion)
+ * from `meta.tokens`. Post-brand-neutralization: no baked brand framing —
+ * output describes what meta actually declares.
+ *
+ * Format parameter:
+ *   - 'css'  (default) — CSS variable references (`var(--color-*)`).
+ *                        Resolves to OKLCH values at runtime in the browser.
+ *   - 'hex'            — Raw hex strings from meta (source of truth in JS).
+ *   - 'both'           — Both forms per token for agents that need to pick.
+ */
+import { z } from 'zod';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const getDesignTokensSchema = z.object({
+    format: z
+        .enum(['css', 'hex', 'both'])
+        .optional()
+        .describe("Output format for color values (default 'css'). 'css' returns var(--color-*) references (resolve to OKLCH at runtime). 'hex' returns sRGB hex strings. 'both' returns both."),
+});
+/**
+ * Given a nested token value (which may be a scalar like "#123456" or an
+ * object of scalars keyed by shade), yield (path, value) entries.
+ * Path is joined with `-` and used both as the tail of the CSS var name
+ * and as the display key.
+ */
+function* walkTokens(node, path = []) {
+    if (node === null || node === undefined)
+        return;
+    if (typeof node === 'string' || typeof node === 'number') {
+        yield { path, value: String(node) };
+        return;
+    }
+    if (typeof node === 'object' && !Array.isArray(node)) {
+        for (const [k, v] of Object.entries(node)) {
+            yield* walkTokens(v, [...path, k]);
+        }
+        return;
+    }
+    if (Array.isArray(node)) {
+        yield { path, value: JSON.stringify(node) };
+    }
+}
+function formatValue(value, format, cssVar) {
+    if (format === 'css')
+        return `var(${cssVar})`;
+    if (format === 'hex')
+        return value;
+    return `var(${cssVar}) — ${value}`;
+}
+function renderCategory(title, root, cssPrefix, format) {
+    if (!root || Object.keys(root).length === 0)
+        return '';
+    let out = `## ${title}\n\n`;
+    for (const { path, value } of walkTokens(root)) {
+        const key = path.join('-');
+        const cssVar = `--${cssPrefix}${key}`;
+        out += `- \`${key}\`: ${formatValue(value, format, cssVar)}\n`;
+    }
+    return out + '\n';
+}
+export async function getDesignTokens(params = {}) {
+    const format = params.format ?? 'css';
+    const meta = getLightMeta();
+    const t = meta.tokens;
+    let response = `# Design Tokens (${meta.package.name}@${meta.package.version})\n\n`;
+    response += `Format: \`${format}\`. `;
+    if (format === 'css') {
+        response += 'CSS variable references resolve to OKLCH values at runtime in supporting browsers.\n\n';
+    }
+    else if (format === 'hex') {
+        response += 'sRGB hex strings (source of truth in JS). CSS runtime form is OKLCH; see `format: "css"` for those references.\n\n';
+    }
+    else {
+        response += 'Both CSS variable references and hex source values.\n\n';
+    }
+    response += renderCategory('Colors — semantic', t.colors.semantic, 'color-', format);
+    response += renderCategory('Colors — brand', t.colors.brand, 'color-', format);
+    response += renderCategory('Spacing', t.spacing, 'spacing-', format);
+    response += renderCategory('Typography', t.typography, 'font-', format);
+    response += renderCategory('Radius', t.radius, 'radius-', format);
+    response += renderCategory('Shadows', t.shadows, 'shadow-', format);
+    response += renderCategory('Motion', t.motion, '', format);
+    response += '## Usage\n\n';
+    response += '```css\n';
+    response += '.my-component {\n';
+    response += '  color: var(--color-primary);\n';
+    response += '  padding: var(--spacing-md);\n';
+    response += '  border-radius: var(--radius-lg);\n';
+    response += '  box-shadow: var(--shadow-md);\n';
+    response += '}\n';
+    response += '```\n';
+    return response;
+}
+//# sourceMappingURL=get-design-tokens.js.map

package/build/tools/get-design-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-design-tokens.js","sourceRoot":"","sources":["../../src/tools/get-design-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CACP,6KAA6K,CAC9K;CACJ,CAAC,CAAA;AAIF;;;;;GAKG;AACH,QAAQ,CAAC,CAAC,UAAU,CAAC,IAAa,EAAE,OAAiB,EAAE;IACrD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAM;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;QACnC,OAAM;IACR,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YACrE,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACpC,CAAC;QACD,OAAM;IACR,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAA;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,MAA8B,EAAE,MAAc;IAChF,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,OAAO,MAAM,GAAG,CAAA;IAC7C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IAClC,OAAO,OAAO,MAAM,OAAO,KAAK,EAAE,CAAA;AACpC,CAAC;AAED,SAAS,cAAc,CACrB,KAAa,EACb,IAAyC,EACzC,SAAiB,EACjB,MAA8B;IAE9B,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACtD,IAAI,GAAG,GAAG,MAAM,KAAK,MAAM,CAAA;IAC3B,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,KAAK,SAAS,GAAG,GAAG,EAAE,CAAA;QACrC,GAAG,IAAI,OAAO,GAAG,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAA;IAChE,CAAC;IACD,OAAO,GAAG,GAAG,IAAI,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAgC,EAAE;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,CAAA;IACrC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;IAErB,IAAI,QAAQ,GAAG,oBAAoB,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,OAAO,CAAA;IACnF,QAAQ,IAAI,aAAa,MAAM,MAAM,CAAA;IACrC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,QAAQ,IAAI,wFAAwF,CAAA;IACtG,CAAC;SAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC5B,QAAQ,IAAI,oHAAoH,CAAA;IAClI,CAAC;SAAM,CAAC;QACN,QAAQ,IAAI,yDAAyD,CAAA;IACvE,CAAC;IAED,QAAQ,IAAI,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAmC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC/G,QAAQ,IAAI,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,KAAgC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACzG,QAAQ,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,OAAkC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;IAC/F,QAAQ,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,UAAqC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IAClG,QAAQ,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAiC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;IAC5F,QAAQ,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,OAAkC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;IAC9F,QAAQ,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAiC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAErF,QAAQ,IAAI,cAAc,CAAA;IAC1B,QAAQ,IAAI,UAAU,CAAA;IACtB,QAAQ,IAAI,mBAAmB,CAAA;IAC/B,QAAQ,IAAI,kCAAkC,CAAA;IAC9C,QAAQ,IAAI,iCAAiC,CAAA;IAC7C,QAAQ,IAAI,sCAAsC,CAAA;IAClD,QAAQ,IAAI,mCAAmC,CAAA;IAC/C,QAAQ,IAAI,KAAK,CAAA;IACjB,QAAQ,IAAI,OAAO,CAAA;IAEnB,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/build/tools/get-ds-metadata.d.ts

@@ -0,0 +1,16 @@
+/**
+ * get_ds_metadata Tool (new in v3.0.0).
+ *
+ * One-call "what am I talking to." Returns the DS package identity, the
+ * meta schema version, capability totals, exports map, and icon totals so
+ * an agent (or a CI guard) can self-orient without having to make
+ * multiple introspection calls.
+ *
+ * Enables issue #11's version/component-count sync guard trivially —
+ * `meta.package.version` is canonical.
+ */
+import { z } from 'zod';
+export declare const getDsMetadataSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetDsMetadataParams = z.infer<typeof getDsMetadataSchema>;
+export declare function getDsMetadata(_params?: GetDsMetadataParams): Promise<string>;
+//# sourceMappingURL=get-ds-metadata.d.ts.map

package/build/tools/get-ds-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ds-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/get-ds-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,mBAAmB,gDAAe,CAAA;AAE/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,wBAAsB,aAAa,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDtF"}

package/build/tools/get-ds-metadata.js

@@ -0,0 +1,65 @@
+/**
+ * get_ds_metadata Tool (new in v3.0.0).
+ *
+ * One-call "what am I talking to." Returns the DS package identity, the
+ * meta schema version, capability totals, exports map, and icon totals so
+ * an agent (or a CI guard) can self-orient without having to make
+ * multiple introspection calls.
+ *
+ * Enables issue #11's version/component-count sync guard trivially —
+ * `meta.package.version` is canonical.
+ */
+import { z } from 'zod';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const getDsMetadataSchema = z.object({});
+export async function getDsMetadata(_params = {}) {
+    const meta = getLightMeta();
+    const totalComponents = Object.keys(meta.components).length;
+    const totalDeprecated = Object.values(meta.components).filter((c) => c.deprecated !== null).length;
+    const categories = new Set(Object.values(meta.components).map((c) => c.category));
+    let out = '# DS Metadata\n\n';
+    out += `- **Package**: \`${meta.package.name}\`\n`;
+    out += `- **Version**: v${meta.package.version}\n`;
+    out += `- **Homepage**: ${meta.package.homepage}\n`;
+    out += `- **Meta schema**: v${meta.$schemaVersion}\n\n`;
+    out += `## Component totals\n\n`;
+    out += `- **Total components**: ${totalComponents}\n`;
+    out += `- **Categories**: ${categories.size} (${[...categories].sort().join(', ')})\n`;
+    out += `- **Deprecated**: ${totalDeprecated}\n\n`;
+    out += `## Capability totals\n\n`;
+    out += `- **RSC-safe**: ${meta.capabilities.rscSafe.length}\n`;
+    out += `- **Client-only**: ${meta.capabilities.clientOnly.length}\n`;
+    out += `- **Polymorphic** (\`as\` / \`asChild\`): ${meta.capabilities.polymorphic.length}\n`;
+    out += `- **With forwarded ref**: ${meta.capabilities.withRef.length}\n\n`;
+    out += `## Icon totals\n\n`;
+    out += `- **DS brand registry**: ${meta.icons.totalCount}\n\n`;
+    // Hooks — added to meta in schema 1.3 (DS#504). Absent on older meta.
+    const hooks = meta.hooks;
+    if (hooks && Object.keys(hooks).length > 0) {
+        const hookNames = Object.keys(hooks);
+        const byCategory = new Map();
+        for (const name of hookNames) {
+            const cat = hooks[name].category;
+            byCategory.set(cat, (byCategory.get(cat) ?? 0) + 1);
+        }
+        const catBreakdown = [...byCategory.entries()]
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([c, n]) => `${c} (${n})`)
+            .join(', ');
+        out += `## Hook totals\n\n`;
+        out += `- **Total hooks**: ${hookNames.length}\n`;
+        out += `- **By category**: ${catBreakdown}\n`;
+        out += `- Use \`list_hooks\` / \`get_hook\` to introspect.\n\n`;
+    }
+    out += `## Exports\n\n`;
+    out += `- **Main**: \`${meta.exports.main}\`\n`;
+    out += `- **Subpaths** (${meta.exports.subpaths.length}):\n`;
+    for (const s of meta.exports.subpaths.slice(0, 30)) {
+        out += `  - \`${s}\`\n`;
+    }
+    if (meta.exports.subpaths.length > 30) {
+        out += `  - _…and ${meta.exports.subpaths.length - 30} more_\n`;
+    }
+    return out;
+}
+//# sourceMappingURL=get-ds-metadata.js.map

package/build/tools/get-ds-metadata.js.map

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

package/build/tools/get-hook.d.ts

@@ -0,0 +1,19 @@
+/**
+ * get_hook Tool — meta-backed (v3.3.0).
+ *
+ * Full detail for a single DS utility hook — signature, returns, category,
+ * RSC safety, subpath, description, and an import snippet. Mirrors the
+ * `get_component` shape for the hooks side of the DS meta (schema 1.3,
+ * DS#504).
+ */
+import { z } from 'zod';
+export declare const getHookSchema: z.ZodObject<{
+    hookName: z.ZodEnum<[string, ...string[]]>;
+}, "strip", z.ZodTypeAny, {
+    hookName: string;
+}, {
+    hookName: string;
+}>;
+export type GetHookParams = z.infer<typeof getHookSchema>;
+export declare function getHook_tool(params: GetHookParams): Promise<string>;
+//# sourceMappingURL=get-hook.d.ts.map

package/build/tools/get-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-hook.d.ts","sourceRoot":"","sources":["../../src/tools/get-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,aAAa;;;;;;EAIxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BzE"}