@layoutdesign/context 0.2.0 → 0.2.2

package/dist/src/cli/serve-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-local.d.ts","sourceRoot":"","sources":["../../../src/cli/serve-local.ts"],"names":[],"mappings":"AAuDA,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEtH"}

package/dist/src/cli/serve-local.js

@@ -0,0 +1,109 @@
+import fs from "node:fs";
+import path from "node:path";
+import net from "node:net";
+import { spawn } from "node:child_process";
+import chalk from "chalk";
+// Ports commonly occupied by VSCode, Next.js, Vite, etc. — skip these
+const SKIP_PORTS = new Set([3000, 3001, 3002, 4321, 5173, 8080, 8081]);
+const DEFAULT_PORT_RANGE_START = 8765;
+function isPortFree(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", () => resolve(false));
+        server.once("listening", () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port);
+    });
+}
+async function findFreePort(start) {
+    let port = start;
+    while (port < start + 100) {
+        if (!SKIP_PORTS.has(port) && (await isPortFree(port))) {
+            return port;
+        }
+        port++;
+    }
+    throw new Error("Could not find a free port in range");
+}
+function waitForServer(url, timeoutMs = 5000) {
+    return new Promise((resolve) => {
+        const deadline = Date.now() + timeoutMs;
+        const { execFileSync } = require("node:child_process");
+        function poll() {
+            try {
+                execFileSync("curl", ["-sf", "-o", "/dev/null", "--max-time", "1", url], {
+                    stdio: "ignore",
+                });
+                resolve(true);
+            }
+            catch {
+                if (Date.now() > deadline) {
+                    resolve(false);
+                }
+                else {
+                    setTimeout(poll, 200);
+                }
+            }
+        }
+        poll();
+    });
+}
+export async function serveLocalCommand(targetPath, options) {
+    const absTarget = path.resolve(process.cwd(), targetPath);
+    if (!fs.existsSync(absTarget)) {
+        console.log(chalk.red("Error:"), `Path not found: ${absTarget}`);
+        process.exit(1);
+    }
+    const isFile = fs.statSync(absTarget).isFile();
+    const directory = isFile ? path.dirname(absTarget) : absTarget;
+    const filePart = isFile ? path.basename(absTarget) : "";
+    // Resolve port
+    let port;
+    if (options.port) {
+        const free = await isPortFree(options.port);
+        if (!free) {
+            console.log(chalk.red("Error:"), `Port ${options.port} is already in use. Try a different port with --port <n>.`);
+            process.exit(1);
+        }
+        port = options.port;
+    }
+    else {
+        port = await findFreePort(DEFAULT_PORT_RANGE_START);
+    }
+    const url = `http://localhost:${port}${filePart ? `/${filePart}` : ""}`;
+    // Start a detached Python HTTP server (survives shell session death)
+    const child = spawn("python3", ["-m", "http.server", String(port), "--directory", directory], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    // Wait for it to be ready
+    const baseUrl = `http://localhost:${port}/`;
+    const ready = await waitForServer(baseUrl);
+    if (!ready) {
+        console.log(chalk.red("Error:"), "Server did not start in time. Check that python3 is available.");
+        process.exit(1);
+    }
+    if (!options.quiet) {
+        console.log();
+        console.log(chalk.bold("  Layout — Local file server"));
+        console.log();
+        console.log(chalk.green("  ✓"), `Serving on ${chalk.cyan(url)}`);
+        console.log(chalk.dim("    Directory:"), directory);
+        console.log(chalk.dim("    PID:"), child.pid ?? "unknown");
+        console.log();
+        console.log(chalk.yellow("  →"), "Pass this URL to", chalk.cyan("url-to-figma"), "or open it in your browser");
+        console.log();
+        console.log(chalk.dim("  Note: file:// URLs are not supported by the Figma capture script."));
+        console.log(chalk.dim("        This HTTP server is required even for static HTML files."));
+        console.log();
+        console.log(chalk.dim(`  To stop: kill ${child.pid ?? "<PID>"}`));
+        console.log();
+    }
+    else {
+        // Machine-readable output for scripting
+        console.log(url);
+    }
+}
+//# sourceMappingURL=serve-local.js.map

package/dist/src/cli/serve-local.js.map

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

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 export { loadKit, getBundledKitPath, listBundledKits } from "./kit/loader.js";
-export { parseDesignMd, extractQuickReference, parseComponents } from "./kit/parser.js";
+export { parseLayoutMd, extractQuickReference, parseComponents } from "./kit/parser.js";
 export { getRegistry, findKitInRegistry } from "./kit/registry.js";
 export type { Kit, KitManifest, KitSection, KitComponent, RegistryEntry } from "./kit/types.js";
 export { checkCompliance } from "./compliance/checker.js";

package/dist/src/index.js

@@ -1,5 +1,5 @@
 export { loadKit, getBundledKitPath, listBundledKits } from "./kit/loader.js";
-export { parseDesignMd, extractQuickReference, parseComponents } from "./kit/parser.js";
+export { parseLayoutMd, extractQuickReference, parseComponents } from "./kit/parser.js";
 export { getRegistry, findKitInRegistry } from "./kit/registry.js";
 export { checkCompliance } from "./compliance/checker.js";
 export { defaultRules } from "./compliance/rules.js";

package/dist/src/kit/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/kit/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAA6B,MAAM,YAAY,CAAC;AAajE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAiErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAe1C"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/kit/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAA6B,MAAM,YAAY,CAAC;AAajE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CA0ErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAe1C"}

