@lando-labs/lando-ds-mcp 4.0.0

package/build/tools/get-hook.js

@@ -0,0 +1,46 @@
+/**
+ * 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';
+import { getHook, getHookNames } from '../utils/meta-loader.js';
+// Dynamic hook enum — derived from meta at module load. If meta pre-dates
+// schema 1.3 (no hooks), fall back to a placeholder so the Zod enum still
+// constructs; the runtime call will surface a clean "hooks unavailable" error.
+const _hookNames = getHookNames();
+const hookNameEnum = (_hookNames.length > 0 ? _hookNames : ['__none__']);
+export const getHookSchema = z.object({
+    hookName: z
+        .enum(hookNameEnum)
+        .describe('Name of the hook to fetch (e.g. "useDisclosure", "useDebouncedValue").'),
+});
+export async function getHook_tool(params) {
+    const { hookName } = params;
+    const h = getHook(hookName);
+    if (!h) {
+        if (_hookNames.length === 0) {
+            return `Error: no hooks in loaded DS meta. The DS emits hooks starting with meta schema 1.3 (DS v0.56.0+).`;
+        }
+        return `Error: \`${hookName}\` is not registered in DS meta.`;
+    }
+    const rscTag = h.serverSafe ? 'rsc-safe' : 'client-only';
+    const importStatement = `import { ${hookName} } from '${h.subpath}'`;
+    let out = `# ${hookName}\n\n`;
+    out += `- **Category**: ${h.category}\n`;
+    out += `- **Signature**: \`${h.signature}\`\n`;
+    out += `- **Returns**: \`${h.returns}\`\n`;
+    out += `- **RSC safety**: ${rscTag}${h.useClient ? ' (requires "use client" boundary)' : ''}\n`;
+    out += `- **Subpath**: \`${h.subpath}\`\n\n`;
+    out += '## Import\n\n';
+    out += '```tsx\n';
+    out += `${importStatement}\n`;
+    out += '```\n\n';
+    out += '## Description\n\n';
+    out += `${h.description.trim()}\n`;
+    return out;
+}
+//# sourceMappingURL=get-hook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-hook.js","sourceRoot":"","sources":["../../src/tools/get-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE/D,0EAA0E;AAC1E,0EAA0E;AAC1E,+EAA+E;AAC/E,MAAM,UAAU,GAAG,YAAY,EAAE,CAAA;AACjC,MAAM,YAAY,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAA0B,CAAA;AAEjG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,YAAY,CAAC;SAClB,QAAQ,CAAC,wEAAwE,CAAC;CACtF,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAqB;IACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IAE3B,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,oGAAoG,CAAA;QAC7G,CAAC;QACD,OAAO,YAAY,QAAQ,kCAAkC,CAAA;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAA;IACxD,MAAM,eAAe,GAAG,YAAY,QAAQ,YAAY,CAAC,CAAC,OAAO,GAAG,CAAA;IAEpE,IAAI,GAAG,GAAG,KAAK,QAAQ,MAAM,CAAA;IAC7B,GAAG,IAAI,mBAAmB,CAAC,CAAC,QAAQ,IAAI,CAAA;IACxC,GAAG,IAAI,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAA;IAC9C,GAAG,IAAI,oBAAoB,CAAC,CAAC,OAAO,MAAM,CAAA;IAC1C,GAAG,IAAI,qBAAqB,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;IAC/F,GAAG,IAAI,oBAAoB,CAAC,CAAC,OAAO,QAAQ,CAAA;IAE5C,GAAG,IAAI,eAAe,CAAA;IACtB,GAAG,IAAI,UAAU,CAAA;IACjB,GAAG,IAAI,GAAG,eAAe,IAAI,CAAA;IAC7B,GAAG,IAAI,SAAS,CAAA;IAEhB,GAAG,IAAI,oBAAoB,CAAA;IAC3B,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAA;IAElC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/tools/get-theme-presets.d.ts

@@ -0,0 +1,13 @@
+/**
+ * get_theme_presets Tool — meta-backed since v3.1.1.
+ *
+ * Reads DS theme presets directly from `meta.themePresets` (schema 1.1+,
+ * DS#437). Falls back to a minimal informational message when the loaded
+ * meta predates schema 1.1 — that path is defensive only; the shipped MCP
+ * always bundles current meta.
+ */
+import { z } from 'zod';
+export declare const getThemePresetsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetThemePresetsParams = z.infer<typeof getThemePresetsSchema>;
+export declare function getThemePresets(_params?: GetThemePresetsParams): Promise<string>;
+//# sourceMappingURL=get-theme-presets.d.ts.map

