@12ui/design 0.2.93 → 0.2.94

package/SKILL.md

@@ -23,7 +23,7 @@ candidates.
 Use `12ui` when it is available on `PATH`. Otherwise invoke the pinned CLI that
 the plugin's `open-design.json` MCP entry uses:
 
-    npx -y @12ui/design@0.2.93 <command> ...
+    npx -y @12ui/design@0.2.94 <command> ...
 
 Run `12ui auth status --json` (or its pinned `npx` equivalent) first. A desktop user can authenticate with `12ui auth login`; a headless
 run supplies `TWELVE_UI_API_KEY`. Never put a credential into project files,

package/dist/cli-workspace-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-workspace-command.d.ts","sourceRoot":"","sources":["../src/cli-workspace-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAQ5E,OAAO,EAAE,uBAAuB,EAA2B,MAAM,2BAA2B,CAAC;AAG7F;;;;;;;;;GASG;AAEH,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,OAAO,uBAAuB,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD,CAAC;AAwCF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,QAAQ,EACf,eAAc,4BAAiC,KAC9C,OAAO,CAAC,IAAI,CA4Cd,CAAC"}
+{"version":3,"file":"cli-workspace-command.d.ts","sourceRoot":"","sources":["../src/cli-workspace-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAQ5E,OAAO,EAAE,uBAAuB,EAA2B,MAAM,2BAA2B,CAAC;AAI7F;;;;;;;;;GASG;AAEH,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,OAAO,uBAAuB,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD,CAAC;AAwCF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,QAAQ,EACf,eAAc,4BAAiC,KAC9C,OAAO,CAAC,IAAI,CA8Cd,CAAC"}

package/dist/cli-workspace-command.js

@@ -7,6 +7,7 @@ import { findLatestSlateRunDir } from './mcp-slate-latest.js';
 import { resolveSlateRunDir } from './mcp-slate-run.js';
 import { startSlateBrowserServer } from './slate-browser-server.js';
 import { lazyCorpus } from './slate-corpus.js';
+import { startLocalTabs } from './slate-site-references-local.js';
 const ALLOWED_FLAGS = new Set(['wait', 'no-open', 'latest', 'port', 'origin', 'api-key']);
 const stopSignals = () => {
     let release = () => undefined;
@@ -67,6 +68,8 @@ export const runWorkspaceCommand = async (command, flags, dependencies = {}) =>
             context: {
                 cwd: process.cwd(),
                 corpus: lazyCorpus(() => readCorpusConfig({ origin: stringFlag(flags, 'origin'), apiKey: stringFlag(flags, 'api-key') })),
+                // The page's first show starts the References tab's websites, as under `12ui mcp`.
+                gatherReferences: startLocalTabs,
             },
             onDecision: (decision) => { if (wait)
                 settle(decision);

package/dist/cli-workspace-command.js.map

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

package/dist/mcp-slate-tools.d.ts

@@ -3,6 +3,13 @@ import { type SlateToolContext } from './slate-runtime.js';
 export { SLATE_TOOL_DEFINITIONS } from './mcp-slate-tool-defs.js';
 export type { SlateToolContext } from './slate-runtime.js';
 export declare const isSlateTool: (name: string) => boolean;
-/** The runtime is built once per server: its readiness answer and corpus client are cached for the session. */
+/**
+ * The runtime is built once per server: its readiness answer and corpus client are cached for the session.
+ *
+ * The References tab's websites are gathered in the background once per workspace per server, from the earliest call
+ * that names the workspace on its screen: the screen being shown (show, open) or, for a screen the host put back without
+ * a show call (a thread reopened after the server restarted), the person's first use of its Inspiration tool. So the
+ * sites are already landing when the person clicks across to References. The agent's data read starts nothing.
+ */
 export declare const createSlateToolHandler: (context?: SlateToolContext) => (name: string, argumentsValue: unknown) => Promise<CallToolResult>;
 //# sourceMappingURL=mcp-slate-tools.d.ts.map

package/dist/mcp-slate-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-tools.d.ts","sourceRoot":"","sources":["../src/mcp-slate-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA8BzE,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,OAE1C,CAAC;AAEF,+GAA+G;AAC/G,eAAO,MAAM,sBAAsB,GAAI,UAAS,gBAAqB,MAErD,MAAM,MAAM,EAAE,gBAAgB,OAAO,KAAG,OAAO,CAAC,cAAc,CAwC7E,CAAC"}
+{"version":3,"file":"mcp-slate-tools.d.ts","sourceRoot":"","sources":["../src/mcp-slate-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA+BzE,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAInG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,OAE1C,CAAC;AAUF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAS,gBAAqB,MAgDrD,MAAM,MAAM,EAAE,gBAAgB,OAAO,KAAG,OAAO,CAAC,cAAc,CAQ7E,CAAC"}

package/dist/mcp-slate-tools.js

@@ -1,48 +1,80 @@
 import { SLATE_DATA_TOOL, SLATE_HANDOFF_TOOL, SLATE_IMAGE_TOOL, SLATE_INSPIRATION_TOOL, SLATE_INSPIRE_TOOL, SLATE_OPEN_TOOL, SLATE_PICK_TOOL, SLATE_REFERENCE_TOOL, SLATE_RESUME_TOOL, SLATE_RUN_TOOL, SLATE_SHOW_TOOL, SLATE_STATUS_TOOL, SLATE_TOOL_NAMES, } from './mcp-slate-names.js';
 import { handoffResult, imageResult, inspirationResult, inspireResult, openWorkspace, pickResult, referenceResult, resumeResult, runResult, showWorkspace, statusResult, } from './mcp-slate-workspace-tools.js';
+import { resolveSlateRunDir } from './mcp-slate-run.js';
 import { errorResult, inputRecord, slateRuntime } from './slate-runtime.js';
+import { withGathering } from './slate-view.js';
 export { SLATE_TOOL_DEFINITIONS } from './mcp-slate-tool-defs.js';
 export const isSlateTool = (name) => (SLATE_TOOL_NAMES.includes(name));
-/** The runtime is built once per server: its readiness answer and corpus client are cached for the session. */
+/** The screen's calls on its Inspiration tool: the person searching, choosing references, or the tab showing their pictures. */
+const INSPIRATION_TOOLS = new Set([SLATE_INSPIRE_TOOL, SLATE_INSPIRATION_TOOL, SLATE_REFERENCE_TOOL]);
+const viewRunDir = (result) => {
+    const runDir = result.structuredContent?.runDir;
+    return typeof runDir === 'string' && runDir ? runDir : null;
+};
+/**
+ * The runtime is built once per server: its readiness answer and corpus client are cached for the session.
+ *
+ * The References tab's websites are gathered in the background once per workspace per server, from the earliest call
+ * that names the workspace on its screen: the screen being shown (show, open) or, for a screen the host put back without
+ * a show call (a thread reopened after the server restarted), the person's first use of its Inspiration tool. So the
+ * sites are already landing when the person clicks across to References. The agent's data read starts nothing.
+ */
 export const createSlateToolHandler = (context = {}) => {
     const runtime = slateRuntime(context);
+    const gathered = new Set();
+    const gatherOnce = (root) => {
+        if (root === null || gathered.has(root))
+            return;
+        gathered.add(root);
+        runtime.gatherReferences(root);
+    };
+    /** Starts the gather a call calls for; a show or open view built just before it started says it runs. */
+    const gatherFor = async (name, input, result) => {
+        if (result.isError)
+            return result;
+        if (name === SLATE_SHOW_TOOL || name === SLATE_OPEN_TOOL) {
+            gatherOnce(viewRunDir(result));
+            if (viewRunDir(result) === null)
+                return result;
+            return { ...result, structuredContent: withGathering(result.structuredContent) };
+        }
+        if (INSPIRATION_TOOLS.has(name))
+            gatherOnce(await resolveSlateRunDir(input.runDir).catch(() => null));
+        return result;
+    };
+    const dispatch = async (name, input) => {
+        switch (name) {
+            case SLATE_SHOW_TOOL:
+            case SLATE_DATA_TOOL:
+                return await showWorkspace(input, runtime);
+            case SLATE_OPEN_TOOL:
+                return await openWorkspace(runtime);
+            case SLATE_IMAGE_TOOL:
+                return await imageResult(input, runtime);
+            case SLATE_REFERENCE_TOOL:
+                return await referenceResult(input, runtime);
+            case SLATE_INSPIRE_TOOL:
+                return await inspireResult(input, runtime);
+            case SLATE_INSPIRATION_TOOL:
+                return await inspirationResult(input, runtime);
+            case SLATE_PICK_TOOL:
+                return await pickResult(input, runtime);
+            case SLATE_HANDOFF_TOOL:
+                return await handoffResult(input, runtime);
+            case SLATE_STATUS_TOOL:
+                return await statusResult(input, runtime);
+            case SLATE_RUN_TOOL:
+                return await runResult(input, runtime);
+            case SLATE_RESUME_TOOL:
+                return await resumeResult(input, runtime);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    };
     return async (name, argumentsValue) => {
         try {
             const input = inputRecord(argumentsValue);
-            switch (name) {
-                case SLATE_SHOW_TOOL: {
-                    // The screen is being shown: its References tab's websites are gathered (once per workspace and server).
-                    const shown = await showWorkspace(input, runtime);
-                    const runDir = shown.structuredContent?.runDir;
-                    if (typeof runDir === 'string' && runDir)
-                        runtime.gatherReferences(runDir);
-                    return shown;
-                }
-                case SLATE_DATA_TOOL:
-                    return await showWorkspace(input, runtime);
-                case SLATE_OPEN_TOOL:
-                    return await openWorkspace(runtime);
-                case SLATE_IMAGE_TOOL:
-                    return await imageResult(input, runtime);
-                case SLATE_REFERENCE_TOOL:
-                    return await referenceResult(input, runtime);
-                case SLATE_INSPIRE_TOOL:
-                    return await inspireResult(input, runtime);
-                case SLATE_INSPIRATION_TOOL:
-                    return await inspirationResult(input, runtime);
-                case SLATE_PICK_TOOL:
-                    return await pickResult(input, runtime);
-                case SLATE_HANDOFF_TOOL:
-                    return await handoffResult(input, runtime);
-                case SLATE_STATUS_TOOL:
-                    return await statusResult(input, runtime);
-                case SLATE_RUN_TOOL:
-                    return await runResult(input, runtime);
-                case SLATE_RESUME_TOOL:
-                    return await resumeResult(input, runtime);
-                default:
-                    throw new Error(`Unknown tool: ${name}`);
-            }
+            return await gatherFor(name, input, await dispatch(name, input));
         }
         catch (error) {
             return errorResult(error);

package/dist/mcp-slate-tools.js.map

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

package/dist/mcp-slate-ui-script-inspiration-gallery.d.ts

@@ -3,14 +3,16 @@
  *
  * `createGallery({ where, root, isSelected, onToggle })` returns `{ node, set(key, items), sync(), layout() }`.
  *
- * - An item is `{ id, label, thumbUrl, imageUrl, title?, sourceUrl?, srcset?, width?, height?, aspect?, load?, pending? }`:
+ * - An item is `{ id, label, thumbUrl, imageUrl, title?, sourceUrl?, srcset?, width?, height?, aspect?, load?, pending?, picture? }`:
  *   `thumbUrl` for the tile and `imageUrl` for the large view (and the hover peek), straight from their origin (`srcset`
  *   lets the browser pick by the tile's laid-out width); `load(img, size)` fills a picture another way when there is no
  *   URL. A `pending` item has no picture yet: its tile is the loading surface and cannot be selected.
  * - `caption: true` puts the item's title and its site's domain (a link to the live page) under each picture.
  * - `set(key, items)`: a new key is a new list (the tiles are built again from the top); the same key with a longer
  *   list only adds what is new at the end, and refills in place a tile whose item stopped being `pending` (a reference
- *   site whose screenshot landed); a list whose shown part changed otherwise is built again. The first page shows at once and the next page appears as the person nears
+ *   site whose screenshot landed), and swaps in place the picture of a tile whose `picture` key changed (a site's
+ *   settled frame): the old picture stays until the new one has loaded, so the tile never flashes empty; a list whose
+ *   shown part changed otherwise is built again. The first page shows at once and the next page appears as the person nears
  *   the end of the grid (an IntersectionObserver on a marker after the last block, under `root()`, the element that
  *   scrolls the grid, or the window), until the list ends. Each page is its own collage block, so nothing already on
  *   screen ever moves: not on a click, not when a page is added.

package/dist/mcp-slate-ui-script-inspiration-gallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-inspiration-gallery.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-inspiration-gallery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,4BAA4B,QA4OxC,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-inspiration-gallery.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-inspiration-gallery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,4BAA4B,QA4PxC,CAAC"}

package/dist/mcp-slate-ui-script-inspiration-gallery.js

@@ -3,14 +3,16 @@
  *
  * `createGallery({ where, root, isSelected, onToggle })` returns `{ node, set(key, items), sync(), layout() }`.
  *
- * - An item is `{ id, label, thumbUrl, imageUrl, title?, sourceUrl?, srcset?, width?, height?, aspect?, load?, pending? }`:
+ * - An item is `{ id, label, thumbUrl, imageUrl, title?, sourceUrl?, srcset?, width?, height?, aspect?, load?, pending?, picture? }`:
  *   `thumbUrl` for the tile and `imageUrl` for the large view (and the hover peek), straight from their origin (`srcset`
  *   lets the browser pick by the tile's laid-out width); `load(img, size)` fills a picture another way when there is no
  *   URL. A `pending` item has no picture yet: its tile is the loading surface and cannot be selected.
  * - `caption: true` puts the item's title and its site's domain (a link to the live page) under each picture.
  * - `set(key, items)`: a new key is a new list (the tiles are built again from the top); the same key with a longer
  *   list only adds what is new at the end, and refills in place a tile whose item stopped being `pending` (a reference
- *   site whose screenshot landed); a list whose shown part changed otherwise is built again. The first page shows at once and the next page appears as the person nears
+ *   site whose screenshot landed), and swaps in place the picture of a tile whose `picture` key changed (a site's
+ *   settled frame): the old picture stays until the new one has loaded, so the tile never flashes empty; a list whose
+ *   shown part changed otherwise is built again. The first page shows at once and the next page appears as the person nears
  *   the end of the grid (an IntersectionObserver on a marker after the last block, under `root()`, the element that
  *   scrolls the grid, or the window), until the list ends. Each page is its own collage block, so nothing already on
  *   screen ever moves: not on a click, not when a page is added.
@@ -63,7 +65,10 @@ export const SLATE_UI_INSPIRATION_GALLERY = String.raw `
         if (!kept) { g.key = null; g.set(key, items); return; }
         g.items = items.slice();
         var shownTiles = g.node.querySelectorAll(".gtile");
-        for (var i = 0; i < g.shown; i++) if (!!before[i].pending !== !!items[i].pending) refillTile(g, shownTiles[i], i);
+        for (var i = 0; i < g.shown; i++) {
+          if (!!before[i].pending !== !!items[i].pending) refillTile(g, shownTiles[i], i);
+          else if (!items[i].pending && (before[i].picture || "") !== (items[i].picture || "")) swapPicture(g, shownTiles[i], items[i]);
+        }
         // The list had ended on screen (a short last page): what joins it shows at once, in that block.
         if (g.shown % GALLERY_PAGE !== 0) revealPage(g);
       }
@@ -86,6 +91,19 @@ export const SLATE_UI_INSPIRATION_GALLERY = String.raw `
     if (img && freshImg && img.sizes) freshImg.sizes = img.sizes;
     tile.parentNode.replaceChild(fresh, tile);
   }
+  // A tile's new picture (a site's settled frame) is set on the picture already shown: the browser keeps showing the
+  // old one until the new one has loaded, so the tile never shows an empty frame. The large view, when it shows this
+  // item, swaps its picture the same way.
+  function swapPicture(g, tile, item) {
+    var img = tile && tile.querySelector("img.thumb");
+    if (!img) return;
+    if (item.thumbUrl) img.src = item.thumbUrl;
+    else if (item.load) item.load(img, "thumb");
+    if (item.imageUrl && item.imageUrl !== item.thumbUrl) img.setAttribute("data-large", item.imageUrl);
+    if (!largeView || largeView.g !== g || largeView.shownId !== item.id) return;
+    if (item.imageUrl) largeView.els.img.src = item.imageUrl;
+    else if (item.load) item.load(largeView.els.img, "ref");
+  }
   // The next page of the list as one collage block, before the end marker; a short last block is topped up first, so
   // sites arriving one by one fill its rows instead of stacking short blocks. Returns whether anything was added.
   function revealPage(g) {

package/dist/mcp-slate-ui-script-inspiration-gallery.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-inspiration-gallery.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-inspiration-gallery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4OrD,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-inspiration-gallery.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-inspiration-gallery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4PrD,CAAC"}

package/dist/mcp-slate-ui-script-loading.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The loading surface keeps one clock. Every loading tile is a window onto one wave fixed to the frame
+ * (mcp-slate-ui-styles-loading.ts), but a CSS animation counts from when its element appeared: a tile built later (a
+ * picture landed and the grid was rebuilt, a reference placeholder arrived) would start its pass over and break the
+ * wave at its edges. So each loading animation, as it starts, is set onto the document's clock (start time 0), and
+ * every tile on screen shows the same moment of the same pass.
+ *
+ * Fragment of the view's script; String.raw, no backtick, no dollar-brace.
+ */
+export declare const SLATE_UI_LOADING: string;
+//# sourceMappingURL=mcp-slate-ui-script-loading.d.ts.map

package/dist/mcp-slate-ui-script-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slate-ui-script-loading.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-loading.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,QAQ5B,CAAC"}

package/dist/mcp-slate-ui-script-loading.js

@@ -0,0 +1,19 @@
+/**
+ * The loading surface keeps one clock. Every loading tile is a window onto one wave fixed to the frame
+ * (mcp-slate-ui-styles-loading.ts), but a CSS animation counts from when its element appeared: a tile built later (a
+ * picture landed and the grid was rebuilt, a reference placeholder arrived) would start its pass over and break the
+ * wave at its edges. So each loading animation, as it starts, is set onto the document's clock (start time 0), and
+ * every tile on screen shows the same moment of the same pass.
+ *
+ * Fragment of the view's script; String.raw, no backtick, no dollar-brace.
+ */
+export const SLATE_UI_LOADING = String.raw `
+  // ---- the loading surface keeps the frame's clock ----
+  document.addEventListener("animationstart", function (e) {
+    if (String(e.animationName).indexOf("dotwave") !== 0 || !e.target || !e.target.getAnimations) return;
+    e.target.getAnimations({ subtree: true }).forEach(function (a) {
+      if (String(a.animationName).indexOf("dotwave") === 0 && a.startTime !== 0) a.startTime = 0;
+    });
+  }, true);
+`;
+//# sourceMappingURL=mcp-slate-ui-script-loading.js.map

package/dist/mcp-slate-ui-script-loading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slate-ui-script-loading.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-loading.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;CAQzC,CAAC"}

package/dist/mcp-slate-ui-script-references.d.ts

@@ -12,8 +12,13 @@
  * - The large view adds Open site, which opens the live page through the host.
  * - Pictures load straight from their URLs (`imageUrl`, `thumbUrl`); where a server gives none (the local plugin) they
  *   come through the reference tool like any reference.
- * - Nothing yet: one short line, "Finding sites…" only while gathering is possible (the gather window is open and a
- *   runner or the draw command holds a running round), else "No websites".
+ * - A site's settled frame may replace its first picture later (`thumbUrl` changes, or the local plugin's
+ *   `pictureVersion`): the tile keeps its place and its picture, which swaps in place once the new one has loaded. The
+ *   tab's own watch keeps asking while the local host gathers, so a settled frame that lands after the twelfth site
+ *   still reaches its tile.
+ * - Nothing yet: one short line, "Finding sites…" while the screen's own host says it is gathering (`gatheringSites`,
+ *   the local plugin) or gathering is possible (the gather window is open and a runner or the draw command holds a
+ *   running round), else "No websites".
  *
  * Fragment of the view's script; String.raw, no backtick, no dollar-brace.
  */

package/dist/mcp-slate-ui-script-references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-references.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,QAiH/B,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-references.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,QAuH/B,CAAC"}

package/dist/mcp-slate-ui-script-references.js

@@ -12,27 +12,37 @@
  * - The large view adds Open site, which opens the live page through the host.
  * - Pictures load straight from their URLs (`imageUrl`, `thumbUrl`); where a server gives none (the local plugin) they
  *   come through the reference tool like any reference.
- * - Nothing yet: one short line, "Finding sites…" only while gathering is possible (the gather window is open and a
- *   runner or the draw command holds a running round), else "No websites".
+ * - A site's settled frame may replace its first picture later (`thumbUrl` changes, or the local plugin's
+ *   `pictureVersion`): the tile keeps its place and its picture, which swaps in place once the new one has loaded. The
+ *   tab's own watch keeps asking while the local host gathers, so a settled frame that lands after the twelfth site
+ *   still reaches its tile.
+ * - Nothing yet: one short line, "Finding sites…" while the screen's own host says it is gathering (`gatheringSites`,
+ *   the local plugin) or gathering is possible (the gather window is open and a runner or the draw command holds a
+ *   running round), else "No websites".
  *
  * Fragment of the view's script; String.raw, no backtick, no dollar-brace.
  */
 export const SLATE_UI_REFERENCES = String.raw `
   // While the tab is open and the sites are still landing, it asks for the view every few seconds by itself (the
   // status poll runs only while a request runs, and the local plugin gathers with none), for a few minutes at most.
+  // A dozen sites ends the watch only once the host no longer says it gathers: until then a site's settled frame may
+  // still replace its early one.
   var SITES_EXPECTED = 12;
   var SITE_WATCH = { forMs: 300000, everyMs: 3000 };
   var siteWatch = { runDir: null, until: 0, timer: null };
   function armSiteWatch() {
     if (state.view && state.view.runDir && siteWatch.runDir !== state.view.runDir) { siteWatch.runDir = state.view.runDir; siteWatch.until = Date.now() + SITE_WATCH.forMs; }
   }
+  // The screen's own host says it is gathering (the local plugin), until the gather ends.
+  function gatheringSites() { return !!(state.view && state.view.gatheringSites); }
   // Gathering is possible only while the gather window is open and a runner or the draw command holds a running round.
   function stillFinding() {
-    return Date.now() < siteWatch.until && runningOps().some(function (op) { return !!(op.runner && op.runner.alive); });
+    return gatheringSites() || (Date.now() < siteWatch.until && runningOps().some(function (op) { return !!(op.runner && op.runner.alive); }));
   }
   function watchSites() {
     if (siteWatch.timer !== null || !state.view || !state.view.runDir) return;
-    if (state.tab !== "references" || siteList().length >= SITES_EXPECTED || Date.now() > siteWatch.until || runningOps().length > 0) return;
+    var allLanded = siteList().length >= SITES_EXPECTED && !gatheringSites();
+    if (state.tab !== "references" || allLanded || (Date.now() > siteWatch.until && !gatheringSites()) || runningOps().length > 0) return;
     siteWatch.timer = setTimeout(function () { siteWatch.timer = null; refreshOnce(); watchSites(); }, SITE_WATCH.everyMs);
   }
 
@@ -65,7 +75,8 @@ export const SLATE_UI_REFERENCES = String.raw `
   // A site as the gallery shows it.
   function siteItem(site) {
     var item = { id: site.id, label: site.title + " (" + siteDomain(site) + ")", title: site.title, sourceUrl: site.sourceUrl, domain: siteDomain(site),
-      aspect: "landscape", width: 1600, height: 1000, thumbUrl: site.thumbUrl || null, imageUrl: site.imageUrl || site.thumbUrl || null, srcset: "" };
+      aspect: "landscape", width: 1600, height: 1000, thumbUrl: site.thumbUrl || null, imageUrl: site.imageUrl || site.thumbUrl || null, srcset: "",
+      picture: (site.thumbUrl || "") + "#" + (site.pictureVersion || 0) };
     if (!item.thumbUrl) item.load = function (img, size) { fillImage(img, wantReference(site.id, size === "thumb" ? "thumb" : "ref", false)); };
     return item;
   }

package/dist/mcp-slate-ui-script-references.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-references.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiH5C,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-references.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuH5C,CAAC"}

package/dist/mcp-slate-ui-script-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-state.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QA8T1B,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-state.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QAgU1B,CAAC"}

package/dist/mcp-slate-ui-script-state.js

@@ -188,7 +188,9 @@ export const SLATE_UI_STATE = String.raw `
     var site = siteById(id);
     var url = site && (size === "thumb" ? site.thumbUrl : site.imageUrl);
     if (url) return Promise.resolve(url);
-    return enqueue("ref:" + size + ":" + id, state.refs, TOOLS.reference, { runDir: state.view.runDir, referenceId: id, size: size }, urgent);
+    // A site's replaced screenshot is a new picture under the same id.
+    var version = site && site.pictureVersion ? ":" + site.pictureVersion : "";
+    return enqueue("ref:" + size + ":" + id + version, state.refs, TOOLS.reference, { runDir: state.view.runDir, referenceId: id, size: size }, urgent);
   }
   function pump() {
     while (visible() && loader.active < loader.max && loader.queue.length > 0) {

package/dist/mcp-slate-ui-script-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script-state.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8TvC,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script-state.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgUvC,CAAC"}

package/dist/mcp-slate-ui-script.d.ts

@@ -2,7 +2,7 @@
  * The workspace view's script, assembled from single-purpose fragments that
  * share one scope: bridge (host protocol), state (view state, picture queue,
  * polling, what the ops say), l10n (the person's language and every word, `t(key)`), inline (the card), select (Select), inspiration (the tabs and the Inspiration tab), stage
- * (fullscreen), pause (the inspiration pause of the hosted server), edit (what the large view's Edit sends), more (the Generate more tile and its panel), scribble (the drawing layer of Edit), the hosted and browser targets' words, then the handshake, last, so every function and
+ * (fullscreen), pause (the inspiration pause of the hosted server), edit (what the large view's Edit sends), more (the Generate more tile and its panel), scribble (the drawing layer of Edit), the hosted and browser targets' words, the hover peek, the loading surface's clock, then the handshake, last, so every function and
  * variable exists before the first message can arrive. The tool names come
  * from the view contract (SLATE_UI_TOOLS), not from the server's own module.
  *

package/dist/mcp-slate-ui-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AA2B3D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,aAAa,KAAG,MAyB/C,CAAC;AAEb,eAAO,MAAM,eAAe,QAA8B,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-script.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AA2B3D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,aAAa,KAAG,MA0B/C,CAAC;AAEb,eAAO,MAAM,eAAe,QAA8B,CAAC"}

package/dist/mcp-slate-ui-script.js

@@ -8,6 +8,7 @@ import { SLATE_UI_DESIGNS } from './mcp-slate-ui-script-designs.js';
 import { SLATE_UI_EDIT } from './mcp-slate-ui-script-edit.js';
 import { SLATE_UI_INLINE } from './mcp-slate-ui-script-inline.js';
 import { SLATE_UI_INSPIRATION } from './mcp-slate-ui-script-inspiration.js';
+import { SLATE_UI_LOADING } from './mcp-slate-ui-script-loading.js';
 import { buildSlateUiL10n } from './mcp-slate-ui-script-l10n.js';
 import { SLATE_UI_MORE } from './mcp-slate-ui-script-more.js';
 import { SLATE_UI_PEEK } from './mcp-slate-ui-script-peek.js';
@@ -70,6 +71,7 @@ export const buildSlateUiScript = (target) => [
     SLATE_UI_REMOTE,
     SLATE_UI_BROWSER,
     SLATE_UI_PEEK,
+    SLATE_UI_LOADING,
     HANDSHAKE,
     '})();',
 ].join('\n');

package/dist/mcp-slate-ui-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-slate-ui-script.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAsBlE;;;GAGG;AACH,MAAM,cAAc,GAAG,GAA2C,EAAE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC;IAC3F,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClF,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;KACxF,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;CAY3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAqB,EAAU,EAAE,CAAC;IACnE,eAAe;IACf,gBAAgB;IAChB,eAAe;SACZ,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;SAC1D,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtD,cAAc;IACd,gBAAgB,CAAC,cAAc,EAAE,CAAC;IAClC,eAAe;IACf,eAAe;IACf,oBAAoB;IACpB,mBAAmB;IACnB,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,iBAAiB;IACxD,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,cAAc;IACd,aAAa,CAAC,OAAO,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;IACrG,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC1E,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,SAAS;IACT,OAAO;CACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC"}
+{"version":3,"file":"mcp-slate-ui-script.js","sourceRoot":"","sources":["../src/mcp-slate-ui-script.ts"],"names":[],"mappings":"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"}

package/dist/mcp-slate-ui-styles-loading-effects.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What plays across the loading surface's dots (mcp-slate-ui-styles-loading.ts picks one with LOADING_EFFECT). Each is
+ * a background painted under the dot mask, fixed to the frame so every loading tile is a window onto the same field,
+ * and each keyframe loop ends exactly where it starts, so every pass is identical.
+ *
+ * The dots' own ink is `--dot` (dim, at rest), `--dot-mid` and `--dot-hi` (the crest); the colour effects mix the host's
+ * accent (`--ring`) toward two neighbouring hues in oklch, so they follow the person's Codex accent and theme.
+ *
+ * Every animation name starts with `dotwave`: the script keeps all of them on the frame's clock
+ * (mcp-slate-ui-script-loading.ts), so a tile built later joins the wave in step.
+ */
+export type LoadingEffect = 'shimmer' | 'ripple' | 'hue' | 'aurora' | 'fireflies';
+export declare const LOADING_EFFECTS: Record<LoadingEffect, string>;
+//# sourceMappingURL=mcp-slate-ui-styles-loading-effects.d.ts.map

package/dist/mcp-slate-ui-styles-loading-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slate-ui-styles-loading-effects.d.ts","sourceRoot":"","sources":["../src/mcp-slate-ui-styles-loading-effects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAelF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CA0DzD,CAAC"}

package/dist/mcp-slate-ui-styles-loading-effects.js

@@ -0,0 +1,67 @@
+const SEL = 'img.shimmer, .shimmer:not(img)::before';
+/**
+ * The band effects' geometry. The gradient is one picture 360% of the frame, larger than the frame at every keyframe,
+ * so the frame never sees two copies of it: a picture smaller than its travel tiles, and a slanted band does not meet
+ * itself across the seam between tiles (the cut-off second pass, evidence 12ui/loading-dots). The band's stops sit
+ * close to the middle so it is as wide on screen as before; from -205 to -42 it starts and ends just off the frame.
+ */
+const BAND = String.raw `
+    background-size: 360vw 360vh;
+    background-repeat: no-repeat;`;
+const BAND_KEYFRAMES = (name) => `@keyframes ${name} { from { background-position: -205vw -205vh; } to { background-position: -42vw -42vh; } }`;
+export const LOADING_EFFECTS = {
+    // A soft crest of brighter ink with a faint echo behind it, travelling diagonally.
+    shimmer: String.raw `
+  ${SEL} {
+    background-image: linear-gradient(118deg, var(--dot) 41.1%, var(--dot-mid) 43.9%, var(--dot) 45.8%, var(--dot-mid) 47.5%, var(--dot-hi) 50%, var(--dot-mid) 52.2%, var(--dot) 55%);${BAND}
+    animation: dotwave 2.4s cubic-bezier(.45, .05, .55, .95) infinite;
+  }
+  ${BAND_KEYFRAMES('dotwave')}`,
+    // Rings spreading from the middle of the frame like water, a sharp front and a soft wake; one ring spacing per loop.
+    ripple: String.raw `
+  @property --dotwave-r { syntax: "<length>"; inherits: false; initial-value: 0px; }
+  ${SEL} {
+    background-image: repeating-radial-gradient(circle at 50% 50%, var(--dot) var(--dotwave-r), var(--dot) calc(var(--dotwave-r) + 64px), var(--dot-mid) calc(var(--dotwave-r) + 128px), var(--dot-hi) calc(var(--dotwave-r) + 158px), var(--dot) calc(var(--dotwave-r) + 176px), var(--dot) calc(var(--dotwave-r) + 210px));
+    animation: dotwave-ripple 2.6s linear infinite;
+  }
+  @keyframes dotwave-ripple { from { --dotwave-r: 0px; } to { --dotwave-r: 210px; } }`,
+    // The shimmer's crest in colour: the accent, flanked by its two neighbouring hues.
+    hue: String.raw `
+  ${SEL} {
+    --hue-a: color-mix(in oklch, var(--ring) 55%, #19c3c0);
+    --hue-b: color-mix(in oklch, var(--ring) 55%, #d24dff);
+    background-image: linear-gradient(118deg, var(--dot) 40%, color-mix(in srgb, var(--hue-a) 30%, transparent) 43.5%, color-mix(in srgb, var(--hue-a) 70%, transparent) 46.5%, var(--ring) 50%, color-mix(in srgb, var(--hue-b) 70%, transparent) 53%, color-mix(in srgb, var(--hue-b) 30%, transparent) 55.5%, var(--dot) 58%);${BAND}
+    animation: dotwave-hue 2.8s cubic-bezier(.45, .05, .55, .95) infinite;
+  }
+  ${BAND_KEYFRAMES('dotwave-hue')}`,
+    // Slow drifting glows in the accent's hues behind the dim ink, wandering and returning (alternate), never looping.
+    aurora: String.raw `
+  ${SEL} {
+    --aur-a: color-mix(in srgb, color-mix(in oklch, var(--ring) 60%, #19c3c0) 62%, transparent);
+    --aur-b: color-mix(in srgb, color-mix(in oklch, var(--ring) 55%, #d24dff) 58%, transparent);
+    --aur-c: color-mix(in srgb, var(--ring) 55%, transparent);
+    background-color: var(--dot);
+    background-image: radial-gradient(closest-side, var(--aur-a), transparent), radial-gradient(closest-side, var(--aur-b), transparent), radial-gradient(closest-side, var(--aur-c), transparent);
+    background-size: 90vw 70vh, 80vw 90vh, 70vw 60vh;
+    background-repeat: no-repeat;
+    animation: dotwave-aurora 7s ease-in-out infinite alternate;
+  }
+  @keyframes dotwave-aurora {
+    0% { background-position: -30vw -20vh, 60vw 40vh, 10vw 70vh; }
+    50% { background-position: 30vw 30vh, 0vw -20vh, 60vw 10vh; }
+    100% { background-position: 50vw -10vh, -20vw 50vh, 40vw 60vh; }
+  }`,
+    // Soft glints drifting through the dots on two crossing paths, one of them in the accent, like fireflies.
+    fireflies: String.raw `
+  ${SEL} {
+    --fly-a: color-mix(in srgb, var(--text) 50%, transparent);
+    --fly-b: color-mix(in srgb, var(--ring) 70%, transparent);
+    background-color: var(--dot);
+    background-image: radial-gradient(circle, var(--fly-a), transparent 26px), radial-gradient(circle, var(--fly-b), transparent 32px), radial-gradient(circle, var(--dot-mid), transparent 44px);
+    background-size: 157px 139px, 233px 211px, 307px 277px;
+    background-position: 0 0, 0 0, 0 0;
+    animation: dotwave-fireflies 7s linear infinite;
+  }
+  @keyframes dotwave-fireflies { to { background-position: 157px 139px, -233px 211px, 307px -277px; } }`,
+};
+//# sourceMappingURL=mcp-slate-ui-styles-loading-effects.js.map

package/dist/mcp-slate-ui-styles-loading-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slate-ui-styles-loading-effects.js","sourceRoot":"","sources":["../src/mcp-slate-ui-styles-loading-effects.ts"],"names":[],"mappings":"AAaA,MAAM,GAAG,GAAG,wCAAwC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAA;;kCAEW,CAAC;AACnC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,IAAI,4FAA4F,CAAC;AAExJ,MAAM,CAAC,MAAM,eAAe,GAAkC;IAC5D,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC,GAAG,CAAA;IACjB,GAAG;yLACkL,IAAI;;;IAGzL,cAAc,CAAC,SAAS,CAAC,EAAE;IAE7B,qHAAqH;IACrH,MAAM,EAAE,MAAM,CAAC,GAAG,CAAA;;IAEhB,GAAG;;;;sFAI+E;IAEpF,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA;IACb,GAAG;;;mUAG4T,IAAI;;;IAGnU,cAAc,CAAC,aAAa,CAAC,EAAE;IAEjC,mHAAmH;IACnH,MAAM,EAAE,MAAM,CAAC,GAAG,CAAA;IAChB,GAAG;;;;;;;;;;;;;;IAcH;IAEF,0GAA0G;IAC1G,SAAS,EAAE,MAAM,CAAC,GAAG,CAAA;IACnB,GAAG;;;;;;;;;wGASiG;CACvG,CAAC"}