package/dist/src/kit/loader.js

@@ -1,8 +1,8 @@
-import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { readFileSync, existsSync, readdirSync, renameSync } from "node:fs";
 import { join, resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { LAYOUT_DIR, LEGACY_DIR, KIT_MANIFEST_FILE, DESIGN_MD_FILE, TOKENS_CSS_FILE, TOKENS_JSON_FILE, TAILWIND_CONFIG_FILE, COMPONENTS_DIR, } from "./types.js";
-import { parseDesignMd, parseComponents } from "./parser.js";
+import { LAYOUT_DIR, LEGACY_DIR, KIT_MANIFEST_FILE, LAYOUT_MD_FILE, TOKENS_CSS_FILE, TOKENS_JSON_FILE, TAILWIND_CONFIG_FILE, COMPONENTS_DIR, } from "./types.js";
+import { parseLayoutMd, parseComponents } from "./parser.js";
 /**
  * Load a kit from a .layout/ directory.
  * Falls back to .superduper/ with a deprecation warning if .layout/ is not found.
@@ -23,8 +23,16 @@ export function loadKit(basePath) {
         }
     }
     const manifestPath = join(dir, KIT_MANIFEST_FILE);
-    const designMdPath = join(dir, DESIGN_MD_FILE);
-    if (!existsSync(designMdPath))
+    let layoutMdPath = join(dir, LAYOUT_MD_FILE);
+    // Auto-migration: rename DESIGN.md → layout.md if the old file exists
+    if (!existsSync(layoutMdPath)) {
+        const legacyMdPath = join(dir, "DESIGN.md");
+        if (existsSync(legacyMdPath)) {
+            renameSync(legacyMdPath, layoutMdPath);
+            console.log("  ℹ Renamed DESIGN.md → layout.md (Layout rebrand)");
+        }
+    }
+    if (!existsSync(layoutMdPath))
         return null;
     const manifest = existsSync(manifestPath)
         ? JSON.parse(readFileSync(manifestPath, "utf-8"))
@@ -39,9 +47,9 @@ export function loadKit(basePath) {
             componentCount: 0,
             aesthetic: "",
         };
-    const designMd = readFileSync(designMdPath, "utf-8");
-    const sections = parseDesignMd(designMd);
-    let components = parseComponents(designMd);
+    const layoutMd = readFileSync(layoutMdPath, "utf-8");
+    const sections = parseLayoutMd(layoutMd);
+    let components = parseComponents(layoutMd);
     // Also load individual component files if present
     const componentsDir = join(dir, COMPONENTS_DIR);
     if (existsSync(componentsDir)) {
@@ -57,7 +65,7 @@ export function loadKit(basePath) {
     const tailwindConfig = readSafe(join(dir, TAILWIND_CONFIG_FILE));
     return {
         manifest,
-        designMd,
+        layoutMd,
         sections,
         components,
         tokensCss: tokensCss ?? undefined,

package/dist/src/kit/loader.js.map

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

package/dist/src/kit/parser.d.ts

@@ -1,11 +1,11 @@
 import type { KitSection, KitComponent } from "./types.js";
 /**
- * Parse a DESIGN.md file into structured sections.
+ * Parse a layout.md file into structured sections.
  * Splits on ## headings and extracts section IDs.
  */
-export declare function parseDesignMd(content: string): KitSection[];
+export declare function parseLayoutMd(content: string): KitSection[];
 /**
- * Extract Quick Reference section (Section 0) from DESIGN.md.
+ * Extract Quick Reference section (Section 0) from layout.md.
  * This is the 50-75 line summary optimised for LLM context windows.
  */
 export declare function extractQuickReference(content: string): string;
@@ -14,7 +14,7 @@ export declare function extractQuickReference(content: string): string;
  */
 export declare function extractSection(sections: KitSection[], keyword: string): KitSection | undefined;
 /**
- * Parse component specs from DESIGN.md or individual component files.
+ * Parse component specs from layout.md or individual component files.
  * Components are expected in a "## Components" section with ### per component.
  */
 export declare function parseComponents(content: string): KitComponent[];

package/dist/src/kit/parser.js

@@ -1,8 +1,8 @@
 /**
- * Parse a DESIGN.md file into structured sections.
+ * Parse a layout.md file into structured sections.
  * Splits on ## headings and extracts section IDs.
  */
-export function parseDesignMd(content) {
+export function parseLayoutMd(content) {
     const sections = [];
     const lines = content.split("\n");
     let currentTitle = "";
@@ -34,7 +34,7 @@ export function parseDesignMd(content) {
     return sections;
 }
 /**
- * Extract Quick Reference section (Section 0) from DESIGN.md.
+ * Extract Quick Reference section (Section 0) from layout.md.
  * This is the 50-75 line summary optimised for LLM context windows.
  */
 export function extractQuickReference(content) {
@@ -50,7 +50,7 @@ export function extractSection(sections, keyword) {
         s.title.toLowerCase().includes(lower));
 }
 /**
- * Parse component specs from DESIGN.md or individual component files.
+ * Parse component specs from layout.md or individual component files.
  * Components are expected in a "## Components" section with ### per component.
  */
 export function parseComponents(content) {

package/dist/src/kit/types.d.ts

@@ -23,7 +23,7 @@ export interface KitComponent {
 }
 export interface Kit {
     manifest: KitManifest;
-    designMd: string;
+    layoutMd: string;
     sections: KitSection[];
     components: KitComponent[];
     tokensCss?: string;
@@ -41,7 +41,7 @@ export interface RegistryEntry {
 export declare const LAYOUT_DIR = ".layout";
 export declare const LEGACY_DIR = ".superduper";
 export declare const KIT_MANIFEST_FILE = "kit.json";
-export declare const DESIGN_MD_FILE = "DESIGN.md";
+export declare const LAYOUT_MD_FILE = "layout.md";
 export declare const TOKENS_CSS_FILE = "tokens.css";
 export declare const TOKENS_JSON_FILE = "tokens.json";
 export declare const TAILWIND_CONFIG_FILE = "tailwind.config.js";

package/dist/src/kit/types.js

@@ -1,7 +1,7 @@
 export const LAYOUT_DIR = ".layout";
 export const LEGACY_DIR = ".superduper"; // Deprecated — remove in v1.0
 export const KIT_MANIFEST_FILE = "kit.json";
-export const DESIGN_MD_FILE = "DESIGN.md";
+export const LAYOUT_MD_FILE = "layout.md";
 export const TOKENS_CSS_FILE = "tokens.css";
 export const TOKENS_JSON_FILE = "tokens.json";
 export const TAILWIND_CONFIG_FILE = "tailwind.config.js";

package/dist/src/mcp/tools/design-in-figma.js

@@ -72,7 +72,7 @@ export function handler(kit) {
             })
                 .join("\n")
             : "No components defined in kit.";
-        // Build design rules from DESIGN.md
+        // Build design rules from layout.md
         const designRules = extractDesignRules(kit);
         // Viewport dimensions
         const viewportDimensions = {

package/dist/src/mcp/tools/get-design-system.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { extractSection } from "../../kit/parser.js";
 export const name = "get-design-system";
-export const description = "Returns the full DESIGN.md content for the active design system, or a specific section. " +
+export const description = "Returns the full layout.md content for the active design system, or a specific section. " +
     "Use this to understand colours, typography, spacing, layout rules, and component specs before writing UI code.";
 export const inputSchema = {
     section: z
@@ -16,7 +16,7 @@ export function handler(kit) {
                 content: [
                     {
                         type: "text",
-                        text: "No design system kit found. Run `npx @layoutdesign/context init` in your project root to set one up, or place a DESIGN.md in .layout/.",
+                        text: "No design system kit found. Run `npx @layoutdesign/context init` in your project root to set one up, or place a layout.md in .layout/.",
                     },
                 ],
             };
@@ -44,7 +44,7 @@ export function handler(kit) {
             };
         }
         return {
-            content: [{ type: "text", text: kit.designMd }],
+            content: [{ type: "text", text: kit.layoutMd }],
         };
     };
 }

package/dist/src/mcp/tools/list-components.js

@@ -19,7 +19,7 @@ export function handler(kit) {
                 content: [
                     {
                         type: "text",
-                        text: "No components defined in this kit. Components are parsed from the ## Components section in DESIGN.md.",
+                        text: "No components defined in this kit. Components are parsed from the ## Components section in layout.md.",
                     },
                 ],
             };

package/dist/src/mcp/tools/push-to-figma.d.ts

@@ -11,12 +11,20 @@ export declare const inputSchema: {
         mobile: "mobile";
     }>>>;
     figmaUrl: z.ZodOptional<z.ZodString>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>>>;
 };
-export declare function handler(kit: Kit | null): ({ code, name: frameName, viewports, figmaUrl, }: {
+export declare function handler(kit: Kit | null): ({ code, name: frameName, viewports, figmaUrl, variants, }: {
     code: string;
     name?: string;
     viewports?: string[];
     figmaUrl?: string;
+    variants?: Array<{
+        name: string;
+        code: string;
+    }>;
 }) => Promise<{
     content: {
         type: "text";

package/dist/src/mcp/tools/push-to-figma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push-to-figma.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/push-to-figma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,eAAO,MAAM,WAAW,QAI+C,CAAC;AAExE,eAAO,MAAM,WAAW;;;;;;;;;CAiBvB,CAAC;AAUF,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,IACvB,iDAKX;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;GAqJF"}
+{"version":3,"file":"push-to-figma.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/push-to-figma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,eAAO,MAAM,WAAW,QAI+C,CAAC;AAExE,eAAO,MAAM,WAAW;;;;;;;;;;;;;CA6BvB,CAAC;AAmHF,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,IACvB,2DAMX;IACD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;;;;;GAgGF"}