@lando-labs/lando-ds-mcp 4.0.0

package/build/utils/error-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-envelope.js","sourceRoot":"","sources":["../../src/utils/error-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAExE,IAAI,UAAU,GAAG,CAAC,CAAA;AAElB,sCAAsC;AACtC,MAAM,UAAU,gBAAgB;IAC9B,UAAU,GAAG,CAAC,CAAA;AAChB,CAAC;AAED,SAAS,WAAW;IAClB,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,SAAoD,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAErF,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAA;IAC/E,CAAC;IAED,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;IACxB,MAAM,CAAC,kBAAkB,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACtC,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAA;AAC3E,CAAC"}

package/build/utils/icon-library.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Icon library — surface info for the Lucide catalog.
+ *
+ * v4.0.0: RN support removed with the rest of the platform code; this
+ * module now returns a single fixed shape referencing `lucide-react` for
+ * the web. If the DS ever ships an RN sibling package again, add a
+ * variant here.
+ */
+export interface IconLibraryInfo {
+    libraryName: 'lucide-react';
+    /** Approximate icon count published by Lucide (canonical, deduped) */
+    totalIcons: number;
+    browseUrl: string;
+    importPattern: string;
+}
+export declare function resolveLibraryInfo(): IconLibraryInfo;
+//# sourceMappingURL=icon-library.d.ts.map

package/build/utils/icon-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-library.d.ts","sourceRoot":"","sources":["../../src/utils/icon-library.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,cAAc,CAAA;IAC3B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;CACtB;AAUD,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD"}

package/build/utils/icon-library.js

@@ -0,0 +1,24 @@
+/**
+ * Icon library — surface info for the Lucide catalog.
+ *
+ * v4.0.0: RN support removed with the rest of the platform code; this
+ * module now returns a single fixed shape referencing `lucide-react` for
+ * the web. If the DS ever ships an RN sibling package again, add a
+ * variant here.
+ */
+/**
+ * Verified against `lucide-react@0.548.0`: ~1,640 PascalCase icon exports.
+ * Rounded to 1,500 for agent-facing copy so we don't have to cut a new MCP
+ * release every time Lucide adds a handful of new glyphs.
+ */
+const TOTAL_ICONS = 1500;
+const LUCIDE_BROWSE_URL = 'https://lucide.dev/icons';
+export function resolveLibraryInfo() {
+    return {
+        libraryName: 'lucide-react',
+        totalIcons: TOTAL_ICONS,
+        browseUrl: LUCIDE_BROWSE_URL,
+        importPattern: "import { IconName } from 'lucide-react'",
+    };
+}
+//# sourceMappingURL=icon-library.js.map

package/build/utils/icon-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-library.js","sourceRoot":"","sources":["../../src/utils/icon-library.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,CAAA;AACxB,MAAM,iBAAiB,GAAG,0BAA0B,CAAA;AAEpD,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,WAAW,EAAE,cAAc;QAC3B,UAAU,EAAE,WAAW;QACvB,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,yCAAyC;KACzD,CAAA;AACH,CAAC"}

package/build/utils/jsx-safety.d.ts

@@ -0,0 +1,47 @@
+/**
+ * JSX prop safety helpers.
+ *
+ * Tool output is JSX SOURCE CODE consumed by downstream agents — it is
+ * never rendered by this server. That means a string prop value containing
+ * `"`, `<`, `>`, `{`, `}`, or `\` can break out of the attribute and inject
+ * arbitrary JSX into the consumer's tree. Smuggled `}` also previously
+ * broke the regex-based import-merge in compose-components (closes #19).
+ *
+ * Policy: reject, don't escape. Rejecting gives the AI caller an
+ * actionable error; escaping silently transforms intent.
+ */
+import { z } from 'zod';
+/**
+ * Throw an InvalidParams McpError if a string prop value contains any
+ * character that would break out of a JSX attribute.
+ */
+export declare function assertSafeJsxAttrString(value: string, propName: string): void;
+/**
+ * Throw an InvalidParams McpError if a prop name isn't a plausible JSX
+ * attribute identifier. Permissive enough for camelCase, kebab-case,
+ * data-*, and aria-*; strict enough to reject whitespace and JSX syntax.
+ */
+export declare function assertSafeJsxPropKey(key: string): void;
+/**
+ * Recursive schema for prop values: scalars only at the leaves, with
+ * nested objects/arrays of scalars allowed (so {style: {color: 'red'}}
+ * still works). Excludes functions, symbols, null, undefined, BigInt.
+ */
+export type PropValue = string | number | boolean | {
+    [key: string]: PropValue;
+} | PropValue[];
+export declare const propValueSchema: z.ZodType<PropValue>;
+/**
+ * Record schema for the `props` argument on get_component and
+ * compose_components. Replaces `z.record(z.any())`.
+ */
+export declare const propsRecordSchema: z.ZodRecord<z.ZodString, z.ZodType<PropValue, z.ZodTypeDef, PropValue>>;
+/**
+ * Reflect a user-supplied string back into markdown output safely.
+ * Strips/replaces characters that would let the value escape its
+ * surrounding context (backticks, angle brackets, template-literal
+ * markers, control chars). Truncates to keep echoes bounded even if
+ * the upstream Zod cap is removed.
+ */
+export declare function escapeForMarkdownEcho(value: string): string;
+//# sourceMappingURL=jsx-safety.d.ts.map

