ryugi-artifacts 1.2.0 → 1.4.1

package/dist/server.cjs

@@ -1865,9 +1865,9 @@ var import_node_path5 = __toESM(require("node:path"), 1);
 // src/shared/geometry.ts
 var GROUP_PAD = 48;
 var GROUP_TOP = 144;
-var NAME_STRIP_H = 32;
+var NAME_STRIP_H = 48;
 var TITLE_LINE_HEIGHT = 1.15;
-var DEFAULT_TITLE_SIZE = 56;
+var DEFAULT_TITLE_SIZE = 96;
 var STICKY_DEFAULT_W = 240;
 var STICKY_FONT_SIZE = 18;
 var STICKY_LINE_H = 27;
@@ -1960,6 +1960,16 @@ function structuralWarnings(raw) {
   if (raw.focus !== void 0 && (!isObject2(raw.focus) || typeof raw.focus.target !== "string")) {
     warnings.push('"focus" must be { "target": <id>, "at": <time> }');
   }
+  if (raw.building !== void 0 && typeof raw.building !== "boolean") {
+    warnings.push('"building" must be a boolean');
+  }
+  if (isObject2(raw.boards)) {
+    for (const [id2, board] of Object.entries(raw.boards)) {
+      if (isObject2(board) && board.interactive !== void 0 && typeof board.interactive !== "boolean") {
+        warnings.push(`board "${id2}" field "interactive" must be a boolean`);
+      }
+    }
+  }
   if (warnings.length > 0) return warnings;
   raw.pages.forEach((page, index) => {
     if (!isObject2(page) || typeof page.id !== "string" || typeof page.name !== "string") {
@@ -1999,7 +2009,7 @@ function structuralWarnings(raw) {
   }
   return warnings;
 }
-function validateCanvas(raw, fileExists) {
+function validateCanvas(raw, fileExists, options = {}) {
   const structural = structuralWarnings(raw);
   if (structural.length > 0) return structural;
   const canvas = raw;
@@ -2011,7 +2021,10 @@ function validateCanvas(raw, fileExists) {
   for (const [id2, board] of boards) {
     if (!pages.has(board.page)) warnings.push(`board "${id2}" uses unknown page "${board.page}"`);
     if (!board.file.startsWith("pages/")) warnings.push(`board "${id2}" file must start with "pages/": ${board.file}`);
-    else if (!fileExists(board.file)) warnings.push(`board "${id2}" file not found: ${board.file}`);
+    else if (!fileExists(board.file)) {
+      options.pending?.add(id2);
+      if (!options.allowPending) warnings.push(`board "${id2}" file not found: ${board.file}`);
+    }
   }
   for (let i6 = 0; i6 < boards.length; i6++) {
     for (let j4 = i6 + 1; j4 < boards.length; j4++) {
@@ -2110,9 +2123,13 @@ function boardVersions(boardDir, canvas) {
   const versions = {};
   for (const board of Object.values(canvas.boards)) {
     const target = resolveBoardFile(boardDir, board.file);
-    if (!target) continue;
+    if (!target) {
+      versions[board.file] = 0;
+      continue;
+    }
     try {
-      versions[board.file] = import_node_fs5.default.statSync(target).mtimeMs;
+      const stat = import_node_fs5.default.statSync(target);
+      versions[board.file] = stat.size > 0 ? stat.mtimeMs : 0;
     } catch {
       versions[board.file] = 0;
     }
@@ -2121,17 +2138,26 @@ function boardVersions(boardDir, canvas) {
 }
 function readCanvas(boardDir) {
   const { raw, warning } = readRaw(boardDir);
-  if (warning) return { canvas: null, warnings: [warning], layout: null, versions: {} };
+  if (warning) return { canvas: null, warnings: [warning], pending: [], layout: null, versions: {} };
   try {
     const structural = structuralWarnings(raw);
-    if (structural.length > 0) return { canvas: null, warnings: structural, layout: null, versions: {} };
+    if (structural.length > 0) return { canvas: null, warnings: structural, pending: [], layout: null, versions: {} };
     const canvas = raw;
-    const warnings = validateCanvas(canvas, (rel) => resolveBoardFile(boardDir, rel) !== null);
-    return { canvas, warnings, layout: computeLayout(canvas), versions: boardVersions(boardDir, canvas) };
+    const pending = /* @__PURE__ */ new Set();
+    const warnings = validateCanvas(canvas, (rel) => resolveBoardFile(boardDir, rel) !== null, {
+      pending,
+      allowPending: canvas.building === true
+    });
+    const versions = boardVersions(boardDir, canvas);
+    for (const [id2, board] of Object.entries(canvas.boards)) {
+      if (!versions[board.file]) pending.add(id2);
+    }
+    return { canvas, warnings, pending: [...pending].sort(), layout: computeLayout(canvas), versions };
   } catch (err) {
     return {
       canvas: null,
       warnings: [`canvas.json could not be checked: ${err.message}`],
+      pending: [],
       layout: null,
       versions: {}
     };
@@ -2150,7 +2176,12 @@ function writeArtifactState(stateDir, ref, payload, extra = {}) {
   if (ref.type === "artboard") {
     writeJsonAtomic(import_node_path5.default.join(dir, "layout.json"), { checkedAt, ...payload.layout ?? { pages: {} } });
   }
-  writeJsonAtomic(import_node_path5.default.join(dir, "warnings.json"), { checkedAt, warnings: payload.warnings, ...extra });
+  writeJsonAtomic(import_node_path5.default.join(dir, "warnings.json"), {
+    checkedAt,
+    warnings: payload.warnings,
+    ...payload.pending ? { pending: payload.pending } : {},
+    ...extra
+  });
 }
 
 // src/server/document-comments.ts
@@ -36460,7 +36491,7 @@ decorateMethods(EphemeralStoreWasm.prototype, [
 ]);
 decorateMethods(UndoManager.prototype, ["undo", "redo"]);
 
-// node_modules/.pnpm/@haklex+rich-collab-loro@0.49.0_lexical@0.52.0_typescript@5.9.3__loro-crdt@1.16.4/node_modules/@haklex/rich-collab-loro/dist/index.mjs
+// node_modules/.pnpm/@haklex+rich-collab-loro@0.50.0_lexical@0.52.0_typescript@5.9.3__loro-crdt@1.16.4/node_modules/@haklex/rich-collab-loro/dist/index.mjs
 function transformOffset(previous, next, offset) {
   const limit = Math.min(previous.length, next.length);
   let prefix = 0;
@@ -67871,7 +67902,7 @@ var UNORDERED_LIST2 = mod28.UNORDERED_LIST;
 var isTableRowDivider2 = mod28.isTableRowDivider;
 var registerMarkdownShortcuts2 = mod28.registerMarkdownShortcuts;
 
-// node_modules/.pnpm/@haklex+rich-headless@0.49.1_lexical@0.52.0_typescript@5.9.3__typescript@5.9.3/node_modules/@haklex/rich-headless/dist/transformers.mjs
+// node_modules/.pnpm/@haklex+rich-headless@0.50.0_lexical@0.52.0_typescript@5.9.3__typescript@5.9.3/node_modules/@haklex/rich-headless/dist/transformers.mjs
 var NEVER = /a^/;
 var NOOP = () => {
 };
@@ -70528,7 +70559,7 @@ var signal2 = mod43.signal;
 var untracked2 = mod43.untracked;
 var watchedSignal3 = mod43.watchedSignal;
 
-// node_modules/.pnpm/@haklex+rich-headless@0.49.1_lexical@0.52.0_typescript@5.9.3__typescript@5.9.3/node_modules/@haklex/rich-headless/dist/index.mjs
+// node_modules/.pnpm/@haklex+rich-headless@0.50.0_lexical@0.52.0_typescript@5.9.3__typescript@5.9.3/node_modules/@haklex/rich-headless/dist/index.mjs
 var builtinNodes = [
   HeadingNode2,
   QuoteNode2,
@@ -71321,7 +71352,7 @@ function customAlphabet(alphabet, defaultSize = 21) {
 }
 var nanoid2 = customAlphabet(urlAlphabet2);
 
-// node_modules/.pnpm/@haklex+rich-litexml@0.49.1_typescript@5.9.3/node_modules/@haklex/rich-litexml/dist/src-COIhAhyB.js
+// node_modules/.pnpm/@haklex+rich-litexml@0.50.0_typescript@5.9.3/node_modules/@haklex/rich-litexml/dist/src-COIhAhyB.js
 var impl = null;
 function registerParseHTML(fn5) {
   impl = fn5;
@@ -83425,7 +83456,7 @@ function Document4() {
 }
 setPrototypeOf(Document4, Document2).prototype = Document2.prototype;
 
-// node_modules/.pnpm/@haklex+rich-litexml@0.49.1_typescript@5.9.3/node_modules/@haklex/rich-litexml/dist/node.mjs
+// node_modules/.pnpm/@haklex+rich-litexml@0.50.0_typescript@5.9.3/node_modules/@haklex/rich-litexml/dist/node.mjs
 registerParseHTML((html) => parseHTML2(html).document);
 
 // src/server/balance.ts
@@ -83902,7 +83933,10 @@ var RUNTIME = `(() => {
     const reason = event.reason;
     post({ type: 'ryugi:error', message: 'unhandled rejection: ' + String((reason && reason.message) || reason) });
   });
-  const fields = () => Array.from(document.querySelectorAll('input, select, textarea, details'));
+  const fields = () =>
+    Array.from(document.querySelectorAll('input, select, textarea, details, [data-ryugi-control]')).filter(
+      (el) => el.hasAttribute('data-ryugi-control') || !el.closest('[data-ryugi-control]'),
+    );
   const keyOf = (el, index) => {
     if (el.id) return '#' + el.id;
     if (el.type === 'radio') return 'radio:' + el.name + ':' + el.value;
@@ -83920,7 +83954,12 @@ var RUNTIME = `(() => {
       const state = { scroll: [scrollX, scrollY], fields: {} };
       fields().forEach((el, index) => {
         const key = keyOf(el, index);
-        if (el.tagName === 'DETAILS') state.fields[key] = { open: el.open };
+        if (el.hasAttribute('data-ryugi-control')) {
+          const saved = {};
+          if ('value' in el && el.value !== undefined) saved.value = el.value;
+          if (typeof el.checked === 'boolean') saved.checked = el.checked;
+          state.fields[key] = saved;
+        } else if (el.tagName === 'DETAILS') state.fields[key] = { open: el.open };
         else if (el.type === 'checkbox' || el.type === 'radio') state.fields[key] = { checked: el.checked };
         else if (el.type !== 'file' && el.type !== 'password') state.fields[key] = { value: el.value };
       });
@@ -83930,7 +83969,20 @@ var RUNTIME = `(() => {
       fields().forEach((el, index) => {
         const saved = data.state.fields[keyOf(el, index)];
         if (!saved) return;
-        if ('open' in saved) el.open = saved.open;
+        if (el.hasAttribute('data-ryugi-control')) {
+          let changed = false;
+          if ('value' in saved && el.value !== saved.value) {
+            el.value = saved.value;
+            changed = true;
+          }
+          if ('checked' in saved && el.checked !== saved.checked) {
+            el.checked = saved.checked;
+            changed = true;
+          }
+          if (changed) {
+            el.dispatchEvent(new CustomEvent('ryugi-change', { bubbles: true, detail: { value: el.value, checked: el.checked } }));
+          }
+        } else if ('open' in saved) el.open = saved.open;
         else if ('checked' in saved) {
           if (el.checked !== saved.checked) {
             el.checked = saved.checked;
@@ -83949,11 +84001,14 @@ var RUNTIME = `(() => {
 var HEAD = /<head(\s[^>]*)?>/i;
 var PROLOGUE = /^\s*(<!doctype[^>]*>)?\s*(<html(\s[^>]*)?>)?/i;
 var RUNTIME_LINE = RUNTIME.split("\n").map((line) => line.trim()).join(" ");
-function injectRuntime(html) {
+var UI_MARKER = /<ryugi-[a-z0-9-]+(?:\s|>)/i;
+var UI_META = /<meta[^>]+name=["']ryugi-ui["'][^>]*>/i;
+function injectRuntime(html, options = {}) {
   const tag = `<script>${RUNTIME_LINE}</script>`;
+  const ui2 = options.uiRuntimeUrl && (UI_MARKER.test(html) || UI_META.test(html)) ? `<script defer src="${options.uiRuntimeUrl.replace(/"/g, "&quot;")}"></script>` : "";
   const head = HEAD.exec(html);
   const at7 = head ? head.index + head[0].length : PROLOGUE.exec(html)?.[0].length ?? 0;
-  return html.slice(0, at7) + tag + html.slice(at7);
+  return html.slice(0, at7) + tag + ui2 + html.slice(at7);
 }
 
 // src/server/http.ts
@@ -84230,6 +84285,7 @@ function titleOf(payload, ref) {
 async function startArtifactsServer(options) {
   const root = import_node_path10.default.resolve(options.root);
   const viewerDir = import_node_path10.default.resolve(options.viewerDir);
+  const runtimeDir = options.runtimeDir ? import_node_path10.default.resolve(options.runtimeDir) : null;
   const stateDir = import_node_path10.default.join(root, ".state");
   import_node_fs10.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
   import_node_fs10.default.writeFileSync(import_node_path10.default.join(stateDir, ".gitignore"), "*\n");
@@ -84341,6 +84397,20 @@ async function startArtifactsServer(options) {
   };
   const isAuthorized = (req, keyFromQuery) => keyFromQuery !== null && safeEqual(keyFromQuery, token) || safeEqual(parseCookies(req.headers.cookie)[cookieName] ?? "", token);
   const serveContent = (res, rest) => {
+    if (rest.startsWith("runtime/")) {
+      if (!runtimeDir) {
+        send(res, 404, "Not found");
+        return;
+      }
+      const relative2 = rest.slice("runtime/".length);
+      const target2 = resolveInside(runtimeDir, relative2);
+      if (!target2) {
+        send(res, 403, "Forbidden");
+        return;
+      }
+      sendFile(res, target2, { "Access-Control-Allow-Origin": "*", "Cache-Control": "public, max-age=3600" });
+      return;
+    }
     const [type = "", id2 = "", ...parts] = rest.split("/");
     const dir = resolveArtifactDir(root, type, id2);
     if (!dir) {
@@ -84366,7 +84436,10 @@ async function startArtifactsServer(options) {
     }
     import_node_fs10.default.readFile(target, "utf8", (err, source) => {
       if (err) send(res, 404, "Not found");
-      else send(res, 200, injectRuntime(source), { "Content-Type": "text/html; charset=utf-8", ...headers });
+      else {
+        const uiRuntimeUrl = runtimeDir ? `${contentPrefix}runtime/ryugi-ui.js` : void 0;
+        send(res, 200, injectRuntime(source, { uiRuntimeUrl }), { "Content-Type": "text/html; charset=utf-8", ...headers });
+      }
     });
   };
   const serveArtifactApi = (res, type, id2) => {
@@ -84514,8 +84587,10 @@ async function startArtifactsServer(options) {
     signatures.set(`${ref.type}/${ref.id}`, artifactSignature(dir));
     return writeState(ref, dir);
   };
+  const initialChanges = [];
   for (const entry of listArtifacts(root).artifacts) {
-    refreshState(entry, entry.dir);
+    const payload = refreshState(entry, entry.dir);
+    initialChanges.push({ ref: entry, payload, files: [] });
     if (entry.type === "document") void documents.open(entry.id);
   }
   writeJsonAtomic(import_node_path10.default.join(stateDir, "server-info"), { type: "server-started", url, port, root });
@@ -84558,7 +84633,10 @@ async function startArtifactsServer(options) {
     url,
     linkFor,
     clientCount: () => clients.size,
-    onArtifactChange: (listener) => changeListeners.push(listener),
+    onArtifactChange: (listener) => {
+      changeListeners.push(listener);
+      for (const change of initialChanges) listener(change.ref, change.payload, change.files);
+    },
     onActivity: (listener) => activityListeners.push(listener),
     close: () => new Promise((resolve) => {
       watcher.close();
@@ -84591,8 +84669,9 @@ function parseEnv(env, argv = []) {
     urlHost,
     idleTimeoutMs: positive(env.ARTIFACTS_IDLE_TIMEOUT_MS, DEFAULT_IDLE_TIMEOUT_MS),
     lifecycleCheckMs: positive(env.ARTIFACTS_LIFECYCLE_CHECK_MS, DEFAULT_LIFECYCLE_CHECK_MS),
-    open: env.ARTIFACTS_OPEN === "1",
+    open: env.ARTIFACTS_OPEN !== "0",
     openCmd: env.ARTIFACTS_OPEN_CMD || null,
+    openArtifact: env.ARTIFACTS_OPEN_ARTIFACT || null,
     serverId: serverIdArg ? serverIdArg.slice(SERVER_ID_ARG.length) : null
   };
 }
@@ -84627,6 +84706,39 @@ function processAlive(pid) {
   }
 }
 
+// src/server/ready.ts
+var pageOfGroup = (canvas, ids) => ids.map((id2) => canvas.boards[id2]?.page).find((page) => Boolean(page));
+function openReady(payload) {
+  const canvas = payload.canvas;
+  if (!canvas || payload.warnings.length > 0) return false;
+  const boards = Object.entries(canvas.boards);
+  if (boards.length === 0) return false;
+  const pending = new Set(payload.pending);
+  const ready = (id2) => {
+    const board = canvas.boards[id2];
+    if (!board) return false;
+    return (payload.versions[board.file] ?? 0) > 0 && !pending.has(id2);
+  };
+  if (boards.every(([id2]) => ready(id2))) return true;
+  const focus = canvas.focus?.target;
+  const focusBoard = focus && canvas.boards[focus] ? focus : void 0;
+  const focusGroupId = focus ? canvas.groups?.[focus] ? focus : focusBoard ? Object.entries(canvas.groups ?? {}).find(([, group]) => group.boards.includes(focusBoard))?.[0] : void 0 : void 0;
+  const focusGroup = focusGroupId ? canvas.groups?.[focusGroupId] : void 0;
+  if (focusGroup && focusGroup.boards.length > 0) return focusGroup.boards.every(ready);
+  const targetPage = (focusBoard ? canvas.boards[focusBoard].page : void 0) ?? (focusGroup ? pageOfGroup(canvas, focusGroup.boards) : void 0) ?? canvas.activePage ?? canvas.pages[0]?.id;
+  if (!targetPage) return false;
+  const groups = Object.entries(canvas.groups ?? {}).filter(
+    ([, group]) => group.boards.some((id2) => canvas.boards[id2]?.page === targetPage)
+  );
+  for (const [, group] of groups) {
+    if (group.boards.length > 0 && group.boards.every(ready)) return true;
+  }
+  if (groups.length > 0) return false;
+  const pageBoards = boards.filter(([, board]) => board.page === targetPage);
+  if (pageBoards.length === 1) return ready(pageBoards[0][0]);
+  return pageBoards.filter(([id2]) => ready(id2)).length >= 2;
+}
+
 // src/server/main.ts
 async function main() {
   const config = parseEnv(process.env, process.argv.slice(2));
@@ -84635,6 +84747,7 @@ async function main() {
   const server = await startArtifactsServer({
     root,
     viewerDir: import_node_path11.default.join(__dirname, "viewer"),
+    runtimeDir: import_node_path11.default.join(__dirname, "runtime"),
     host: config.host,
     urlHost: config.urlHost
   });
@@ -84645,8 +84758,8 @@ async function main() {
   let browserOpened = false;
   server.onArtifactChange((ref, payload) => {
     if (browserOpened || !config.open || !isLoopback(config.host)) return;
-    if ("canvas" in payload && (!payload.canvas || Object.keys(payload.canvas.boards ?? {}).length === 0)) return;
-    if ("title" in payload && payload.warnings.length > 0) return;
+    if (config.openArtifact && `${ref.type}/${ref.id}` !== config.openArtifact) return;
+    if ("canvas" in payload ? !openReady(payload) : payload.warnings.length > 0) return;
     browserOpened = true;
     if (server.clientCount() > 0) return;
     const link = server.linkFor(ref.type, ref.id);