package/build/tools/get-theme-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-theme-presets.d.ts","sourceRoot":"","sources":["../../src/tools/get-theme-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,qBAAqB,gDAAe,CAAA;AAEjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,wBAAsB,eAAe,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC1F"}

package/build/tools/get-theme-presets.js

@@ -0,0 +1,41 @@
+/**
+ * get_theme_presets Tool — meta-backed since v3.1.1.
+ *
+ * Reads DS theme presets directly from `meta.themePresets` (schema 1.1+,
+ * DS#437). Falls back to a minimal informational message when the loaded
+ * meta predates schema 1.1 — that path is defensive only; the shipped MCP
+ * always bundles current meta.
+ */
+import { z } from 'zod';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const getThemePresetsSchema = z.object({});
+export async function getThemePresets(_params = {}) {
+    const meta = getLightMeta();
+    let out = `# Theme Presets (${meta.package.name}@${meta.package.version})\n\n`;
+    out += 'The DS ships opt-in theme presets rather than baking a brand identity as the default. Pick one when generating themed code, or apply your own ramps against the neutral base.\n\n';
+    if (!meta.themePresets || Object.keys(meta.themePresets.presets).length === 0) {
+        out += '_This meta snapshot predates the `themePresets` block (schema 1.1). Refresh the MCP by running `npm run copy:ds-meta && npm run build && npm pack && npm install -g <tgz>` to pick up the current preset list._\n';
+        return out;
+    }
+    const { default: defaultId, presets } = meta.themePresets;
+    const ids = Object.keys(presets).sort((a, b) => {
+        // Default preset first, then alphabetical
+        if (a === defaultId)
+            return -1;
+        if (b === defaultId)
+            return 1;
+        return a.localeCompare(b);
+    });
+    out += `**Default preset**: \`${defaultId}\`\n\n`;
+    for (const id of ids) {
+        const p = presets[id];
+        const badge = p.isDefault ? ' _(default)_' : '';
+        out += `## \`${p.id}\`${badge}\n\n`;
+        if (p.description)
+            out += `${p.description}\n\n`;
+    }
+    out += '## Applying a preset\n\n';
+    out += 'Preset selection is handled by the DS `themePresets` module; consumers import the preset they want and set it via the theme provider (see the DS README for the current API).\n';
+    return out;
+}
+//# sourceMappingURL=get-theme-presets.js.map

package/build/tools/get-theme-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-theme-presets.js","sourceRoot":"","sources":["../../src/tools/get-theme-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,EAAE,CAAC,CAAA;AAIjD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAiC,EAAE;IACvE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAE3B,IAAI,GAAG,GAAG,oBAAoB,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,OAAO,CAAA;IAC9E,GAAG,IAAI,mLAAmL,CAAA;IAE1L,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,GAAG,IAAI,mNAAmN,CAAA;QAC1N,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,CAAA;IACzD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,0CAA0C;QAC1C,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAA;QAC7B,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,GAAG,IAAI,yBAAyB,SAAS,QAAQ,CAAA;IAEjD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAA;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/C,GAAG,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK,KAAK,MAAM,CAAA;QACnC,IAAI,CAAC,CAAC,WAAW;YAAE,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,MAAM,CAAA;IAClD,CAAC;IAED,GAAG,IAAI,0BAA0B,CAAA;IACjC,GAAG,IAAI,iLAAiL,CAAA;IAExL,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/tools/list-components.d.ts

