@layoutdesign/context 0.6.0 → 0.10.1

package/dist/src/mcp/tools/get-recent-visual-edits.js

@@ -0,0 +1,106 @@
+/**
+ * MCP tool: get-recent-visual-edits
+ *
+ * Returns recent class/token/inline-style edits made by the user in layout
+ * Live. Reads from Live's socket when running; falls back to the on-disk
+ * `.layout/live/recent-edits.json` log when Live is not running.
+ */
+import { z } from "zod";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { connectToLive } from "./_live-socket.js";
+export const name = "get-recent-visual-edits";
+export const description = "Returns recent visual edits made by the user in layout Live. Use this " +
+    "when the user references 'the change I just made', 'what I tweaked', or " +
+    "you need context on recent UI modifications before generating new code. " +
+    "Works even when Live is not running (reads the on-disk edit log).";
+export const inputSchema = {
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .default(20)
+        .describe("Maximum number of edits to return (most recent first)"),
+    since: z
+        .string()
+        .datetime()
+        .optional()
+        .describe("Only return edits with an ISO-8601 timestamp at or after this"),
+    file: z
+        .string()
+        .optional()
+        .describe("Filter to edits on this file (relative to project root)"),
+};
+const EDIT_LOG = path.join(".layout", "live", "recent-edits.json");
+function applyFilters(edits, input) {
+    const limit = input.limit ?? 20;
+    const sinceMs = input.since ? Date.parse(input.since) : undefined;
+    let filtered = edits;
+    if (input.file) {
+        filtered = filtered.filter((e) => e.file === input.file);
+    }
+    if (sinceMs !== undefined && !Number.isNaN(sinceMs)) {
+        filtered = filtered.filter((e) => Date.parse(e.timestamp) >= sinceMs);
+    }
+    // Most recent first.
+    filtered = [...filtered].sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
+    const truncated = filtered.length > limit;
+    return { edits: filtered.slice(0, limit), truncated };
+}
+async function readEditLog(projectRoot) {
+    try {
+        const raw = await fs.readFile(path.join(projectRoot, EDIT_LOG), "utf8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed;
+        if (parsed && Array.isArray(parsed.edits)) {
+            return parsed.edits;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+export function handler() {
+    return async (input) => {
+        const projectRoot = process.cwd();
+        const live = await connectToLive(projectRoot);
+        let result;
+        if (live) {
+            try {
+                const res = await live.send({
+                    method: "get-edits",
+                    params: {
+                        limit: input.limit ?? 20,
+                        since: input.since,
+                        file: input.file,
+                    },
+                });
+                result = {
+                    source: "live-socket",
+                    edits: res?.edits ?? [],
+                    truncated: Boolean(res?.truncated),
+                };
+            }
+            catch {
+                const all = await readEditLog(projectRoot);
+                const { edits, truncated } = applyFilters(all, input);
+                result = { source: "edit-log-file", edits, truncated };
+            }
+            finally {
+                live.close();
+            }
+        }
+        else {
+            const all = await readEditLog(projectRoot);
+            const { edits, truncated } = applyFilters(all, input);
+            result = { source: "edit-log-file", edits, truncated };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    };
+}
+//# sourceMappingURL=get-recent-visual-edits.js.map

package/dist/src/mcp/tools/get-recent-visual-edits.js.map

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

package/dist/src/mcp/tools/get-selected-element.d.ts

@@ -0,0 +1,10 @@
+export declare const name = "get-selected-element";
+export declare const description: string;
+export declare const inputSchema: {};
+export declare function handler(): () => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-selected-element.d.ts.map

package/dist/src/mcp/tools/get-selected-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-selected-element.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/get-selected-element.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAE3C,eAAO,MAAM,WAAW,QAG2D,CAAC;AAGpF,eAAO,MAAM,WAAW,IAAK,CAAC;AAY9B,wBAAgB,OAAO;;;;;GA8BtB"}

package/dist/src/mcp/tools/get-selected-element.js

@@ -0,0 +1,46 @@
+/**
+ * MCP tool: get-selected-element
+ *
+ * Returns the element currently selected in the layout Live desktop app.
+ * Falls back cleanly to `{ running: false }` when Live is not running.
+ */
+import { connectToLive } from "./_live-socket.js";
+export const name = "get-selected-element";
+export const description = "Returns the element currently selected in layout Live (desktop app). " +
+    "Use this when the user says 'this', 'that one', or refers to something " +
+    "they have selected visually. Returns { running: false } if Live is not running.";
+// No inputs — mirrors the existing raw-shape convention (e.g. get-design-system).
+export const inputSchema = {};
+export function handler() {
+    return async () => {
+        const live = await connectToLive();
+        if (!live) {
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ running: false }) },
+                ],
+            };
+        }
+        try {
+            const sel = await live.send({ method: "get-selection" });
+            const payload = sel?.selected
+                ? { running: true, ...sel }
+                : { running: true, selected: false };
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload) }],
+            };
+        }
+        catch {
+            // Socket present but query failed — surface as not running rather than error.
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ running: false }) },
+                ],
+            };
+        }
+        finally {
+            live.close();
+        }
+    };
+}
+//# sourceMappingURL=get-selected-element.js.map