package/build/utils/jsx-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-safety.d.ts","sourceRoot":"","sources":["../../src/utils/jsx-safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOtD;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5B,SAAS,EAAE,CAAA;AAQf,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAEhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,yEAA4B,CAAA;AAE1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D"}

package/build/utils/jsx-safety.js

@@ -0,0 +1,63 @@
+/**
+ * JSX prop safety helpers.
+ *
+ * Tool output is JSX SOURCE CODE consumed by downstream agents — it is
+ * never rendered by this server. That means a string prop value containing
+ * `"`, `<`, `>`, `{`, `}`, or `\` can break out of the attribute and inject
+ * arbitrary JSX into the consumer's tree. Smuggled `}` also previously
+ * broke the regex-based import-merge in compose-components (closes #19).
+ *
+ * Policy: reject, don't escape. Rejecting gives the AI caller an
+ * actionable error; escaping silently transforms intent.
+ */
+import { z } from 'zod';
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+const DISALLOWED_JSX_ATTR_CHARS = /[<>"{}\\]/;
+/**
+ * Throw an InvalidParams McpError if a string prop value contains any
+ * character that would break out of a JSX attribute.
+ */
+export function assertSafeJsxAttrString(value, propName) {
+    if (DISALLOWED_JSX_ATTR_CHARS.test(value)) {
+        throw new McpError(ErrorCode.InvalidParams, `Prop "${propName}" contains a JSX-unsafe character (one of: < > " { } \\). ` +
+            `Pass complex content via "children" or compose the JSX yourself.`);
+    }
+}
+const JSX_PROP_KEY = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;
+/**
+ * Throw an InvalidParams McpError if a prop name isn't a plausible JSX
+ * attribute identifier. Permissive enough for camelCase, kebab-case,
+ * data-*, and aria-*; strict enough to reject whitespace and JSX syntax.
+ */
+export function assertSafeJsxPropKey(key) {
+    if (!JSX_PROP_KEY.test(key)) {
+        throw new McpError(ErrorCode.InvalidParams, `Prop name "${key}" is not a valid JSX attribute identifier.`);
+    }
+}
+const propPrimitiveSchema = z.union([
+    z.string().max(8_000),
+    z.boolean(),
+    z.number(),
+]);
+export const propValueSchema = z.lazy(() => z.union([propPrimitiveSchema, z.record(propValueSchema), z.array(propValueSchema)]));
+/**
+ * Record schema for the `props` argument on get_component and
+ * compose_components. Replaces `z.record(z.any())`.
+ */
+export const propsRecordSchema = z.record(propValueSchema);
+/**
+ * Reflect a user-supplied string back into markdown output safely.
+ * Strips/replaces characters that would let the value escape its
+ * surrounding context (backticks, angle brackets, template-literal
+ * markers, control chars). Truncates to keep echoes bounded even if
+ * the upstream Zod cap is removed.
+ */
+export function escapeForMarkdownEcho(value) {
+    return value
+        .slice(0, 200)
+        .replace(/[\r\n\t]+/g, ' ')
+        // eslint-disable-next-line no-control-regex
+        .replace(/[\x00-\x1f\x7f]/g, '')
+        .replace(/[`<>]/g, '?');
+}
+//# sourceMappingURL=jsx-safety.js.map

package/build/utils/jsx-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-safety.js","sourceRoot":"","sources":["../../src/utils/jsx-safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAExE,MAAM,yBAAyB,GAAG,WAAW,CAAA;AAE7C;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,QAAgB;IACrE,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,SAAS,QAAQ,4DAA4D;YAC3E,kEAAkE,CACrE,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAAG,2BAA2B,CAAA;AAEhD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,cAAc,GAAG,4CAA4C,CAC9D,CAAA;IACH,CAAC;AACH,CAAC;AAcD,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC;IAClC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;IACrB,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAyB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC/D,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CACpF,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK;SACT,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACb,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC;QAC3B,4CAA4C;SAC3C,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;AAC3B,CAAC"}

package/build/utils/meta-loader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * DS meta loader — runtime-dep-backed since v4.0.0.
+ *
+ * Reads the DS meta from the `@lando-labs/lando-ds-meta` npm package
+ * (default export is `meta.json`, `/verbose` for the verbose bundle).
+ * Types come from the same package. Replaces the v3.x build-time copy
+ * workflow (`scripts/copy-ds-meta.ts` + baked `src/data/ds-meta.*.json`).
+ *
+ * Compat: MCP supports schema version ^1.0. Bumps within 1.x are additive;
+ * 2.x would be a breaking change and requires an MCP major bump too.
+ */
+import type { LightMeta, VerboseMeta, LightComponentMeta, VerboseComponentMeta, HookMeta, IconRegistryEntry, MetaSchemaVersion } from '@lando-labs/lando-ds-meta/types';
+export type { LightMeta, VerboseMeta, LightComponentMeta, VerboseComponentMeta, HookMeta, IconRegistryEntry, MetaSchemaVersion, };
+export declare class MetaCompatError extends Error {
+    constructor(message: string);
+}
+/**
+ * The light meta — always available. Prefer this for anything that doesn't
+ * need descriptions, examples, composes, or appliesClassNames.
+ */
+export declare function getLightMeta(): LightMeta;
+/**
+ * The verbose meta. Use when the tool needs descriptions, examples,
+ * composes, or appliesClassNames.
+ */
+export declare function getVerboseMeta(): VerboseMeta;
+export declare function getComponentNames(): string[];
+export declare function getComponent(name: string): LightComponentMeta | undefined;
+export declare function getVerboseComponent(name: string): VerboseComponentMeta | undefined;
+export declare function getDsPackageName(): string;
+export declare function getDsVersion(): string;
+export declare function getSchemaVersion(): MetaSchemaVersion;
+export declare function getHookNames(): string[];
+export declare function getHook(name: string): HookMeta | undefined;
+export declare function likelySpreadsHtmlAttrs(cmp: LightComponentMeta): boolean;
+export declare function renderHtmlAttrsFooter(cmp: LightComponentMeta): string;
+//# sourceMappingURL=meta-loader.d.ts.map

package/build/utils/meta-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-loader.d.ts","sourceRoot":"","sources":["../../src/utils/meta-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,iCAAiC,CAAA;AAexC,YAAY,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAClB,CAAA;AAUD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AA2BD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAMD,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAElF;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE1D;AASD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAIvE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAcrE"}

package/build/utils/meta-loader.js

@@ -0,0 +1,114 @@
+/**
+ * DS meta loader — runtime-dep-backed since v4.0.0.
+ *
+ * Reads the DS meta from the `@lando-labs/lando-ds-meta` npm package
+ * (default export is `meta.json`, `/verbose` for the verbose bundle).
+ * Types come from the same package. Replaces the v3.x build-time copy
+ * workflow (`scripts/copy-ds-meta.ts` + baked `src/data/ds-meta.*.json`).
+ *
+ * Compat: MCP supports schema version ^1.0. Bumps within 1.x are additive;
+ * 2.x would be a breaking change and requires an MCP major bump too.
+ */
+import { createRequire } from 'module';
+// The meta subpackage's `exports` map serves JSON at `.` and `./verbose`.
+// TypeScript's static `import ... with { type: 'json' }` friction here is
+// that the package's types.d.ts describes the JSON *shape* but doesn't
+// declare a `default` export. Using `createRequire` bypasses the typing
+// mismatch and reads the JSON directly (the package explicitly declares
+// `"type": "module"` on its own, but `createRequire` works fine in ESM
+// consumers for the "give me the JSON blob" case).
+const requireJson = createRequire(import.meta.url);
+const meta = requireJson('@lando-labs/lando-ds-meta');
+const verboseMetaRaw = requireJson('@lando-labs/lando-ds-meta/verbose');
+const lightMeta = meta;
+// ---------------------------------------------------------------------------
+// Compat
+// ---------------------------------------------------------------------------
+const SUPPORTED_SCHEMA_MAJOR = 1;
+export class MetaCompatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MetaCompatError';
+    }
+}
+function assertCompatibleSchema(schemaVersion, source) {
+    if (typeof schemaVersion !== 'string') {
+        throw new MetaCompatError(`Meta from "${source}" is missing $schemaVersion. Cannot verify compatibility.`);
+    }
+    const match = /^(\d+)\.(\d+)$/.exec(schemaVersion);
+    if (!match) {
+        throw new MetaCompatError(`Meta from "${source}" has malformed $schemaVersion "${schemaVersion}" (expected MAJOR.MINOR).`);
+    }
+    const major = Number(match[1]);
+    if (major !== SUPPORTED_SCHEMA_MAJOR) {
+        throw new MetaCompatError(`Meta from "${source}" declares schema v${schemaVersion}; MCP supports v${SUPPORTED_SCHEMA_MAJOR}.x only. Bump the MCP major to support a newer schema.`);
+    }
+}
+assertCompatibleSchema(lightMeta.$schemaVersion, '@lando-labs/lando-ds-meta');
+const verboseMeta = verboseMetaRaw;
+assertCompatibleSchema(verboseMeta.$schemaVersion, '@lando-labs/lando-ds-meta/verbose');
+/**
+ * The light meta — always available. Prefer this for anything that doesn't
+ * need descriptions, examples, composes, or appliesClassNames.
+ */
+export function getLightMeta() {
+    return lightMeta;
+}
+/**
+ * The verbose meta. Use when the tool needs descriptions, examples,
+ * composes, or appliesClassNames.
+ */
+export function getVerboseMeta() {
+    return verboseMeta;
+}
+// ---------------------------------------------------------------------------
+// Convenience accessors used across tools.
+// ---------------------------------------------------------------------------
+export function getComponentNames() {
+    return Object.keys(lightMeta.components).sort();
+}
+export function getComponent(name) {
+    return lightMeta.components[name];
+}
+export function getVerboseComponent(name) {
+    return verboseMeta.components[name];
+}
+export function getDsPackageName() {
+    return lightMeta.package.name;
+}
+export function getDsVersion() {
+    return lightMeta.package.version;
+}
+export function getSchemaVersion() {
+    return lightMeta.$schemaVersion;
+}
+export function getHookNames() {
+    return lightMeta.hooks ? Object.keys(lightMeta.hooks).sort() : [];
+}
+export function getHook(name) {
+    return lightMeta.hooks?.[name];
+}
+// ---------------------------------------------------------------------------
+// HTML-attrs pass-through helpers — MCP-specific rendering logic, not part
+// of the DS meta shape. Kept as-is from v3.x.
+// ---------------------------------------------------------------------------
+const HTML_ATTRS_FOOTER_OWN_PROPS_THRESHOLD = 3;
+export function likelySpreadsHtmlAttrs(cmp) {
+    const ownPropsCount = Object.keys(cmp.props).length;
+    if (ownPropsCount >= HTML_ATTRS_FOOTER_OWN_PROPS_THRESHOLD)
+        return false;
+    return cmp.polymorphic || cmp.ref !== null;
+}
+export function renderHtmlAttrsFooter(cmp) {
+    if (cmp.extends && cmp.extends.length > 0) {
+        const chain = cmp.extends.map((t) => `\`${t}\``).join(', ');
+        return (`\n> _Also accepts everything in: ${chain}. ` +
+            `(Standard React/HTML attributes like className, id, aria-\\*, and event handlers propagate through.)_\n`);
+    }
+    if (!likelySpreadsHtmlAttrs(cmp))
+        return '';
+    const refPart = cmp.ref ? ` (forwards to \`${cmp.ref}\`)` : '';
+    return (`\n> _Note: this component may accept additional standard React/HTML attributes${refPart} ` +
+        `(className, id, aria-\\*, event handlers) not enumerated here. See the component source in the DS for the full extends chain._\n`);
+}
+//# sourceMappingURL=meta-loader.js.map

package/build/utils/meta-loader.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@lando-labs/lando-ds-mcp",
+  "version": "4.0.0",
+  "description": "MCP server for the Lando Labs Design System — thin protocol adapter over @lando-labs/lando-ds-meta. Exposes 127 components, DS utility hooks, OKLCH-aware design tokens, DS-brand + Lucide-curated icons, capability introspection, and JSX-safe code generation to AI agents. 15 tools; auto-current with every DS release via the meta schema-version compat boundary.",
+  "type": "module",
+  "main": "./build/index.js",
+  "bin": {
+    "lando-ds-mcp": "./build/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lando-labs/lando-ds-mcp.git"
+  },
+  "homepage": "https://github.com/lando-labs/lando-ds-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/lando-labs/lando-ds-mcp/issues"
+  },
+  "files": [
+    "build/",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "generate:lucide-icons": "npx tsx scripts/generate-lucide-icon-index.ts",
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "test": "node build/test.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "design-system",
+    "lando-labs",
+    "ai",
+    "claude"
+  ],
+  "author": "Lando Labs",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@lando-labs/lando-ds-meta": "^0.57.0",
+    "@modelcontextprotocol/sdk": "^1.25.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}