@@ -0,0 +1,29 @@
+/**
+ * list_components Tool — meta-backed (v3.0.0; RN param stripped in v4.0.0).
+ *
+ * Enumerates DS components with optional filters against meta.
+ * Filters are additive — omitting all returns everything.
+ */
+import { z } from 'zod';
+export declare const listComponentsSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    deprecated: z.ZodOptional<z.ZodBoolean>;
+    serverSafe: z.ZodOptional<z.ZodBoolean>;
+    polymorphic: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodOptional<z.ZodEnum<["component"]>>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+    deprecated?: boolean | undefined;
+    serverSafe?: boolean | undefined;
+    polymorphic?: boolean | undefined;
+    kind?: "component" | undefined;
+}, {
+    category?: string | undefined;
+    deprecated?: boolean | undefined;
+    serverSafe?: boolean | undefined;
+    polymorphic?: boolean | undefined;
+    kind?: "component" | undefined;
+}>;
+export type ListComponentsParams = z.infer<typeof listComponentsSchema>;
+export declare function listComponents(params?: ListComponentsParams): Promise<string>;
+//# sourceMappingURL=list-components.d.ts.map

package/build/tools/list-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.d.ts","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,wBAAsB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEvF"}

package/build/tools/list-components.js

@@ -0,0 +1,88 @@
+/**
+ * list_components Tool — meta-backed (v3.0.0; RN param stripped in v4.0.0).
+ *
+ * Enumerates DS components with optional filters against meta.
+ * Filters are additive — omitting all returns everything.
+ */
+import { z } from 'zod';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const listComponentsSchema = z.object({
+    category: z.string().max(100).optional().describe('Filter by category (e.g. "Core & Form"). Matches meta.components[X].category exactly.'),
+    deprecated: z.boolean().optional().describe('If true, include ONLY deprecated components. If false, exclude deprecated. Omit to include both.'),
+    serverSafe: z.boolean().optional().describe('If true, only components with no "use client" directive (safe in React Server Components).'),
+    polymorphic: z.boolean().optional().describe('If true, only components that accept an `as` / `asChild` prop.'),
+    kind: z.enum(['component']).optional().describe('Filter by kind. Currently only "component"; reserved for future non-component entries.'),
+});
+export async function listComponents(params = {}) {
+    const meta = getLightMeta();
+    const { category, deprecated, serverSafe, polymorphic, kind } = params;
+    const entries = Object.entries(meta.components).filter(([, cmp]) => {
+        if (category && cmp.category !== category)
+            return false;
+        if (deprecated === true && cmp.deprecated === null)
+            return false;
+        if (deprecated === false && cmp.deprecated !== null)
+            return false;
+        if (serverSafe !== undefined && cmp.serverSafe !== serverSafe)
+            return false;
+        if (polymorphic !== undefined && cmp.polymorphic !== polymorphic)
+            return false;
+        if (kind && cmp.kind !== kind)
+            return false;
+        return true;
+    });
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    const byCategory = new Map();
+    for (const [name, cmp] of entries) {
+        const bucket = byCategory.get(cmp.category) ?? [];
+        bucket.push(name);
+        byCategory.set(cmp.category, bucket);
+    }
+    const filterSummary = [];
+    if (category)
+        filterSummary.push(`category="${category}"`);
+    if (deprecated !== undefined)
+        filterSummary.push(`deprecated=${deprecated}`);
+    if (serverSafe !== undefined)
+        filterSummary.push(`serverSafe=${serverSafe}`);
+    if (polymorphic !== undefined)
+        filterSummary.push(`polymorphic=${polymorphic}`);
+    if (kind)
+        filterSummary.push(`kind="${kind}"`);
+    let response = '# Available Components\n\n';
+    response += `Total: ${entries.length} of ${Object.keys(meta.components).length} components`;
+    if (filterSummary.length > 0) {
+        response += ` (filtered: ${filterSummary.join(', ')})`;
+    }
+    response += `\nDS: ${meta.package.name}@${meta.package.version}\n\n`;
+    if (entries.length === 0) {
+        response += '_No components match these filters._\n';
+        return response;
+    }
+    const categoriesSorted = [...byCategory.keys()].sort();
+    for (const cat of categoriesSorted) {
+        const names = byCategory.get(cat).sort();
+        response += `## ${cat}\n\n`;
+        for (const name of names) {
+            const cmp = meta.components[name];
+            const flags = [];
+            if (cmp.deprecated)
+                flags.push(`deprecated since ${cmp.deprecated.since}`);
+            if (cmp.polymorphic)
+                flags.push('polymorphic');
+            if (cmp.serverSafe)
+                flags.push('rsc-safe');
+            const flagStr = flags.length > 0 ? ` _(${flags.join('; ')})_` : '';
+            response += `- **${name}**${flagStr}\n`;
+        }
+        response += '\n';
+    }
+    response += '## Usage\n\n';
+    response += '- `get_component` — generate JSX for a component\n';
+    response += '- `get_component_props` — props schema for a component\n';
+    response += '- `get_component_reference` — description + examples + composes + props in one call\n';
+    response += '- `get_composition_hints` — which components officially pair with this one\n';
+    response += '- `get_component_capabilities` — rsc-safety, polymorphism, ref-forwarding\n';
+    return response;
+}
+//# sourceMappingURL=list-components.js.map