package/dist/src/mcp/tools/get-selected-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-selected-element.js","sourceRoot":"","sources":["../../../../src/mcp/tools/get-selected-element.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,MAAM,IAAI,GAAG,sBAAsB,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GACtB,uEAAuE;IACvE,yEAAyE;IACzE,iFAAiF,CAAC;AAEpF,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAY9B,MAAM,UAAU,OAAO;IACrB,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;iBACpE;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAkB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,GAAG,EAAE,QAAQ;gBAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE;gBAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;YAC9E,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;iBACpE;aACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/lock-file.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MCP tool: lock-file
+ *
+ * Reserves exclusive write access to a project file so Claude and the layout
+ * Live desktop app don't clobber each other's edits. Backed by the atomic
+ * file-based lock store at `.layout/live/locks.json`.
+ */
+import { z } from "zod";
+export declare const name = "lock-file";
+export declare const description: string;
+export declare const inputSchema: {
+    path: z.ZodString;
+    ttl_seconds: z.ZodDefault<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+};
+type Input = {
+    path: string;
+    ttl_seconds?: number;
+    reason?: string;
+};
+export declare function handler(): (input: Input) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=lock-file.d.ts.map

package/dist/src/mcp/tools/lock-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/lock-file.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,cAAc,CAAC;AAEhC,eAAO,MAAM,WAAW,QAID,CAAC;AAExB,eAAO,MAAM,WAAW;;;;CAavB,CAAC;AAEF,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,wBAAgB,OAAO,KACP,OAAO,KAAK;;;;;GAW3B"}

package/dist/src/mcp/tools/lock-file.js

