@dcl-regenesislabs/artifacts 1.0.0

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dcl-regenesislabs/artifacts",
+  "version": "1.0.0",
+  "description": "Publish static artifacts to artifacts.dclregenesislabs.xyz — sign in with a work email, push a folder, get a link back",
+  "type": "module",
+  "bin": {
+    "dcl-artifacts": "cli/artifacts.mjs"
+  },
+  "files": [
+    "cli/",
+    "shared/",
+    "templates/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dcl-regenesislabs/ia-generated-artifacts.git"
+  },
+  "homepage": "https://artifacts.dclregenesislabs.xyz",
+  "bugs": "https://github.com/dcl-regenesislabs/ia-generated-artifacts/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "tail": "wrangler tail",
+    "typecheck": "tsc --noEmit",
+    "push": "node ./cli/artifacts.mjs push",
+    "smoke": "./scripts/smoke.sh",
+    "skill:install": "./scripts/install-skill.sh",
+    "guide": "node ./scripts/build-guide.mjs",
+    "dist": "node ./scripts/build-dist.mjs",
+    "predev": "node ./scripts/build-dist.mjs",
+    "predeploy": "node ./scripts/build-dist.mjs"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^5.20260831.1",
+    "typescript": "^5.6.0",
+    "wrangler": "^4.56.0"
+  },
+  "allowScripts": {
+    "esbuild@0.28.1": true,
+    "workerd@1.20260831.1": true
+  }
+}

package/shared/artifact-id.js