package/build/tools/list-components.js.map

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

package/build/tools/list-hooks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * list_hooks Tool — meta-backed (v3.3.0).
+ *
+ * Enumerates DS utility hooks with optional filters against meta.hooks
+ * (schema 1.3, DS#504). Filters are additive — omitting all returns
+ * everything. Groups by category for scan-ability (matches list_components
+ * shape).
+ */
+import { z } from 'zod';
+export declare const listHooksSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    serverSafe: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+    serverSafe?: boolean | undefined;
+}, {
+    category?: string | undefined;
+    serverSafe?: boolean | undefined;
+}>;
+export type ListHooksParams = z.infer<typeof listHooksSchema>;
+export declare function listHooks(params?: ListHooksParams): Promise<string>;
+//# sourceMappingURL=list-hooks.d.ts.map

package/build/tools/list-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-hooks.d.ts","sourceRoot":"","sources":["../../src/tools/list-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe;;;;;;;;;EAc1B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,wBAAsB,SAAS,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+D7E"}

package/build/tools/list-hooks.js

@@ -0,0 +1,80 @@
+/**
+ * list_hooks Tool — meta-backed (v3.3.0).
+ *
+ * Enumerates DS utility hooks with optional filters against meta.hooks
+ * (schema 1.3, DS#504). Filters are additive — omitting all returns
+ * everything. Groups by category for scan-ability (matches list_components
+ * shape).
+ */
+import { z } from 'zod';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const listHooksSchema = z.object({
+    category: z
+        .string()
+        .max(100)
+        .optional()
+        .describe('Filter by category (e.g. "state", "dom", "browser", "a11y"). Matches meta.hooks[X].category exactly.'),
+    serverSafe: z
+        .boolean()
+        .optional()
+        .describe('If true, only hooks safe in React Server Components (no "use client" required).'),
+});
+export async function listHooks(params = {}) {
+    const meta = getLightMeta();
+    const hooks = meta.hooks ?? {};
+    const { category, serverSafe } = params;
+    const entries = Object.entries(hooks).filter(([, h]) => {
+        if (category && h.category !== category)
+            return false;
+        if (serverSafe !== undefined && h.serverSafe !== serverSafe)
+            return false;
+        return true;
+    });
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    const byCategory = new Map();
+    for (const [name, h] of entries) {
+        const bucket = byCategory.get(h.category) ?? [];
+        bucket.push(name);
+        byCategory.set(h.category, bucket);
+    }
+    const filterSummary = [];
+    if (category)
+        filterSummary.push(`category="${category}"`);
+    if (serverSafe !== undefined)
+        filterSummary.push(`serverSafe=${serverSafe}`);
+    const totalHooks = Object.keys(hooks).length;
+    let response = '# Available Hooks\n\n';
+    response += `Total: ${entries.length} of ${totalHooks} hooks`;
+    if (filterSummary.length > 0) {
+        response += ` (filtered: ${filterSummary.join(', ')})`;
+    }
+    response += `\nDS: ${meta.package.name}@${meta.package.version}\n\n`;
+    if (totalHooks === 0) {
+        response += '_No hooks in loaded meta._ ';
+        response += `The DS emits hooks starting with meta schema 1.3 (DS v0.56.0+); current schema is v${meta.$schemaVersion}.\n`;
+        return response;
+    }
+    if (entries.length === 0) {
+        response += '_No hooks match these filters._\n';
+        return response;
+    }
+    const categoriesSorted = [...byCategory.keys()].sort();
+    for (const cat of categoriesSorted) {
+        const names = byCategory.get(cat).sort();
+        response += `## ${cat}\n\n`;
+        for (const name of names) {
+            const h = hooks[name];
+            const flags = [];
+            if (h.serverSafe)
+                flags.push('rsc-safe');
+            const flagStr = flags.length > 0 ? ` _(${flags.join('; ')})_` : '';
+            response += `- **${name}**${flagStr} — \`${h.signature}\`\n`;
+        }
+        response += '\n';
+    }
+    response += '## Usage\n\n';
+    response += `- All hooks import from \`${Object.values(hooks)[0]?.subpath ?? '@lando-labs/lando-ds/hooks'}\`\n`;
+    response += '- `get_hook` — full detail for a single hook (signature, returns, description, RSC safety)\n';
+    return response;
+}
+//# sourceMappingURL=list-hooks.js.map