@@ -0,0 +1,42 @@
+/**
+ * MCP tool: lock-file
+ *
+ * Reserves exclusive write access to a project file so Claude and the layout
+ * Live desktop app don't clobber each other's edits. Backed by the atomic
+ * file-based lock store at `.layout/live/locks.json`.
+ */
+import { z } from "zod";
+import { acquireLock } from "../live-lock-store.js";
+export const name = "lock-file";
+export const description = "Reserves exclusive write access to a file. Call this before editing a " +
+    "file that may also be open in layout Live. Hold for the specified TTL, " +
+    "then release with unlock-file. If the lock is held by Live, retry briefly " +
+    "or notify the user.";
+export const inputSchema = {
+    path: z.string().describe("Path relative to project root"),
+    ttl_seconds: z
+        .number()
+        .int()
+        .positive()
+        .max(300)
+        .default(60)
+        .describe("How long the lock is held before it auto-expires"),
+    reason: z
+        .string()
+        .optional()
+        .describe("Why the lock is being acquired"),
+};
+export function handler() {
+    return async (input) => {
+        const result = await acquireLock(process.cwd(), {
+            path: input.path,
+            ttlSeconds: input.ttl_seconds ?? 60,
+            reason: input.reason,
+            holder: "claude",
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    };
+}
+//# sourceMappingURL=lock-file.js.map

package/dist/src/mcp/tools/lock-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.js","sourceRoot":"","sources":["../../../../src/mcp/tools/lock-file.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAEhC,MAAM,CAAC,MAAM,WAAW,GACtB,wEAAwE;IACxE,yEAAyE;IACzE,4EAA4E;IAC5E,qBAAqB,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1D,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;CAC9C,CAAC;AAIF,MAAM,UAAU,OAAO;IACrB,OAAO,KAAK,EAAE,KAAY,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE;YAC9C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/unlock-file.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP tool: unlock-file
+ *
+ * Releases a previously-acquired file lock by its lock id. Only the entry
+ * whose `lock_id` matches is removed.
+ */
+import { z } from "zod";
+export declare const name = "unlock-file";
+export declare const description: string;
+export declare const inputSchema: {
+    lock_id: z.ZodString;
+};
+type Input = {
+    lock_id: string;
+};
+export declare function handler(): (input: Input) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=unlock-file.d.ts.map

package/dist/src/mcp/tools/unlock-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock-file.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/unlock-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAEkD,CAAC;AAE3E,eAAO,MAAM,WAAW;;CAEvB,CAAC;AAEF,KAAK,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAgB,OAAO,KACP,OAAO,KAAK;;;;;GAM3B"}

package/dist/src/mcp/tools/unlock-file.js

@@ -0,0 +1,23 @@
+/**
+ * MCP tool: unlock-file
+ *
+ * Releases a previously-acquired file lock by its lock id. Only the entry
+ * whose `lock_id` matches is removed.
+ */
+import { z } from "zod";
+import { releaseLock } from "../live-lock-store.js";
+export const name = "unlock-file";
+export const description = "Releases a previously-acquired file lock. Pass the lock_id returned by " +
+    "lock-file. A non-matching or already-expired lock_id releases nothing.";
+export const inputSchema = {
+    lock_id: z.string().describe("The lock_id returned by a prior lock-file call"),
+};
+export function handler() {
+    return async (input) => {
+        const result = await releaseLock(process.cwd(), input.lock_id);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    };
+}
+//# sourceMappingURL=unlock-file.js.map

package/dist/src/mcp/tools/unlock-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock-file.js","sourceRoot":"","sources":["../../../../src/mcp/tools/unlock-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,yEAAyE;IACzE,wEAAwE,CAAC;AAE3E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC/E,CAAC;AAIF,MAAM,UAAU,OAAO;IACrB,OAAO,KAAK,EAAE,KAAY,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/plugins/next/babel-loader.d.ts

@@ -0,0 +1,8 @@
+interface LoaderContext {
+    resourcePath: string;
+    rootContext: string;
+    async(): (err: Error | null, content?: string, sourceMap?: object) => void;
+}
+export default function layoutBabelLoader(this: LoaderContext, source: string, inputMap?: object): void;
+export {};
+//# sourceMappingURL=babel-loader.d.ts.map

package/dist/src/plugins/next/babel-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babel-loader.d.ts","sourceRoot":"","sources":["../../../../src/plugins/next/babel-loader.ts"],"names":[],"mappings":"AASA,UAAU,aAAa;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,IAAI,CACP,GAAG,EAAE,KAAK,GAAG,IAAI,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;CACX;AAED,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAmBN"}

package/dist/src/plugins/next/babel-loader.js

@@ -0,0 +1,26 @@
+/**
+ * Thin webpack-loader wrapper around the shared layout Babel transform.
+ *
+ * Runs after Next's own Babel loader (so it sees plain JSX). Injects the
+ * layout source-location attrs in dev only. Source maps are chained back to
+ * webpack so error stacks still point at the user's original lines.
+ */
+import { transformWithLayoutAttrs } from "../transform.js";
+export default function layoutBabelLoader(source, inputMap) {
+    const callback = this.async();
+    try {
+        const result = transformWithLayoutAttrs(source, this.resourcePath, this.rootContext);
+        if (result.code === source && result.map === null) {
+            // Nothing injected — pass through with the incoming map intact.
+            callback(null, source, inputMap);
+            return;
+        }
+        callback(null, result.code, result.map ?? inputMap);
+    }
+    catch (err) {
+        // Never break the dev build over an attr-injection failure.
+        callback(null, source, inputMap);
+        void err;
+    }
+}
+//# sourceMappingURL=babel-loader.js.map

package/dist/src/plugins/next/babel-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"babel-loader.js","sourceRoot":"","sources":["../../../../src/plugins/next/babel-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAY3D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAEvC,MAAc,EACd,QAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,wBAAwB,CACrC,MAAM,EACN,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YAClD,gEAAgE;YAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4DAA4D;QAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACjC,KAAK,GAAG,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/src/plugins/next/index.d.ts

@@ -0,0 +1,23 @@
+type WebpackRule = {
+    test: RegExp;
+    exclude?: RegExp;
+    use: unknown[];
+};
+interface WebpackConfigLike {
+    module?: {
+        rules?: WebpackRule[];
+    };
+}
+interface WebpackOptions {
+    dev: boolean;
+    defaultLoaders?: {
+        babel?: unknown;
+    };
+}
+export interface NextConfigLike {
+    webpack?: (config: WebpackConfigLike, options: WebpackOptions) => WebpackConfigLike;
+    [key: string]: unknown;
+}
+export default function withLayout(nextConfig?: NextConfigLike): NextConfigLike;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/next/index.ts"],"names":[],"mappings":"AAkBA,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,EAAE,CAAC;CAChB,CAAC;AAEF,UAAU,iBAAiB;IACzB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,cAAc,KACpB,iBAAiB,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,UAAU,GAAE,cAAmB,GAC9B,cAAc,CAoChB"}

package/dist/src/plugins/next/index.js

@@ -0,0 +1,58 @@
+/**
+ * `@layoutdesign/context/next-plugin`
+ *
+ * Next.js config HOC. Adds a dev-only webpack rule that runs the shared
+ * layout Babel transform on .tsx/.jsx files (Option A from the spec — Babel
+ * via webpack; SWC plugin is a future v1.1 item). No-op in production.
+ *
+ *   import withLayout from '@layoutdesign/context/next-plugin';
+ *   export default withLayout({ /* ...next config *\/ });
+ *
+ * Composes cleanly with an existing user `webpack(config, options)` override:
+ * we mutate the config, then defer to the user's function if present.
+ *
+ * `next`/`webpack` are optional peers — types are kept structural so the
+ * package builds and ships without them installed.
+ */
+import { fileURLToPath } from "node:url";
+/** Absolute path to the compiled babel-loader, resolved relative to here. */
+function babelLoaderPath() {
+    return fileURLToPath(new URL("./babel-loader.js", import.meta.url));
+}
+let turbopackWarned = false;
+export default function withLayout(nextConfig = {}) {
+    // Turbopack (`next dev --turbo`, default in newer Next) ignores the
+    // `webpack()` hook, so the dev tagging below never runs and layout Live
+    // would silently fail to resolve elements. Make that explicit once
+    // rather than silent. Native Turbopack/SWC tagging is tracked separately.
+    if (process.env.TURBOPACK && !turbopackWarned) {
+        turbopackWarned = true;
+        console.warn("[@layoutdesign/context] Turbopack detected — layout Live source " +
+            "tagging needs webpack. Run `next dev` without --turbo for the " +
+            "visual-edit loop (Turbopack support is tracked, not yet shipped).");
+    }
+    return {
+        ...nextConfig,
+        webpack(config, options) {
+            if (options.dev) {
+                config.module ??= {};
+                config.module.rules ??= [];
+                const use = [];
+                if (options.defaultLoaders?.babel) {
+                    use.push(options.defaultLoaders.babel);
+                }
+                use.push({ loader: babelLoaderPath() });
+                config.module.rules.push({
+                    test: /\.(tsx|jsx)$/,
+                    exclude: /node_modules/,
+                    use,
+                });
+            }
+            // Defer to the user's own webpack override, if any.
+            return typeof nextConfig.webpack === "function"
+                ? nextConfig.webpack(config, options)
+                : config;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/next/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAyBzC,6EAA6E;AAC7E,SAAS,eAAe;IACtB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,aAA6B,EAAE;IAE/B,oEAAoE;IACpE,wEAAwE;IACxE,mEAAmE;IACnE,0EAA0E;IAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9C,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,IAAI,CACV,kEAAkE;YAChE,gEAAgE;YAChE,mEAAmE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,UAAU;QACb,OAAO,CAAC,MAAyB,EAAE,OAAuB;YACxD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC;gBACrB,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAc,EAAE,CAAC;gBAC1B,IAAI,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC;oBAClC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACzC,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;gBACxC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBACvB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,cAAc;oBACvB,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;YACD,oDAAoD;YACpD,OAAO,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU;gBAC7C,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;gBACrC,CAAC,CAAC,MAAM,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/plugins/transform.d.ts

@@ -0,0 +1,19 @@
+export interface TransformOptions {
+    /** Force-enable in production builds (not recommended). Default: false. */
+    production?: boolean;
+}
+export interface TransformResult {
+    code: string;
+    map: object | null;
+}
+/** Whether attrs should be injected given env + options. */
+export declare function shouldTransform(options?: TransformOptions): boolean;
+/**
+ * Transform `code` for `filename`, injecting the layout source-location attrs.
+ *
+ * Returns the original code unchanged (with `map: null`) when transformation
+ * is skipped (production env, parse failure). Never throws on user code — a
+ * malformed file is passed through untouched so the dev build keeps working.
+ */
+export declare function transformWithLayoutAttrs(code: string, filename: string, projectRoot: string, options?: TransformOptions): TransformResult;
+//# sourceMappingURL=transform.d.ts.map

package/dist/src/plugins/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/plugins/transform.ts"],"names":[],"mappings":"AA+CA,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAGvE;AA0ED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAyEjB"}