@@ -0,0 +1,175 @@
+/**
+ * Shared vocabulary for artifact ids, version hashes and manifests.
+ *
+ * Imported by BOTH the Worker (TypeScript, bundled by wrangler) and the Node
+ * CLI, so the client and the server can never disagree about what an id or a
+ * manifest looks like.
+ *
+ * An artifact id is a random UUID v4 minted by whoever creates the artifact.
+ * It never changes; new pushes to the same id become new *versions*. Each
+ * version is identified inside the artifact by a content hash of its file
+ * list, which is what makes re-pushing identical bytes a no-op.
+ */
+
+export const MANIFEST_VERSION = 2;
+export const MAX_PATH_LEN = 512;
+
+/** Artifact id: UUID v4, lowercase. */
+export const ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/** Ids from before versioning existed — only so they can still be deleted. */
+export const LEGACY_ID_RE = /^[0-9a-f]{16}$/;
+/** `{id}@{n}` pins one version in a URL. */
+export const VERSION_SUFFIX_RE = /^@([1-9][0-9]{0,5})$/;
+
+/** Paths are POSIX-style, relative, no `.`/`..` segments, no leading slash. */
+export const PATH_RE = /^(?!\/)(?!.*(?:^|\/)\.\.?(?:\/|$))[^\0]+$/;
+
+/**
+ * A top-level path starting with `__` is reserved for the host: `__ui/...`
+ * is the in-page API, and the old layout kept its records under such names.
+ */
+export const RESERVED_PREFIX = "__";
+
+/** Public share aliases: 16 random bytes, base64url, no padding. */
+export const ALIAS_RE = /^[A-Za-z0-9_-]{22}$/;
+
+export function newId() {
+  return crypto.randomUUID();
+}
+
+/**
+ * `n` random bytes as unpadded base64url. Share aliases, login codes, upload
+ * tokens and the PKCE verifier all come from here, so there is one place to
+ * look at when asking how much entropy any of them has.
+ *
+ * @param {number} n
+ */
+export function randomB64url(n) {
+  return b64url(crypto.getRandomValues(new Uint8Array(n)));
+}
+
+/** @param {ArrayBuffer | Uint8Array} buf */
+export function b64url(buf) {
+  const view = buf instanceof Uint8Array ? buf : new Uint8Array(buf);
+  let binary = "";
+  for (const b of view) binary += String.fromCharCode(b);
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+
+/**
+ * The PKCE challenge, computed identically on both sides of the login so the
+ * two can never disagree about the encoding.
+ *
+ * @param {string} value
+ * @returns {Promise<string>}
+ */
+export async function sha256B64url(value) {
+  return b64url(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(value)));
+}
+
+/**
+ * The short code shown both in the terminal and on the login confirm page,
+ * derived from the PKCE challenge that both sides already hold. It is not a
+ * secret — it is something the person has to *match*, so a page someone else
+ * mailed them has nothing to match against and the right move is obvious.
+ *
+ * @param {string} challenge
+ * @returns {Promise<string>} e.g. `K7QM-3F`
+ */
+export async function userCode(challenge) {
+  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(challenge));
+  const bytes = new Uint8Array(digest);
+  const alphabet = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"; // no O/0, no I/1
+  let out = "";
+  for (let i = 0; i < 6; i++) out += alphabet[bytes[i] % alphabet.length];
+  return `${out.slice(0, 4)}-${out.slice(4)}`;
+}
+
+/** Generates a share alias with 128 bits of entropy. */
+export function newAlias() {
+  return randomB64url(16);
+}
+
+/**
+ * Accepts a bare id or any URL on the host that contains one
+ * (`https://host/{id}`, `https://host/{id}@3/x.png`) and returns the id.
+ * @param {string} input
+ * @returns {string | null}
+ */
+export function parseId(input) {
+  const s = String(input ?? "").trim();
+  if (ID_RE.test(s) || LEGACY_ID_RE.test(s)) return s.toLowerCase();
+  const m = /^(?:https?:\/\/[^/]+)?\/?([0-9a-f-]{36}|[0-9a-f]{16})(?:@\d+)?(?:[/?#]|$)/i.exec(s);
+  if (!m) return null;
+  const id = m[1].toLowerCase();
+  return ID_RE.test(id) || LEGACY_ID_RE.test(id) ? id : null;
+}
+
+/**
+ * @typedef {{ path: string, size: number, sha256: string, contentType?: string }} ArtifactFile
+ * @typedef {{ files: ArtifactFile[], name?: string }} FileList
+ */
+
+/**
+ * Deterministic byte string that the version hash covers: paths and digests
+ * only, sorted, so file order and metadata never change the hash.
+ * @param {FileList} manifest
+ * @returns {string}
+ */
+export function canonicalize(manifest) {
+  const files = [...manifest.files]
+    .map((f) => ({ path: f.path, sha256: String(f.sha256).toLowerCase() }))
+    .sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+  return JSON.stringify({ v: MANIFEST_VERSION, files });
+}
+
+/**
+ * Content hash of a version's file list.
+ * @param {FileList} manifest
+ * @returns {Promise<string>} 32 lowercase hex chars
+ */
+export async function contentHash(manifest) {
+  const bytes = new TextEncoder().encode(canonicalize(manifest));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return hex(digest).slice(0, 32);
+}
+
+/** @param {ArrayBuffer | Uint8Array} buf */
+export function hex(buf) {
+  const view = buf instanceof Uint8Array ? buf : new Uint8Array(buf);
+  let out = "";
+  for (const b of view) out += b.toString(16).padStart(2, "0");
+  return out;
+}
+
+/**
+ * Validate a file list received over the wire. Returns an error string, or null when valid.
+ * @param {unknown} manifest
+ * @returns {string | null}
+ */
+export function validateManifest(manifest) {
+  if (!manifest || typeof manifest !== "object") return "manifest must be an object";
+  const m = /** @type {FileList} */ (manifest);
+  if (!Array.isArray(m.files)) return "manifest.files must be an array";
+  if (m.files.length === 0) return "manifest.files must not be empty";
+  if (m.files.length > 2000) return "too many files (max 2000)";
+  if (m.name !== undefined && typeof m.name !== "string") return "manifest.name must be a string";
+  const seen = new Set();
+  for (const f of m.files) {
+    if (!f || typeof f !== "object") return "each file must be an object";
+    if (typeof f.path !== "string" || !PATH_RE.test(f.path)) return `invalid path: ${JSON.stringify(f?.path)}`;
+    if (f.path.length > MAX_PATH_LEN) return `path too long: ${f.path}`;
+    if (isReservedPath(f.path)) return `reserved path: ${f.path} (top-level names may not start with ${RESERVED_PREFIX})`;
+    if (seen.has(f.path)) return `duplicate path: ${f.path}`;
+    seen.add(f.path);
+    if (typeof f.sha256 !== "string" || !/^[0-9a-f]{64}$/i.test(f.sha256)) return `invalid sha256 for ${f.path}`;
+    if (!Number.isInteger(f.size) || f.size < 0) return `invalid size for ${f.path}`;
+    if (f.contentType !== undefined && typeof f.contentType !== "string") return `invalid contentType for ${f.path}`;
+  }
+  return null;
+}
+
+/** True for top-level names the host keeps for itself. */
+export function isReservedPath(path) {
+  return path.startsWith(RESERVED_PREFIX);
+}

package/templates/artifact/assets/dcl.css

@@ -0,0 +1,279 @@
+/* dcl.css — the house style for prose pages on artifacts.dclregenesislabs.xyz.
+ *
+ * Palette, type, radius and dark mode are the Regenesis house definitions, kept in step with
+ * .claude/skills/dcl-artifacts/references/regenesis-artifact-style.md, which is authoritative.
+ * This file is the PROSE layout of that one visual language; the guide is the report layout.
+ *
+ * Tokens first, components after. Per page you normally touch ONE thing:
+ * --accent (and --accent-soft to match). Leave the rest alone so every
+ * artifact reads as one family.
+ *
+ * Theme has three states on <html>: no attribute (follows the OS),
+ * data-theme="light", data-theme="dark". dcl.js drives the toggle and
+ * remembers the choice for the whole host.
+ */
+
+:root {
+  --ground: #f9f9f7;
+  --surface: #fcfcfb;
+  --surface-2: #f1f0ea;
+  --ink: #0b0b0b;
+  --muted: #52514e;
+  --hairline: #e1e0d9;
+  --accent: #FF2D55;
+  --accent-soft: #ffe8ed;
+  --ok: #0ca30c;    --ok-soft: #e6f6e6;
+  --warn: #fab219;  --warn-soft: #fdf3e0;
+  --bad: #FF2D55;   --bad-soft: #ffe8ed;
+  --info: #2a78d6;  --info-soft: #e6eff9;
+  --pad: rgba(120, 130, 150, .06);
+  --font-sans: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+  --font-mono: "Inter", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+  --page-width: 920px;
+  --radius: 14px;
+  color-scheme: light;
+}
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    --ground: #0d0d0d; --surface: #1a1a19; --surface-2: #222220;
+    --ink: #ffffff; --muted: #c3c2b7; --hairline: #2c2c2a;
+    --accent: #FF2D55; --accent-soft: #3a1620;
+    --ok: #0ca30c; --ok-soft: #10240f; --warn: #fab219; --warn-soft: #2a2110;
+    --bad: #FF2D55; --bad-soft: #2a1219; --info: #3987e5; --info-soft: #10203a;
+    --pad: rgba(120, 130, 150, .05);
+    color-scheme: dark;
+  }
+}
+:root[data-theme="dark"] {
+  --ground: #0d0d0d; --surface: #1a1a19; --surface-2: #222220;
+  --ink: #ffffff; --muted: #c3c2b7; --hairline: #2c2c2a;
+  --accent: #FF2D55; --accent-soft: #3a1620;
+  --ok: #0ca30c; --ok-soft: #10240f; --warn: #fab219; --warn-soft: #2a2110;
+  --bad: #FF2D55; --bad-soft: #2a1219; --info: #3987e5; --info-soft: #10203a;
+  --pad: rgba(120, 130, 150, .05);
+  color-scheme: dark;
+}
+
+/* ---------- base ---------- */
+* { box-sizing: border-box; }
+html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
+/* the host adds a 44px sticky bar on team links; keep anchored headings clear of it */
+[id] { scroll-margin-top: 60px; }
+@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
+body {
+  margin: 0; background: var(--ground); color: var(--ink);
+  font-family: var(--font-sans); font-size: 16px; line-height: 1.55;
+  -webkit-font-smoothing: antialiased;
+}
+a { color: var(--accent); }
+a:focus-visible, button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+b, strong { font-weight: 600; }
+p { margin: 0 0 12px; max-width: 78ch; }
+ul, ol { margin: 0 0 12px; padding-left: 22px; max-width: 78ch; }
+li { margin: 4px 0; }
+li::marker { color: var(--muted); }
+hr { border: 0; border-top: 1px solid var(--hairline); margin: 28px 0; }
+img, svg, video { max-width: 100%; height: auto; }
+
+.wrap { width: 100%; max-width: var(--page-width); margin: 0 auto; padding: 0 clamp(14px, 2.4vw, 40px) 90px; }
+.wrap.narrow { --page: 860px; }
+.wrap.wide { --page: 1580px; }
+
+code { font-family: var(--font-mono); font-size: .86em; background: var(--surface-2); padding: 1px 6px; border-radius: 5px; }
+pre {
+  margin: 10px 0 14px; overflow-x: auto; background: var(--surface); border: 1px solid var(--hairline);
+  border-radius: 10px; padding: 12px 16px; font-family: var(--font-mono); font-size: .8rem; line-height: 1.7; color: var(--ink);
+}
+/* dcl.js wraps every pre in .codeblock and adds the Copy button */
+.codeblock { position: relative; }
+.codeblock > pre { padding-right: 100px; }
+/* fade the text out under the button instead of letting it run beneath it */
+.codeblock::after {
+  content: ""; position: absolute; top: 1px; right: 1px; bottom: 1px; width: 96px; pointer-events: none;
+  border-radius: 0 10px 10px 0; background: linear-gradient(to right, transparent, var(--surface) 38%);
+}
+.codeblock > .copy {
+  z-index: 1;
+  position: absolute; top: 8px; right: 8px; font: 500 11px/1 var(--font-mono); letter-spacing: .04em; text-transform: uppercase;
+  color: var(--muted); background: var(--surface-2); border: 1px solid var(--hairline); border-radius: 6px; padding: 5px 8px; cursor: pointer;
+}
+.codeblock > .copy:hover { color: var(--ink); border-color: var(--muted); }
+.codeblock > .copy.done { color: var(--ok); border-color: var(--ok); }
+pre code { background: none; padding: 0; font-size: inherit; }
+pre .c { color: var(--muted); }          /* comment */
+pre .k { color: var(--accent); }         /* keyword / emphasis */
+pre .o { color: var(--ok); }             /* output */
+kbd { font-family: var(--font-mono); font-size: .8em; border: 1px solid var(--hairline); border-bottom-width: 2px; border-radius: 5px; padding: 1px 6px; background: var(--surface); }
+
+.mono { font-family: var(--font-mono); }
+.muted { color: var(--muted); }
+.num { font-variant-numeric: tabular-nums; }
+.small { font-size: .9rem; }
+
+/* ---------- header ---------- */
+header { padding: 34px 0 20px; border-bottom: 1px solid var(--hairline); margin-bottom: 22px; }
+.top { display: flex; justify-content: space-between; align-items: flex-start; gap: 20px; flex-wrap: wrap; }
+.top > div { min-width: 0; flex: 1 1 520px; }
+.eyebrow {
+  font-family: var(--font-mono); font-size: .72rem; letter-spacing: .14em; text-transform: uppercase;
+  color: var(--accent); margin: 0 0 12px; font-weight: 500;
+}
+h1 {
+  font-size: clamp(1.55rem, 2.4vw, 2.2rem); font-weight: 700; letter-spacing: -.02em;
+  margin: 0 0 12px; text-wrap: balance; line-height: 1.12;
+}
+.lede { margin: 0; max-width: 88ch; color: var(--muted); font-size: 1rem; }
+.lede b { color: var(--ink); }
+.toggle {
+  font-family: var(--font-mono); font-size: .78rem; color: var(--muted); background: var(--surface);
+  border: 1px solid var(--hairline); border-radius: 8px; padding: 8px 12px; cursor: pointer; white-space: nowrap;
+}
+.toggle:hover { color: var(--ink); border-color: var(--accent); }
+.toc { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 18px; }
+.toc a {
+  font-family: var(--font-mono); font-size: .75rem; text-decoration: none; color: var(--muted);
+  background: var(--surface); border: 1px solid var(--hairline); border-radius: 999px; padding: 5px 11px;
+}
+.toc a:hover { color: var(--ink); border-color: var(--accent); }
+
+/* ---------- sections ---------- */
+h2 { font-size: 1.22rem; font-weight: 700; margin: 38px 0 6px; letter-spacing: -.01em; scroll-margin-top: 16px; }
+h3 { font-size: 1rem; font-weight: 600; margin: 22px 0 6px; }
+.sub { color: var(--muted); margin: 0 0 14px; max-width: 92ch; font-size: .95rem; }
+
+/* ---------- callouts ---------- */
+.callout {
+  background: var(--accent-soft); border: 1px solid color-mix(in srgb, var(--accent) 30%, var(--hairline));
+  border-radius: var(--radius); padding: 16px 18px; margin: 14px 0;
+}
+.callout p { margin: 0 0 8px; font-size: .94rem; max-width: 100ch; }
+.callout p:last-child, .callout ul:last-child { margin-bottom: 0; }
+.callout.ok   { background: var(--ok-soft);   border-color: color-mix(in srgb, var(--ok) 40%, var(--hairline)); }
+.callout.warn { background: var(--warn-soft); border-color: color-mix(in srgb, var(--warn) 45%, var(--hairline)); }
+.callout.bad  { background: var(--bad-soft);  border-color: color-mix(in srgb, var(--bad) 40%, var(--hairline)); }
+.callout.info { background: var(--info-soft); border-color: color-mix(in srgb, var(--info) 40%, var(--hairline)); }
+/* a quieter variant: surface background, colored left rail */
+.note {
+  background: var(--surface); border: 1px solid var(--hairline); border-left: 4px solid var(--accent);
+  border-radius: var(--radius); padding: 14px 18px; margin: 12px 0;
+}
+.note p { margin: 0 0 8px; font-size: .93rem; max-width: 100ch; }
+.note p:last-child { margin: 0; }
+.note.ok { border-left-color: var(--ok); }
+.note.warn { border-left-color: var(--warn); border-color: color-mix(in srgb, var(--warn) 45%, var(--hairline)); border-left-color: var(--warn); }
+.note.bad { border-left-color: var(--bad); }
+
+/* ---------- tables ---------- */
+.tblwrap { overflow-x: auto; background: var(--surface); border: 1px solid var(--hairline); border-radius: 14px; margin: 0 0 14px; }
+.tblwrap table { width: 100%; border-collapse: collapse; font-size: .9rem; }
+.tblwrap th {
+  font-family: var(--font-mono); font-size: .7rem; letter-spacing: .1em; text-transform: uppercase; color: var(--muted);
+  text-align: left; padding: 12px 18px 8px; border-bottom: 1px solid var(--hairline); font-weight: 500;
+}
+.tblwrap td { padding: 11px 18px; border-bottom: 1px solid var(--hairline); vertical-align: top; }
+.tblwrap tr:last-child td { border-bottom: 0; }
+.tblwrap td.n { font-family: var(--font-mono); font-weight: 600; white-space: nowrap; }
+.tblwrap td.t { white-space: nowrap; }
+.tblwrap td.src { font-family: var(--font-mono); font-size: .79rem; color: var(--muted); }
+.tblwrap td.src b { color: var(--ink); font-weight: 500; }
+.tblwrap td.r { text-align: right; font-variant-numeric: tabular-nums; }
+.yes { color: var(--ok); font-weight: 600; white-space: nowrap; }
+.no  { color: var(--muted); font-weight: 600; white-space: nowrap; }
+.chg { color: var(--warn); font-weight: 600; white-space: nowrap; }
+
+/* key / value list */
+.kv { display: grid; grid-template-columns: max-content 1fr; gap: 6px 18px; margin: 0 0 14px; font-size: .93rem; max-width: 100ch; }
+.kv dt { font-family: var(--font-mono); font-size: .8rem; color: var(--muted); padding-top: 2px; }
+.kv dd { margin: 0; }
+
+/* ---------- cards ---------- */
+.grid2 { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin: 0 0 14px; }
+.grid3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: 16px; margin: 0 0 14px; }
+@media (max-width: 900px) { .grid2, .grid3 { grid-template-columns: 1fr; } }
+.card {
+  background: var(--surface); border: 1px solid var(--hairline); border-radius: 14px; padding: 18px 20px;
+  border-left: 4px solid var(--layer, var(--accent)); min-width: 0;
+}
+.card.ok { --layer: var(--ok); } .card.warn { --layer: var(--warn); } .card.bad { --layer: var(--bad); }
+.card.info { --layer: var(--info); } .card.plain { --layer: var(--hairline); }
+.card-h { display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; margin-bottom: 4px; }
+.card-h .name { font-family: var(--font-mono); font-size: 1rem; font-weight: 600; color: var(--ink); }
+.card .covers { font-size: .86rem; color: var(--muted); margin: 2px 0 12px; }
+.card p { font-size: .93rem; }
+.card ul { margin: 0; padding-left: 0; list-style: none; }
+.card li { margin: 9px 0; font-size: .9rem; padding-left: 16px; position: relative; }
+.card li::before {
+  content: ""; position: absolute; left: 0; top: .55em; width: 6px; height: 6px; border-radius: 50%;
+  background: var(--layer, var(--accent));
+}
+.badge {
+  font-family: var(--font-mono); font-size: .68rem; letter-spacing: .04em; text-transform: uppercase;
+  color: var(--layer, var(--accent)); border: 1px solid var(--layer, var(--accent)); border-radius: 999px; padding: 2px 8px;
+}
+.lang { font-family: var(--font-mono); font-size: .72rem; color: var(--muted); margin-left: auto; }
+
+/* big-number tiles — only when the numbers are the point */
+.stat { background: var(--surface); border: 1px solid var(--hairline); border-radius: 14px; padding: 16px 18px; }
+.stat .v { font-family: var(--font-mono); font-size: 1.8rem; font-weight: 600; letter-spacing: -.02em; font-variant-numeric: tabular-nums; line-height: 1.1; }
+.stat .l { font-size: .8rem; color: var(--muted); margin-top: 6px; }
+
+/* ---------- inline labels ---------- */
+.tag, .pill {
+  display: inline-block; font-family: var(--font-mono); font-size: .66rem; text-transform: uppercase; letter-spacing: .04em;
+  border-radius: 999px; padding: 2px 9px; border: 1px solid var(--hairline); color: var(--muted); white-space: nowrap; vertical-align: middle;
+}
+.tag.accent, .pill.accent { color: var(--accent); border-color: var(--accent); }
+.tag.ok, .pill.ok     { color: var(--ok);   border-color: var(--ok); }
+.tag.warn, .pill.warn { color: var(--warn); border-color: var(--warn); }
+.tag.bad, .pill.bad   { color: var(--bad);  border-color: var(--bad); }
+.tag.info, .pill.info { color: var(--info); border-color: var(--info); }
+.pill { border: 0; font-weight: 600; }
+.pill.accent { background: var(--accent-soft); } .pill.ok { background: var(--ok-soft); }
+.pill.warn { background: var(--warn-soft); } .pill.bad { background: var(--bad-soft); } .pill.info { background: var(--info-soft); }
+
+/* ---------- ordered sequence (only when order carries meaning) ---------- */
+ol.phases { counter-reset: step; list-style: none; padding: 0; margin: 0 0 14px; display: grid; gap: 12px; max-width: none; }
+ol.phases li { background: var(--surface); border: 1px solid var(--hairline); border-radius: var(--radius); padding: 16px 18px 16px 56px; position: relative; margin: 0; }
+ol.phases li::before {
+  counter-increment: step; content: counter(step); position: absolute; left: 16px; top: 16px; width: 26px; height: 26px;
+  border-radius: 50%; background: var(--accent); color: var(--surface); font-family: var(--font-mono); font-size: .82rem; font-weight: 600;
+  display: flex; align-items: center; justify-content: center;
+}
+ol.phases b { font-weight: 600; }
+ol.phases p { margin: 4px 0 0; color: var(--muted); font-size: .9rem; }
+ol.phases pre { margin: 8px 0 0; }
+
+/* ---------- before / after code columns with diff rows ---------- */
+.path { font-family: var(--font-mono); font-size: .79rem; color: var(--muted); margin: 10px 2px 6px; }
+.path b { color: var(--ink); font-weight: 600; }
+.fn { color: var(--accent); }
+.split { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; align-items: start; margin-bottom: 14px; }
+@media (max-width: 920px) { .split { grid-template-columns: 1fr; } }
+.col { border: 1px solid var(--hairline); border-radius: 11px; overflow: hidden; background: var(--surface); min-width: 0; }
+.colhead { padding: 7px 14px; background: var(--surface-2); border-bottom: 1px solid var(--hairline); font-family: var(--font-mono); font-size: .74rem; text-transform: uppercase; letter-spacing: .05em; }
+.colhead.before { color: var(--bad); } .colhead.after { color: var(--ok); }
+.code { overflow-x: auto; padding: 6px 0; font-family: var(--font-mono); font-size: .8rem; line-height: 1.6; }
+.row { display: flex; white-space: pre; min-width: max-content; width: 100%; }
+.row .num { flex: 0 0 auto; width: 3.4em; text-align: right; padding: 0 10px 0 6px; user-select: none; color: var(--muted); opacity: .55; font-variant-numeric: tabular-nums; }
+.row .sign { flex: 0 0 auto; width: 1.5ch; text-align: center; user-select: none; color: var(--muted); }
+.row .src { flex: 1 1 auto; padding-right: 16px; }
+.row.del { background: var(--bad-soft); box-shadow: inset 2px 0 0 var(--bad); } .row.del .sign { color: var(--bad); }
+.row.add { background: var(--ok-soft);  box-shadow: inset 2px 0 0 var(--ok); }  .row.add .sign { color: var(--ok); }
+.row.pad { background: var(--pad); }
+
+/* ---------- checklist ---------- */
+/* <input type="checkbox" data-persist="key"> remembers its state on the host,
+   for everyone who opens the page. The key is the identity: keep it stable
+   across versions. Public viewers see the state but cannot change it. */
+ul.checklist { list-style: none; padding: 0; margin: 0 0 14px; max-width: 78ch; background: var(--surface); border: 1px solid var(--hairline); border-radius: var(--radius); }
+ul.checklist li { margin: 0; border-top: 1px solid var(--hairline); }
+ul.checklist li:first-child { border-top: 0; }
+ul.checklist label { display: flex; gap: 12px; align-items: flex-start; padding: 10px 14px; cursor: pointer; }
+ul.checklist input { flex: none; width: 17px; height: 17px; margin: 3px 0 0; accent-color: var(--accent); cursor: pointer; }
+ul.checklist label:has(input:checked) { color: var(--muted); text-decoration: line-through; text-decoration-color: var(--hairline); }
+ul.checklist .hint { display: block; font-size: .85rem; color: var(--muted); text-decoration: none; }
+
+/* ---------- footer ---------- */
+footer { margin-top: 34px; padding-top: 20px; border-top: 1px solid var(--hairline); color: var(--muted); font-size: .85rem; max-width: 104ch; }
+footer b { color: var(--ink); }
+footer p { margin: 0 0 10px; }