package/build/tools/list-hooks.js.map

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

package/build/tools/list-icons.d.ts

@@ -0,0 +1,28 @@
+/**
+ * list_icons Tool — meta-backed sources (v3.0.0).
+ *
+ * Two icon sources:
+ *   - 'ds-brand'       — DS-authoritative brand icons (meta.icons.registry, ~70)
+ *   - 'lucide-curated' — MCP's curated Lucide subset (icon-metadata.ts, ~120)
+ *   - 'all'            — union of both, deduped by name
+ */
+import { z } from 'zod';
+export declare const listIconsSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["ds-brand", "lucide-curated", "all"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+    query?: string | undefined;
+    source?: "all" | "ds-brand" | "lucide-curated" | undefined;
+    limit?: number | undefined;
+}, {
+    category?: string | undefined;
+    query?: string | undefined;
+    source?: "all" | "ds-brand" | "lucide-curated" | undefined;
+    limit?: number | undefined;
+}>;
+export type ListIconsParams = z.infer<typeof listIconsSchema>;
+export declare function listIcons(params: ListIconsParams): Promise<string>;
+//# sourceMappingURL=list-icons.d.ts.map

package/build/tools/list-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-icons.d.ts","sourceRoot":"","sources":["../../src/tools/list-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAkB1B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AA2D7D,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBxE"}

package/build/tools/list-icons.js

