@legionworks/facet 1.10.0 → 1.10.2

package/dist/gallery/{chunk-48emrxg6.js → chunk-0by8qn4x.js}

@@ -40,6 +40,9 @@ function buildFrameAttributes(src = "/gallery/frame") {
     src
   };
 }
+function usesArtifactStylesheet(artifactType) {
+  return artifactType === "html" || artifactType === "tsx";
+}
 function isLoopbackHostname(hostname) {
   return hostname === "127.0.0.1";
 }
@@ -5190,6 +5193,13 @@ function createArtifactFrame(options) {
       renderResult = handle;
       return handle;
     },
+    setTheme(theme) {
+      const api = raw.contentWindow?.__facetFrame;
+      if (api === null || api === undefined || typeof api.setTheme !== "function") {
+        throw new Error("frame theme API unavailable");
+      }
+      api.setTheme(theme);
+    },
     get renderResult() {
       return renderResult;
     }
@@ -5782,6 +5792,11 @@ async function startGallery(runtime = browserGalleryRuntime()) {
     const canCommit = () => themeGeneration === generation && nextMode === requestedThemeMode;
     if (!canCommit())
       return;
+    if (usesArtifactStylesheet(source.artifactType)) {
+      current.setTheme(nextResolvedTheme);
+      commitTheme(nextMode, nextResolvedTheme);
+      return;
+    }
     const next = createArtifactFrame({
       artifactType: source.artifactType,
       renderer: source.renderer,

package/dist/gallery/frame/artifact.css

@@ -5256,6 +5256,9 @@
   .mx-16 {
     margin-inline: calc(var(--spacing) * 16);
   }
+  .mx-auto {
+    margin-inline: auto;
+  }
   .my-0 {
     margin-block: 0px;
   }

package/dist/gallery/frame/chunks/{markdown-zazx9h4n.js → markdown-31ee7zgx.js}

@@ -1,7 +1,7 @@
 import {
   FacetRenderError,
   decodeArtifactBytes
-} from "./markdown-d1wfbs70.js";
+} from "./markdown-n9xcxy80.js";
 
 // src/gallery-web/frame/renderers/svg.ts
 var STRIPPED_TAGS = new Set([

package/dist/gallery/frame/chunks/{markdown-fvfncadf.js → markdown-7scxp44j.js}

@@ -5,12 +5,15 @@ import {
   dispatchRender,
   isRenderer,
   isTsxExecutionMode
-} from "./markdown-d1wfbs70.js";
+} from "./markdown-n9xcxy80.js";
 
 // src/gallery-web/theme.ts
 function isResolvedGalleryTheme(value) {
   return value === "dark" || value === "light";
 }
+function galleryDataTheme(theme) {
+  return theme === "light" ? "winter" : "night";
+}
 
 // src/gallery-web/frame/renderer-validation.ts
 function validateRenderer(value) {
@@ -395,6 +398,11 @@ function installGalleryFrameApi(registry) {
     setPointerEventsForAllChildren(container, mode === "panzoom" ? "none" : "");
   };
   const api = {
+    setTheme(theme) {
+      if (!isResolvedGalleryTheme(theme))
+        throw new FacetRenderError("frame theme is invalid", "invalid_request");
+      document.documentElement.dataset.theme = galleryDataTheme(theme);
+    },
     async render(payload) {
       if (rendered)
         throw new FacetRenderError("frame already rendered", "invalid_request");

package/dist/gallery/frame/chunks/{markdown-z1wc0v0d.js → markdown-mksxbxx8.js}

@@ -10,11 +10,11 @@ import {
 } from "./markdown-h7pzv34e.js";
 import {
   importSanitizedSvgText
-} from "./markdown-zazx9h4n.js";
+} from "./markdown-31ee7zgx.js";
 import {
   FacetRenderError,
   decodeArtifactBytes
-} from "./markdown-d1wfbs70.js";
+} from "./markdown-n9xcxy80.js";
 import {
   dedent
 } from "./markdown-qx3cngz2.js";

package/dist/gallery/frame/chunks/{markdown-d1wfbs70.js → markdown-n9xcxy80.js}

@@ -51,6 +51,15 @@ function isHtmlEventHandlerAttribute(name) {
 function isHtmlInlineStyleAttribute(name) {
   return name.toLowerCase() === "style";
 }
+function isExternalHttpsImageSource(src) {
+  if (typeof src !== "string")
+    return false;
+  try {
+    return new URL(src).protocol === "https:";
+  } catch {
+    return false;
+  }
+}
 function isAllowedHtmlUrl(elementName, attributeName, value) {
   const element = htmlUrlBearingElement(elementName);
   if (element === null || !isHtmlUrlBearingAttribute(element, attributeName))
@@ -177,7 +186,8 @@ function countPageShim() {
   const graphRoots = roots.filter((root) => root.getAttribute(RENDERER_GRAPH_ATTRIBUTE) === "true");
   const allMarkedCandidates = safeSelectorElements(MARKED_ROOT_SELECTOR);
   const markedSet = new Set(allMarkedCandidates);
-  const htmlRoots = allMarkedCandidates.filter((root) => root.nodeName.toLowerCase() !== "svg" && !hasMarkedRootAncestor(root, markedSet));
+  const contentRoots = allMarkedCandidates.filter((root) => root.nodeName.toLowerCase() !== "svg" && !hasMarkedRootAncestor(root, markedSet));
+  const htmlRoots = contentRoots.filter((root) => root.getAttribute("data-facet-renderer-kind") !== "markdown");
   const html = htmlRoots.length === 0 ? undefined : {
     rendererRootCount: htmlRoots.length,
     headingCount: 0,
@@ -193,24 +203,19 @@ function countPageShim() {
     html.listCount += safeSelectorElementsWithin(root, HTML_STRUCTURAL_GROUPS.lists.join(",")).length;
     const images = safeSelectorElementsWithin(root, HTML_STRUCTURAL_GROUPS.images.join(","));
     html.imageCount += images.length;
-    html.externalImageCount += images.filter((image) => {
-      try {
-        return new URL(image.getAttribute("src") ?? "").protocol === "https:";
-      } catch {
-        return false;
-      }
-    }).length;
+    html.externalImageCount += images.filter((image) => isExternalHttpsImageSource(image.getAttribute("src"))).length;
     html.canvasCount += safeSelectorElementsWithin(root, HTML_STRUCTURAL_GROUPS.canvases.join(",")).length;
   }
   const mermaidNodeCount = graphRoots.reduce((count, root) => count + safeSelectorElementsWithin(root, "g.node").length, 0);
   const opaqueRegionCount = safeSelectorElements("*").filter((element) => element.nodeName.toLowerCase() === "canvas").length;
+  const externalImageCount = contentRoots.reduce((count, root) => count + safeSelectorElementsWithin(root, HTML_STRUCTURAL_GROUPS.images.join(",")).filter((image) => isExternalHttpsImageSource(image.getAttribute("src"))).length, 0);
   return {
     rendererRootSvgCount: roots.length,
     graphCount: graphRoots.length,
     mermaidNodeCount,
     visibleSvgCount: roots.filter(nonDegenerateViewBox).length,
     opaqueRegionCount,
-    externalImageCount: html?.externalImageCount ?? 0,
+    externalImageCount,
     errorCount: safeSelectorElements("[data-facet-error]").length,
     ...html === undefined ? {} : { html }
   };

package/dist/gallery/frame/chunks/{markdown-rd8w0ng9.js → markdown-rkt612xp.js}

@@ -6,7 +6,7 @@ import {
   isHtmlInlineStyleAttribute,
   isHtmlUrlAttributeName,
   isHtmlUrlBearingAttribute
-} from "./markdown-d1wfbs70.js";
+} from "./markdown-n9xcxy80.js";
 
 // src/gallery-web/frame/renderers/html.ts
 function shouldKeepAttribute(elementName, name, value) {

package/dist/gallery/frame/chunks/{mermaid-de7p4v0x.js → mermaid-b8fxhsgg.js}

@@ -2,12 +2,12 @@ import {
   mermaidInitializeConfig,
   renderMermaidDocument,
   renderMermaidInto
-} from "./markdown-z1wc0v0d.js";
+} from "./markdown-mksxbxx8.js";
 import"./markdown-6zz8efx2.js";
 import"./markdown-rm2yxfjj.js";
 import"./markdown-h7pzv34e.js";
-import"./markdown-zazx9h4n.js";
-import"./markdown-d1wfbs70.js";
+import"./markdown-31ee7zgx.js";
+import"./markdown-n9xcxy80.js";
 import"./markdown-s1jatrnk.js";
 import"./markdown-m7frq8x8.js";
 import"./markdown-tvdpppw8.js";

package/dist/gallery/frame/frame.css

@@ -78,26 +78,7 @@ body {
   padding-inline: max(16px, calc((100% - 92ch) / 2));
 }
 
-/*
- * Native dashboard artifacts (html, interactive tsx) read top-down
- * like markdown — vertical stays start-aligned — but unlike markdown
- * their width is whatever the fixture authored (often a fixed-width
- * `max-w-*` container), not a fluid readable column. Left unstyled,
- * that narrow content sits pinned to the container's left edge,
- * stranding most of a wide desktop stage as dead space.
- *
- * The centering has to land on the renderer-ROOT element
- * (`.facet-html-root` / `#facet-tsx-mount`), not `#artifact` itself:
- * `renderHtml`/`renderTsx` always mount a single full-width wrapper
- * as `#artifact`'s only child, and the fixture's own narrow content
- * (e.g. `<main class="max-w-2xl">`) is a GRANDCHILD of `#artifact`
- * inside that wrapper — centering `#artifact`'s single full-width
- * child does nothing. `safe center` on the horizontal axis only —
- * the same fallback-to-start mechanism the standalone-diagram rule
- * above uses — centers content that fits and never clips content
- * wider than the stage (it start-aligns and stays reachable by
- * scroll instead).
- */
+/* These selectors match usesArtifactStylesheet in frame-html.ts; CSS cannot import it. */
 #artifact[data-facet-artifact-type="html"],
 #artifact[data-facet-artifact-type="tsx"] {
   display: flex;
@@ -106,10 +87,9 @@ body {
 
 #artifact[data-facet-artifact-type="html"] > [data-facet-renderer-root],
 #artifact[data-facet-artifact-type="tsx"] > [data-facet-renderer-root] {
-  display: flex;
-  justify-content: safe center;
-  align-items: flex-start;
-  /* A full-height root plus a sibling runtime error makes capture bounds grow on every viewport resize. */
+  /* Block flow preserves authored sibling order while keeping the renderer root a flex item of the stage. */
+  display: block;
+  /* Filling the stage keeps a sibling runtime-error line outside capture bounds as the viewport resizes. */
   flex: 1 0 auto;
 }
 

package/dist/gallery/frame/runtime/chart.js

@@ -1,14 +1,14 @@
 import {
   importSanitizedSvgText
-} from "../chunks/markdown-zazx9h4n.js";
+} from "../chunks/markdown-31ee7zgx.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   FacetRenderError,
   createRendererRegistry,
   decodeArtifactBytes
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import {
   Accent_default,
   Dark2_default,

package/dist/gallery/frame/runtime/html.js

@@ -1,12 +1,12 @@
 import {
   renderHtml
-} from "../chunks/markdown-rd8w0ng9.js";
+} from "../chunks/markdown-rkt612xp.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   createRendererRegistry
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import"../chunks/markdown-809k7q41.js";
 
 // src/gallery-web/frame/entries/html.ts

package/dist/gallery/frame/runtime/markdown.js

@@ -1,10 +1,10 @@
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   createRendererRegistry,
   decodeArtifactBytes
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import {
   __require
 } from "../chunks/markdown-809k7q41.js";
@@ -1380,7 +1380,7 @@ async function renderMarkdown(ctx, bytes) {
   const template = document.createElement("template");
   template.innerHTML = html;
   const mermaidBlocks = Array.from(template.content.querySelectorAll("pre > code.language-mermaid"));
-  const renderMermaidInto = mermaidBlocks.length === 0 ? null : (await import("../chunks/mermaid-de7p4v0x.js")).renderMermaidInto;
+  const renderMermaidInto = mermaidBlocks.length === 0 ? null : (await import("../chunks/mermaid-b8fxhsgg.js")).renderMermaidInto;
   for (const code of mermaidBlocks) {
     const source = code.textContent ?? "";
     const pre = code.parentElement;
@@ -1395,7 +1395,11 @@ async function renderMarkdown(ctx, bytes) {
     else
       pre.remove();
   }
-  ctx.container.appendChild(template.content);
+  const root = document.createElement("div");
+  root.setAttribute("data-facet-renderer-root", "true");
+  root.setAttribute("data-facet-renderer-kind", "markdown");
+  root.appendChild(template.content);
+  ctx.container.appendChild(root);
 }
 
 // src/gallery-web/frame/entries/markdown.ts

package/dist/gallery/frame/runtime/mermaid.js

@@ -1,16 +1,16 @@
 import {
   renderMermaidDocument
-} from "../chunks/markdown-z1wc0v0d.js";
+} from "../chunks/markdown-mksxbxx8.js";
 import"../chunks/markdown-6zz8efx2.js";
 import"../chunks/markdown-rm2yxfjj.js";
 import"../chunks/markdown-h7pzv34e.js";
-import"../chunks/markdown-zazx9h4n.js";
+import"../chunks/markdown-31ee7zgx.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   createRendererRegistry
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import"../chunks/markdown-s1jatrnk.js";
 import"../chunks/markdown-m7frq8x8.js";
 import"../chunks/markdown-tvdpppw8.js";

package/dist/gallery/frame/runtime/svg.js

@@ -1,12 +1,12 @@
 import {
   renderSvgDocument
-} from "../chunks/markdown-zazx9h4n.js";
+} from "../chunks/markdown-31ee7zgx.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   createRendererRegistry
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import"../chunks/markdown-809k7q41.js";
 
 // src/gallery-web/frame/entries/svg.ts

package/dist/gallery/frame/runtime/tsx.js

@@ -1,14 +1,14 @@
 import {
   renderHtml
-} from "../chunks/markdown-rd8w0ng9.js";
+} from "../chunks/markdown-rkt612xp.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-7scxp44j.js";
 import {
   RENDER_ERROR_ATTRIBUTE,
   appendRenderError,
   createRendererRegistry
-} from "../chunks/markdown-d1wfbs70.js";
+} from "../chunks/markdown-n9xcxy80.js";
 import"../chunks/markdown-809k7q41.js";
 
 // src/gallery-web/frame/renderers/tsx.ts

package/dist/gallery/index.html

@@ -8,7 +8,7 @@
     
     
     
-  <link rel="stylesheet" crossorigin href="./chunk-2dge4gwb.css"><script type="module" crossorigin src="./chunk-48emrxg6.js"></script></head>
+  <link rel="stylesheet" crossorigin href="./chunk-2dge4gwb.css"><script type="module" crossorigin src="./chunk-0by8qn4x.js"></script></head>
   <body>
     <div id="facet-shell">
       <header id="facet-status">

package/docs/reference/cli.md

@@ -125,7 +125,7 @@ errors and next actions:
 | code                   | next action                                                                                                    |
 | ---------------------- | -------------------------------------------------------------------------------------------------------------- |
 | `artifact_not_found`   | Check the artifact ID and list the project.                                                                    |
-| `revision_not_found`   | Omit the SHA for latest read-back or use an existing SHA.                                                      |
+| `revision_not_found`   | Check that the artifact has a revision; omit the SHA for latest or use an existing SHA.                        |
 | `duplicate_revision`   | Reuse `error.details.revisionSha`; no new revision was stored.                                                 |
 | `output_unwritable`    | Fix the output directory, permissions, or rename target.                                                       |
 | `evidence_unavailable` | Run Tier 1 again or inspect retention and evidence paths.                                                      |

package/docs/reference/html.md

@@ -142,15 +142,15 @@ an included Tailwind utility outside this list can still render.
 
 ### Recommended Tailwind utilities
 
-`block`, `flex`, `grid`, `inline-flex`, `flex-col`, `flex-wrap`, `items-center`, `justify-between`, `justify-center`, `grid-cols-1`, `grid-cols-2`, `grid-cols-3`, `gap-2`, `gap-3`, `gap-4`, `gap-6`, `p-2`, `p-3`, `p-4`, `p-6`, `px-3`, `px-4`, `py-2`, `py-3`, `m-0`, `mt-2`, `mt-4`, `mb-2`, `mb-4`, `w-full`, `max-w-prose`, `max-w-2xl`, `text-xs`, `text-sm`, `text-base`, `text-lg`, `text-xl`, `text-2xl`, `font-medium`, `font-semibold`, `font-bold`, `leading-relaxed`, `text-left`, `text-center`, `text-right`, `text-legion-ink`, `text-legion-muted`, `text-legion-cyan`, `bg-legion-paper`, `bg-legion-ink`, `bg-legion-cyan`, `border`, `border-2`, `border-legion-line`, `rounded`, `rounded-box`, `overflow-x-auto`, `table`, `table-zebra`.
+`block`, `flex`, `grid`, `inline-flex`, `flex-col`, `flex-wrap`, `items-center`, `justify-between`, `justify-center`, `grid-cols-1`, `grid-cols-2`, `grid-cols-3`, `gap-2`, `gap-3`, `gap-4`, `gap-6`, `p-2`, `p-3`, `p-4`, `p-6`, `px-3`, `px-4`, `py-2`, `py-3`, `m-0`, `mt-2`, `mt-4`, `mb-2`, `mb-4`, `mx-auto`, `w-full`, `max-w-prose`, `max-w-2xl`, `text-xs`, `text-sm`, `text-base`, `text-lg`, `text-xl`, `text-2xl`, `font-medium`, `font-semibold`, `font-bold`, `leading-relaxed`, `text-left`, `text-center`, `text-right`, `text-legion-ink`, `text-legion-muted`, `text-legion-cyan`, `bg-legion-paper`, `bg-legion-ink`, `bg-legion-cyan`, `border`, `border-2`, `border-legion-line`, `rounded`, `rounded-box`, `overflow-x-auto`, `table`, `table-zebra`.
 
-59 recommended utilities.
+60 recommended utilities.
 
 ### Recommended daisyUI components
 
 `alert`, `badge`, `btn`, `card`, `stat`, `table`.
 
-6 recommended components · 64 documented recommendations.
+6 recommended components · 65 documented recommendations.
 
 <!-- VOCABULARY:END -->
 

package/docs/reference/mcp.md

@@ -11,9 +11,14 @@ bun add -g @legionworks/facet
 facet-mcp
 ```
 
-Releases through `1.9.0` ship a `facet-mcp` bin that cannot launch directly. Use the next release or newer. A local package built with this fix answered JSON-RPC `initialize` after a global install. The `npx -p @legionworks/facet facet-mcp` path still needs verification against that published release before it is recommended.
+Releases through `1.9.0` ship a `facet-mcp` bin that cannot launch: its entry file has no `#!/usr/bin/env bun` line. Use `1.10.0` or newer. With `1.10.0` on Bun `1.4.0`, each of these answered JSON-RPC `initialize` and listed six tools:
 
-Do not use `bunx -p @legionworks/facet facet-mcp` as the registration command without verifying the local Bun release. It exited immediately with status 1 on Bun `1.3.14` on the measured host; the same form also exited with status 1 under the available scratch Bun `1.4.0` runtime. These observations are environment-specific, so this caveat is not a universal claim about every Bun release or installation.
+- `bun add -g @legionworks/facet`, then `facet-mcp`
+- `npm i -g @legionworks/facet`, then `facet-mcp`
+- `npx -p @legionworks/facet facet-mcp`
+- `bunx -p @legionworks/facet facet-mcp`
+
+Run `npx -p` from outside a Facet checkout. Inside one, npx resolves the local project instead of the published package and fails with `facet-mcp: command not found`.
 
 The adapter resolves the CLI in this order: `FACET_CLI`, then `bun <adapter-relative-repository>/src/cli/main.ts`, then `facet` on `PATH`. Set `FACET_CLI` to an absolute CLI executable when the adapter should use another installation.
 
@@ -69,6 +74,14 @@ Set `FACET_HOME` in the host configuration when the adapter must use a non-defau
 
 Exactly one of `sourceText` or `file` is required. The adapter returns `invalid_request` when both or neither are supplied.
 
+Tier 0 means structure was parsed and compiled, not rendered. Request
+`facet_read_back` with `tier: "visual"` before reporting a render. Visual
+evidence covers the first rendered state of an interactive TSX artifact;
+later interaction is not validated and does not change the stored verdict.
+When testing by hand with the MCP Inspector CLI, `--tool-arg key=value` passes
+`\n` literally, so multi-line `sourceText` arrives as one line; pass `file`
+instead.
+
 The MCP surface has six artifact tools. Start a cold-home flow with `facet_create`, then call `facet_publish`, `facet_read_back`, and `facet_export`. Each tool advertises its input schema in `tools/list`; run `facet doctor` through the CLI.
 
 ## Result and error handling

package/docs/reference/tsx.md

@@ -74,7 +74,9 @@ has no host port or service capability.
 The TSX verifier loads the vendored `artifact.css` used by the gallery frame.
 A runtime error after initial render, such as one thrown by a click handler,
 appears as a gallery signal in an `aria-live="polite"` status region. It does
-not rewrite the immutable verdict and clears on revision swap or theme change.
+not rewrite the immutable verdict. It clears on revision swap. Switching the
+theme keeps the frame mounted, including interactive component state and any
+runtime error signal already displayed.
 
 Revision source remains immutable. Compilation creates derived bytes recorded at
 the run's `compiled_path`; TSX source export writes the original `.tsx` bytes.

package/docs/reference/validation.md

@@ -14,7 +14,7 @@ Every other layer is bound to it through `VerdictSchema.status`.
 | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `ok`                         | Counts agree across protocol + shim + isolated worlds, layout observable, no discriminative errors.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `error`                      | Counts disagree with the lexical expectation OR the protocol surfaced a discriminative error.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| `partial:layout_unverified`  | Counts agree but the layout pass is unverified (no SVG rendered with a non-degenerate viewBox). MUST carry a screenshot path on the wire.                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `partial:layout_unverified`  | Counts agree but the layout pass is unverified (no SVG rendered with a non-degenerate viewBox). Markdown with zero expected renderer roots and opaque regions instead reaches `ok` when protocol and isolated observations agree that its renderer root is non-empty. Empty Markdown remains unverified. MUST carry a screenshot path on the wire.                                                                                                                                                                                               |
 | `partial:opaque_content`     | An opaque DOM region was observed, so structural contents were not verified. MUST carry a screenshot path, or a typed `screenshotError` marker when capture fails transiently.                                                                                                                                                                                                                                                                                                                                                                   |
 | `partial:external_resources` | The artifact references external HTTPS images the no-egress verifier could not observe. MUST carry a screenshot path, or a typed `screenshotError` marker when capture fails transiently.                                                                                                                                                                                                                                                                                                                                                        |
 | `partial:unstable`           | TSX interactive mode: the structure observed at the render barrier differed from the structure observed after a bounded stability window. Deliberately NOT `tampered` — a legitimately animated or async-loading component also changes structure between observations, and branding that a forgery would manufacture the false-verdict class this project has spent three arcs eliminating. `tampered` stays reserved for channel divergence. MUST carry a screenshot path, or a typed `screenshotError` marker when capture fails transiently. |
@@ -48,7 +48,7 @@ ordering, top to bottom:
 7. `error` (declared-opaque, observed-zero) — the artifact declared opaque regions and none were seen.
 8. `partial:opaque_content` — single-snapshot claim: structure has opaque regions.
 9. `partial:external_resources` — single-snapshot claim: structure has external HTTP references.
-10. `partial:layout_unverified` — single-snapshot claim: visible SVG with zeroed viewBoxes.
+10. `partial:layout_unverified` — single-snapshot claim: visible SVG with zeroed viewBoxes; it also applies to empty Markdown, while diagram-free Markdown with matching non-empty observations has no layout to verify.
 11. `ok`.
 
 The rule generalizing rows 4 and 6: a claim that depends on ONE observation
@@ -77,11 +77,19 @@ WebP; legacy PNG evidence remains readable and exportable. Before static
 capture it emulates `prefers-reduced-motion: reduce` and awaits
 `document.fonts.ready`; these pre-flights keep repeated captures byte-identical.
 
+If resizing the capture viewport makes the artifact grow, Tier 1 restores the
+1280×800 evidence viewport and captures the artifact's scroll area in tiles.
+The tiles form one still WebP image, including for interactive or animated
+artifacts. This avoids changing viewport-sized elements such as `100vh` while
+retaining content below and to the right. Fixed and sticky elements repeat in
+each tile. Content that grows while the tiles are captured gets
+`screenshot_unavailable` instead of an incomplete image.
+
 Tier 1 uses the same artifact-type layout rules as the gallery frame: Mermaid,
 SVG, and chart roots are safely centered on both axes, with oversized content
 remaining reachable by scrolling; Markdown is top-aligned in a horizontally
-centered column capped at about 92ch; HTML and TSX are top-aligned while their
-renderer roots are safely centered across the stage. The renderer-parity gate
+centered column capped at about 92ch; HTML and TSX use top-aligned document
+flow, where a fixed-width layout can center itself with `mx-auto`. The renderer-parity gate
 compares both the gallery and verifier renderer-module sets and CSS/stylesheet
 sets.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legionworks/facet",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "private": false,
   "keywords": [
     "artifacts",

package/skills/facet/SKILL.md

@@ -93,7 +93,7 @@ non-whitespace text; the verdict requires a screenshot.
 | ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
 | `invalid_request`        | Correct the command flags, artifact type, or source bytes, then retry.                                           |
 | `artifact_not_found`     | List or create the artifact, then use its returned ID.                                                           |
-| `revision_not_found`     | Omit the SHA for latest, or replace it with a returned revision SHA.                                             |
+| `revision_not_found`     | Check that the artifact has a revision; omit the SHA for latest, or replace it with a returned revision SHA.     |
 | `duplicate_revision`     | Use `error.details.revisionSha` as the existing revision SHA; do not republish identical bytes.                  |
 | `evidence_unavailable`   | Request Tier 1 evidence for that revision before a render export, or export source instead.                      |
 | `output_unwritable`      | Choose a writable `--out` path, resolve collisions, or use `--force` deliberately.                               |
@@ -114,9 +114,8 @@ non-whitespace text; the verdict requires a screenshot.
 - With shell access, the CLI is the integration — MCP is for structured-tool-only hosts, even when the host owns an MCP client. On that surface, `facet_open_url` is safe because it always uses `--no-launch`.
 - For MCP registration, use `bun add -g @legionworks/facet` and the bare
   `facet-mcp` command, or the no-install fallback `npx -p @legionworks/facet
-facet-mcp`. The measured `bunx -p @legionworks/facet facet-mcp` form exited
-  with status 1 under Bun `1.3.14` and the available scratch Bun `1.4.0`; treat
-  that as an environment-specific caveat, not a universal Bun claim.
+facet-mcp` (`bunx -p` also works). Use `1.10.0` or newer; earlier releases
+  ship a `facet-mcp` bin that cannot launch.
 
 ## Deeper reference
 

package/src/gallery-web/app.ts

@@ -23,7 +23,12 @@
  * surfaces an error badge.
  */
 
-import { assertLoopbackHostname, buildFrameAttributes, type FrameAttributes } from "./frame-html";
+import {
+  assertLoopbackHostname,
+  buildFrameAttributes,
+  usesArtifactStylesheet,
+  type FrameAttributes,
+} from "./frame-html";
 import { planSwap, type SwapPlanStep } from "./swap";
 import { connectRevisionStream } from "./sse-client";
 import type { VerdictObserved } from "../shared/contracts/validation";
@@ -376,6 +381,7 @@ export interface CreatedArtifactFrame {
     payload: FrameRenderPayload,
     timeoutMs: number,
   ) => Promise<FrameRenderResultHandle>;
+  readonly setTheme: (theme: ResolvedGalleryTheme) => void;
   /** Handle from the last successful render (null before the first). */
   readonly renderResult: FrameRenderResultHandle | null;
 }
@@ -488,6 +494,14 @@ export function createArtifactFrame(options: CreateArtifactFrameOptions): Create
       renderResult = handle;
       return handle;
     },
+    setTheme(theme) {
+      // oxlint-disable-next-line no-underscore-dangle
+      const api = raw.contentWindow?.__facetFrame;
+      if (api === null || api === undefined || typeof api.setTheme !== "function") {
+        throw new Error("frame theme API unavailable");
+      }
+      api.setTheme(theme);
+    },
     get renderResult(): FrameRenderResultHandle | null {
       return renderResult;
     },
@@ -1309,6 +1323,11 @@ export async function startGallery(runtime = browserGalleryRuntime()): Promise<v
     const canCommit = (): boolean =>
       themeGeneration === generation && nextMode === requestedThemeMode;
     if (!canCommit()) return;
+    if (usesArtifactStylesheet(source.artifactType)) {
+      current.setTheme(nextResolvedTheme);
+      commitTheme(nextMode, nextResolvedTheme);
+      return;
+    }
     const next = createArtifactFrame({
       artifactType: source.artifactType,
       renderer: source.renderer,

package/src/gallery-web/frame/renderers/markdown.ts

@@ -77,5 +77,9 @@ export async function renderMarkdown(ctx: RenderContext, bytes: Uint8Array): Pro
     if (region.firstElementChild !== null) pre.replaceWith(region);
     else pre.remove();
   }
-  ctx.container.appendChild(template.content);
+  const root = document.createElement("div");
+  root.setAttribute("data-facet-renderer-root", "true");
+  root.setAttribute("data-facet-renderer-kind", "markdown");
+  root.appendChild(template.content);
+  ctx.container.appendChild(root);
 }