package/templates/artifact/assets/dcl.js

@@ -0,0 +1,62 @@
+// dcl.js — behaviour for pages on artifacts.dclregenesislabs.xyz. Load it in
+// <head>, before the body paints.
+//
+//  1. Theme. Three states on <html>: no attribute (follow the OS), "light",
+//     "dark". Any element with data-theme-toggle switches it; the choice is
+//     stored once for the whole host, so every artifact follows it.
+//  2. A Copy button on every <pre>, so commands and snippets can be copied
+//     without selecting text.
+(function () {
+  var root = document.documentElement;
+  var KEY = "dcl-artifacts-theme";
+  function apply(t) {
+    if (t === "dark" || t === "light") root.setAttribute("data-theme", t);
+    else root.removeAttribute("data-theme");
+  }
+  try { apply(localStorage.getItem(KEY)); } catch (e) { /* storage blocked: follow the OS */ }
+  document.addEventListener("click", function (ev) {
+    var btn = ev.target.closest("[data-theme-toggle]");
+    if (!btn) return;
+    var dark = root.getAttribute("data-theme") === "dark" ||
+      (!root.getAttribute("data-theme") && matchMedia("(prefers-color-scheme: dark)").matches);
+    var next = dark ? "light" : "dark";
+    apply(next);
+    try { localStorage.setItem(KEY, next); } catch (e) { /* fine, just not remembered */ }
+  });
+
+  function copyButtons() {
+    Array.prototype.forEach.call(document.querySelectorAll("pre"), function (pre) {
+      if (pre.parentNode && pre.parentNode.classList && pre.parentNode.classList.contains("codeblock")) return;
+      var wrap = document.createElement("div");
+      wrap.className = "codeblock";
+      pre.parentNode.insertBefore(wrap, pre);
+      wrap.appendChild(pre);
+      var btn = document.createElement("button");
+      btn.type = "button";
+      btn.className = "copy";
+      btn.textContent = "Copy";
+      btn.setAttribute("aria-label", "Copy to clipboard");
+      btn.addEventListener("click", function () {
+        var text = pre.textContent.replace(/\n$/, "");
+        var done = function () {
+          btn.textContent = "Copied";
+          btn.classList.add("done");
+          setTimeout(function () { btn.textContent = "Copy"; btn.classList.remove("done"); }, 1600);
+        };
+        var fallback = function () {
+          var range = document.createRange();
+          range.selectNodeContents(pre);
+          var sel = window.getSelection();
+          sel.removeAllRanges();
+          sel.addRange(range);
+          try { document.execCommand("copy"); done(); } catch (e) { /* nothing more we can do */ }
+        };
+        if (navigator.clipboard && navigator.clipboard.writeText) navigator.clipboard.writeText(text).then(done, fallback);
+        else fallback();
+      });
+      wrap.appendChild(btn);
+    });
+  }
+  if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", copyButtons);
+  else copyButtons();
+})();