@@ -0,0 +1,161 @@
+/**
+ * list_icons Tool — meta-backed sources (v3.0.0).
+ *
+ * Two icon sources:
+ *   - 'ds-brand'       — DS-authoritative brand icons (meta.icons.registry, ~70)
+ *   - 'lucide-curated' — MCP's curated Lucide subset (icon-metadata.ts, ~120)
+ *   - 'all'            — union of both, deduped by name
+ */
+import { z } from 'zod';
+import { allIconMetadata, categoryDescriptions, } from '../data/icon-metadata.js';
+import { resolveLibraryInfo } from '../utils/icon-library.js';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const listIconsSchema = z.object({
+    query: z.string().max(8_000).optional().describe('Search query to filter icons by name, description, or tags.'),
+    category: z
+        .string()
+        .max(100)
+        .optional()
+        .describe('Filter by icon category. Values differ per source (ds-brand uses DS categories; lucide-curated uses MCP categories).'),
+    source: z
+        .enum(['ds-brand', 'lucide-curated', 'all'])
+        .optional()
+        .describe("Icon source (default 'all'). 'ds-brand' = DS's authoritative named icons from meta.icons.registry. 'lucide-curated' = MCP's curated Lucide subset."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum icons to return (default: 50, max: 200).'),
+});
+function dsBrandIcons() {
+    const registry = getLightMeta().icons.registry;
+    return Object.values(registry).map((entry) => ({
+        name: entry.name,
+        source: 'ds-brand',
+        category: entry.category,
+        description: `${entry.name} (DS brand icon, maps to Lucide \`${entry.lucideName}\`)`,
+        tags: [entry.name, entry.category, entry.lucideName],
+        lucideName: entry.lucideName,
+    }));
+}
+function lucideCuratedIcons() {
+    return allIconMetadata
+        .filter((i) => i.source === 'lucide')
+        .map((i) => ({
+        name: i.name,
+        source: 'lucide-curated',
+        category: i.category,
+        description: i.description,
+        tags: i.tags,
+        lucideName: i.name, // Lucide-curated names ARE the Lucide component name
+        commonUsage: i.commonUsage,
+        aliases: i.aliases,
+    }));
+}
+function collectIcons(source) {
+    if (source === 'ds-brand')
+        return dsBrandIcons();
+    if (source === 'lucide-curated')
+        return lucideCuratedIcons();
+    // 'all' — union, dedup by name (ds-brand takes precedence on collision)
+    const brand = dsBrandIcons();
+    const brandNames = new Set(brand.map((i) => i.name));
+    const curated = lucideCuratedIcons().filter((i) => !brandNames.has(i.name));
+    return [...brand, ...curated];
+}
+function matchesQuery(icon, lowerQuery) {
+    if (icon.name.toLowerCase().includes(lowerQuery))
+        return true;
+    if (icon.description.toLowerCase().includes(lowerQuery))
+        return true;
+    if (icon.tags.some((t) => t.toLowerCase().includes(lowerQuery)))
+        return true;
+    if (icon.aliases?.some((a) => a.toLowerCase().includes(lowerQuery)))
+        return true;
+    return false;
+}
+export async function listIcons(params) {
+    const { query, category, limit } = params;
+    const source = params.source ?? 'all';
+    const safeLimit = limit ?? 50;
+    let icons = collectIcons(source);
+    if (category)
+        icons = icons.filter((i) => i.category === category);
+    if (query) {
+        const q = query.toLowerCase();
+        icons = icons.filter((i) => matchesQuery(i, q));
+    }
+    const totalMatching = icons.length;
+    icons = icons.slice(0, safeLimit);
+    const libraryInfo = resolveLibraryInfo();
+    return renderResponse(icons, {
+        query,
+        category,
+        source,
+        limit: safeLimit,
+        totalMatching,
+        libraryInfo,
+    });
+}
+function renderResponse(icons, filters) {
+    const { libraryInfo } = filters;
+    let out = '# Available Icons\n\n';
+    const filterSummary = [];
+    if (filters.source !== 'all')
+        filterSummary.push(`source="${filters.source}"`);
+    if (filters.category)
+        filterSummary.push(`category="${filters.category}"`);
+    if (filters.query)
+        filterSummary.push(`query="${filters.query}"`);
+    out += `Total: ${filters.totalMatching} icons`;
+    if (filterSummary.length > 0)
+        out += ` (filtered: ${filterSummary.join(', ')})`;
+    out += `\n\n`;
+    if (icons.length < filters.totalMatching) {
+        out += `_Showing first ${icons.length} results (limit: ${filters.limit}). Raise \`limit\` to see more._\n\n`;
+    }
+    if (filters.category && categoryDescriptions[filters.category]) {
+        out += `**${filters.category}**: ${categoryDescriptions[filters.category]}\n\n`;
+    }
+    // Availability banner — the full Lucide library is always reachable.
+    out += '## Full Lucide Library Available\n\n';
+    out += `Any icon from the Lucide library (~${libraryInfo.totalIcons.toLocaleString()} icons) can be used via \`${libraryInfo.libraryName}\`.\n\n`;
+    out += `- **Browse all**: ${libraryInfo.browseUrl}\n\n`;
+    // Grouped output — brand first, then curated
+    const brand = icons.filter((i) => i.source === 'ds-brand');
+    const curated = icons.filter((i) => i.source === 'lucide-curated');
+    if (brand.length > 0) {
+        out += `## DS Brand Icons (${brand.length})\n\n`;
+        out += 'Authoritative brand icons from `meta.icons.registry`.\n\n';
+        for (const icon of brand)
+            out += renderIconEntry(icon, libraryInfo);
+    }
+    if (curated.length > 0) {
+        out += `## Lucide Curated (${curated.length})\n\n`;
+        out += 'MCP-curated Lucide subset — battle-tested with DS components.\n\n';
+        for (const icon of curated)
+            out += renderIconEntry(icon, libraryInfo);
+    }
+    out += '\n---\n';
+    out += 'Use `search_icons` for purpose-driven / semantic search.\n';
+    return out;
+}
+function renderIconEntry(icon, libraryInfo) {
+    let entry = `### ${icon.name}\n\n`;
+    entry += `- **Description**: ${icon.description}\n`;
+    if (icon.tags.length > 0)
+        entry += `- **Tags**: ${icon.tags.join(', ')}\n`;
+    if (icon.commonUsage)
+        entry += `- **Common usage**: ${icon.commonUsage}\n`;
+    if (icon.aliases && icon.aliases.length > 0)
+        entry += `- **Aliases**: ${icon.aliases.join(', ')}\n`;
+    const lucideName = icon.lucideName ?? icon.name;
+    entry += `\n**Usage**:\n\`\`\`tsx\n`;
+    entry += `import { ${lucideName} } from '${libraryInfo.libraryName}'\n\n`;
+    entry += `<Icon size="md"><${lucideName} /></Icon>\n`;
+    entry += `\`\`\`\n\n`;
+    return entry;
+}
+//# sourceMappingURL=list-icons.js.map

package/build/tools/list-icons.js.map

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

package/build/tools/platform-transform.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Platform-aware transformations for code-gen tools.
+ *
+ * Sprint 29, Lane G (#244): given a chunk of generated JSX + an import
+ * statement, produce the RN-flavored variant when `platform === 'react-native'`.
+ *
+ * Transformations applied for RN:
+ *   - Import path: `@lando-labs/design-system` → `@lando-labs/design-system-native`
+ *   - Event handlers:
+ *       onClick      → onPress
+ *       onChange     → onChangeText  (only when the target is an Input/Textarea)
+ *   - JSX tags:
+ *       <div>...</div>   → <View>...</View>
+ *       <span>...</span> → <Text>...</Text>
+ *   - Inline `style={{...}}` is left in place but annotated with a one-line
+ *     comment hint that `StyleSheet.create` is preferred.
+ *
+ * The helpers here are intentionally regex-based: the inputs are short
+ * generated snippets where a parser would be overkill. The transformations
+ * are conservative — anything ambiguous is left alone (and warned about).
+ */
+import type { Platform } from './platform.js';
+/**
+ * Swap the web package name for the RN package name inside any import
+ * statement that targets the web DS. Other imports (`react`, `next/link`,
+ * `lucide-react`, etc.) pass through unchanged.
+ *
+ * Safe to call on input that may not contain an import statement — it's a
+ * no-op in that case.
+ */
+export declare function rewriteImportPath(snippet: string, platform: Platform): string;
+/**
+ * Rewrite a JSX snippet for RN.
+ *
+ * Returns both the transformed code and any warnings the caller may want
+ * to surface (e.g. the inline-style hint, ambiguous onChange usage on
+ * non-text elements, etc.).
+ */
+export declare function rewriteJsxForRn(jsx: string, options?: {
+    componentName?: string;
+}): {
+    code: string;
+    warnings: string[];
+};
+/**
+ * Convenience wrapper: apply both import + JSX rewrites to a full snippet
+ * (import statement + JSX), keeping the existing two-section format
+ * (`<import>\n\n<jsx>`) produced by `get_component` / `get_usage_example`.
+ *
+ * Splits on the first blank line; if none is found, the entire input is
+ * treated as JSX (no import to rewrite).
+ */
+export declare function rewriteSnippetForPlatform(snippet: string, platform: Platform, options?: {
+    componentName?: string;
+}): {
+    code: string;
+    warnings: string[];
+};
+/**
+ * Format a list of warnings as a leading comment block. Returns an empty
+ * string if there are no warnings.
+ */
+export declare function formatWarningsHeader(warnings: string[]): string;
+//# sourceMappingURL=platform-transform.d.ts.map

package/build/tools/platform-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-transform.d.ts","sourceRoot":"","sources":["../../src/tools/platform-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAQ7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAQ7E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA0CtC;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAI/D"}