studiograph 1.3.48-next.21 → 1.3.48-next.211

package/dist/core/artifact-export.js

@@ -0,0 +1,529 @@
+import { encodeBase64, escapeAttribute, escapeHtml, escapeScript, escapeStyle, } from './artifact-escape.js';
+import { appendAssetToken } from './artifact-asset-urls.js';
+function stripNetworkAssetTags(html) {
+    return html
+        .replace(/<link\b(?=[^>]*\brel\s*=\s*(?:"[^"]*\bstylesheet\b[^"]*"|'[^']*\bstylesheet\b[^']*'|[^\s>]*stylesheet[^\s>]*))[^>]*>/gi, '')
+        .replace(/<script\b(?=[^>]*\bsrc\s*=)[^>]*>[\s\S]*?<\/script\s*>/gi, '');
+}
+function scriptTypeFromAttributes(attrs) {
+    const match = attrs.match(/\btype\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i);
+    return (match?.[1] ?? match?.[2] ?? match?.[3] ?? null)?.trim().toLowerCase() ?? null;
+}
+function executableScriptKind(attrs) {
+    const type = scriptTypeFromAttributes(attrs);
+    if (!type || type === 'text/javascript' || type === 'application/javascript' || type === 'text/ecmascript' || type === 'application/ecmascript') {
+        return 'classic';
+    }
+    return type === 'module' ? 'module' : null;
+}
+function scriptKindForPath(path) {
+    return path.toLowerCase().endsWith('.mjs') ? 'module' : 'classic';
+}
+function deferInlineScripts(html) {
+    const scripts = [];
+    const nextHtml = html.replace(/<script\b((?:(?!\bsrc\s*=)[^>])*)>([\s\S]*?)<\/script\s*>/gi, (match, attrs, js) => {
+        const kind = executableScriptKind(attrs);
+        if (!kind)
+            return match;
+        if (js.trim())
+            scripts.push({ path: `inline-${scripts.length + 1}.${kind === 'module' ? 'mjs' : 'js'}`, js, kind });
+        return '';
+    });
+    return { html: nextHtml, scripts };
+}
+function styleTags(bundle) {
+    return Object.entries(bundle.files)
+        .filter(([path]) => path.toLowerCase().endsWith('.css'))
+        .map(([path, css]) => `<style data-artifact-file="${escapeAttribute(path)}">\n${escapeStyle(css)}\n</style>`)
+        .join('\n');
+}
+function requestedLibraries(bundle) {
+    return bundle.libraries ?? [];
+}
+function libraryTags(bundle, sources = {}) {
+    const libraries = requestedLibraries(bundle);
+    if (libraries.length === 0)
+        return '';
+    const tags = [];
+    for (const library of libraries) {
+        if (library === 'd3' || library === 'motion') {
+            const source = sources[library];
+            if (!source)
+                continue;
+            tags.push(`<script data-artifact-library="${library}">\n${escapeScript(source)}\n</script>`);
+        }
+    }
+    const asyncInitializers = [];
+    if (libraries.includes('three') && sources.three) {
+        asyncInitializers.push(`
+      const decodeLibrarySource = (base64) => {
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+        return new TextDecoder().decode(bytes);
+      };
+      const threeSource = decodeLibrarySource(${JSON.stringify(encodeBase64(sources.three))});
+      const threeCoreSource = ${sources.threeCore ? `decodeLibrarySource(${JSON.stringify(encodeBase64(sources.threeCore))})` : "''"};
+      const threeCoreUrl = threeCoreSource
+        ? URL.createObjectURL(new Blob([threeCoreSource], { type: 'text/javascript' }))
+        : null;
+      const threeModuleSource = threeCoreUrl
+        ? threeSource.replace(/from\\s*(['"])\\.\\/three\\.core\\.min\\.js\\1/g, 'from ' + JSON.stringify(threeCoreUrl))
+        : threeSource;
+      const threeUrl = URL.createObjectURL(new Blob([threeModuleSource], { type: 'text/javascript' }));
+      try {
+        window.THREE = await import(threeUrl);
+      } finally {
+        URL.revokeObjectURL(threeUrl);
+        if (threeCoreUrl) URL.revokeObjectURL(threeCoreUrl);
+      }
+    `);
+    }
+    tags.push(`<script data-artifact-libraries-ready>
+window.__STUDIOGRAPH_ARTIFACT_LIBRARIES__ = ${JSON.stringify(libraries)};
+window.__STUDIOGRAPH_ARTIFACT_LIBRARIES_READY__ = (async () => {
+${asyncInitializers.join('\n')}
+  return true;
+})().catch((error) => {
+  console.error('Artifact library load failed', error);
+  throw error;
+});
+</script>`);
+    return tags.join('\n');
+}
+function scriptTags(bundle, inlineScripts = []) {
+    const jsEntries = Object.entries(bundle.files)
+        .filter(([path]) => /\.(m?js)$/i.test(path))
+        .map(([path, js]) => ({ path, js, kind: scriptKindForPath(path) }));
+    if (requestedLibraries(bundle).length > 0) {
+        const payload = JSON.stringify([...inlineScripts, ...jsEntries]);
+        return `<script data-artifact-user-scripts>
+(async () => {
+  await (window.__STUDIOGRAPH_ARTIFACT_LIBRARIES_READY__ || Promise.resolve());
+  const scripts = ${escapeScript(payload)};
+  const scriptUrls = [];
+  for (const script of scripts) {
+    await new Promise((resolve, reject) => {
+      const url = URL.createObjectURL(new Blob([
+        String(script.js) + '\\n//# sourceURL=studiograph-artifact://' + String(script.path)
+      ], { type: 'text/javascript' }));
+      scriptUrls.push(url);
+      if (script.kind === 'module') {
+        import(url).then(resolve, reject);
+        return;
+      }
+      const element = document.createElement('script');
+      element.src = url;
+      element.async = false;
+      element.dataset.artifactFile = String(script.path);
+      element.onload = () => resolve();
+      element.onerror = () => reject(new Error('Could not load artifact script: ' + String(script.path)));
+      document.head.appendChild(element);
+    });
+  }
+  if (document.readyState !== 'loading') {
+    try { document.dispatchEvent(new Event('DOMContentLoaded', { bubbles: true, cancelable: true })); } catch {}
+  }
+  if (document.readyState === 'complete') {
+    try { window.dispatchEvent(new Event('load')); } catch {}
+  }
+  setTimeout(() => {
+    for (const url of scriptUrls) URL.revokeObjectURL(url);
+  }, 0);
+})().catch((error) => {
+  console.error('Artifact script error', error);
+  throw error;
+});
+</script>`;
+    }
+    return jsEntries
+        .map(({ path, js, kind }) => `<script${kind === 'module' ? ' type="module"' : ''} data-artifact-file="${escapeAttribute(path)}">\n${escapeScript(js)}\n</script>`)
+        .join('\n');
+}
+function standaloneFullscreenRuntimeTags(bundle, options) {
+    const stepper = options.context === 'fullscreen' ? bundle.display?.controls?.stepper : null;
+    if (!stepper)
+        return '';
+    const selector = typeof stepper.selector === 'string' && stepper.selector.trim()
+        ? stepper.selector.trim()
+        : '[data-artifact-frame]';
+    return `<script data-artifact-standalone-runtime>
+(() => {
+  const selector = ${JSON.stringify(selector)};
+  let activeIndex = 0;
+  const frames = () => {
+    try { return Array.from(document.querySelectorAll(selector)).filter((node) => node instanceof HTMLElement); }
+    catch { return []; }
+  };
+  const setActiveFrame = (index) => {
+    const allFrames = frames();
+    if (allFrames.length === 0) return;
+    activeIndex = Math.max(0, Math.min(allFrames.length - 1, Number.isFinite(index) ? Math.round(index) : 0));
+    allFrames.forEach((frame, frameIndex) => {
+      const active = frameIndex === activeIndex;
+      frame.classList.toggle('active', active);
+      frame.toggleAttribute('data-studiograph-active-frame', active);
+      frame.setAttribute('aria-hidden', active ? 'false' : 'true');
+    });
+    try { history.replaceState(null, '', '#' + String(activeIndex + 1)); } catch {}
+  };
+  const stepFrame = (direction) => {
+    const allFrames = frames();
+    if (allFrames.length === 0) return;
+    setActiveFrame((activeIndex + direction + allFrames.length) % allFrames.length);
+  };
+  const initialize = () => {
+    const allFrames = frames();
+    if (allFrames.length === 0) return;
+    const activeFrameIndex = allFrames.findIndex((frame) => frame.classList.contains('active') || frame.hasAttribute('data-studiograph-active-frame'));
+    const hashIndex = /^#\\d+$/.test(location.hash) ? Number(location.hash.slice(1)) - 1 : -1;
+    setActiveFrame(hashIndex >= 0 ? hashIndex : activeFrameIndex >= 0 ? activeFrameIndex : 0);
+  };
+  window.addEventListener('keydown', (event) => {
+    if (event.altKey || event.ctrlKey || event.metaKey) return;
+    if (event.key === 'ArrowRight' || event.key === 'PageDown' || event.key === ' ') {
+      stepFrame(1);
+      event.preventDefault();
+      return;
+    }
+    if (event.key === 'ArrowLeft' || event.key === 'PageUp' || event.key === 'Backspace') {
+      stepFrame(-1);
+      event.preventDefault();
+      return;
+    }
+    if (event.key === 'Home') {
+      setActiveFrame(0);
+      event.preventDefault();
+      return;
+    }
+    if (event.key === 'End') {
+      setActiveFrame(frames().length - 1);
+      event.preventDefault();
+    }
+  });
+  window.addEventListener('click', (event) => {
+    if (event.target instanceof Element && event.target.closest('a,button,input,textarea,select,summary,[contenteditable="true"],[role="button"],[data-artifact-no-stepper]')) return;
+    if (frames().length <= 1) return;
+    stepFrame(event.clientX < window.innerWidth * 0.2 ? -1 : 1);
+    event.preventDefault();
+  }, { capture: true });
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', initialize, { once: true });
+  else initialize();
+})();
+</script>`;
+}
+function addAttributesToHtmlTag(html, attrs) {
+    if (!/<html[\s>]/i.test(html))
+        return html;
+    return html.replace(/<html\b([^>]*)>/i, (match, existingAttrs) => {
+        let nextAttrs = existingAttrs;
+        for (const [name, value] of Object.entries(attrs)) {
+            if (value === undefined || value === false)
+                continue;
+            if (new RegExp(`\\b${name}\\s*=`, 'i').test(nextAttrs))
+                continue;
+            nextAttrs = ` ${name}${value === true ? '' : `="${escapeAttribute(value)}"`}${nextAttrs}`;
+        }
+        return `<html${nextAttrs}>`;
+    });
+}
+function headAdditions(bundle, entry, options) {
+    const additions = [
+        '<meta charset="utf-8">',
+        options.baseHref ? `<base href="${escapeAttribute(options.baseHref)}">` : '',
+        '<meta name="generator" content="Studiograph Artifact Canvas">',
+        /<title[\s>]/i.test(entry) ? '' : `<title>${escapeHtml(bundle.title)}</title>`,
+        styleTags(bundle),
+        options.includeRenderHostStyles ? artifactRenderHostStyleTags(bundle) : '',
+    ];
+    return additions.filter(Boolean).join('\n');
+}
+function withDoctype(html) {
+    return /^\s*<!doctype\b/i.test(html) ? html : `<!doctype html>\n${html}`;
+}
+export function artifactExportFilename(bundle, extension = 'html') {
+    const source = bundle.title || bundle.artifactId || 'artifact';
+    const slug = source
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80);
+    return `${slug || 'artifact'}.${extension}`;
+}
+function artifactRenderHostStyleTags(bundle) {
+    const viewport = bundle.display?.fullscreenViewport ?? bundle.viewport;
+    const frameWidth = `${Math.max(1, Math.round(viewport.width))}px`;
+    const frameHeight = `${Math.max(1, Math.round(viewport.height))}px`;
+    const authoredPageSizing = bundle.viewport.mode === 'paged';
+    const exportFrameSizing = authoredPageSizing
+        ? '  contain: layout paint !important;'
+        : `  width: var(--studiograph-export-frame-width) !important;
+  height: var(--studiograph-export-frame-height) !important;
+  min-width: var(--studiograph-export-frame-width) !important;
+  min-height: var(--studiograph-export-frame-height) !important;
+  max-width: var(--studiograph-export-frame-width) !important;
+  max-height: var(--studiograph-export-frame-height) !important;
+  contain: layout paint size !important;`;
+    const exportFlattening = `
+html[data-artifact-context="export"] {
+  --studiograph-export-frame-width: ${frameWidth};
+  --studiograph-export-frame-height: ${frameHeight};
+}
+html[data-artifact-context="export"],
+html[data-artifact-context="export"] body {
+  width: 100% !important;
+  min-height: 100% !important;
+  height: auto !important;
+  overflow: visible !important;
+}
+html[data-artifact-context="export"] .artifact-sequence,
+html[data-artifact-context="export"] .deck,
+html[data-artifact-context="export"] .pages,
+html[data-artifact-context="export"] .document-board,
+html[data-artifact-context="export"] .artifact-board,
+html[data-artifact-context="export"] [data-artifact-layout="sequence"],
+html[data-artifact-context="export"] [data-artifact-layout="paged"] {
+  width: 100% !important;
+  height: auto !important;
+  min-height: 0 !important;
+  padding: 0 !important;
+  margin: 0 !important;
+  display: flex !important;
+  flex-direction: column !important;
+  align-items: center !important;
+  justify-content: flex-start !important;
+  gap: 0 !important;
+  overflow: visible !important;
+  background: transparent !important;
+  box-shadow: none !important;
+}
+html[data-artifact-context="export"] [data-artifact-frame],
+html[data-artifact-context="export"] [data-artifact-page],
+html[data-artifact-context="export"] .page {
+  display: block !important;
+  position: relative !important;
+  box-sizing: border-box !important;
+${exportFrameSizing}
+  isolation: isolate !important;
+  clip-path: inset(0) !important;
+  inset: auto !important;
+  left: auto !important;
+  top: auto !important;
+  right: auto !important;
+  bottom: auto !important;
+  transform: none !important;
+  margin: 0 !important;
+  flex: none !important;
+  overflow: hidden !important;
+}
+`;
+    const stepperFullscreen = bundle.display?.controls?.stepper
+        ? `
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"],
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] body {
+  width: 100% !important;
+  height: 100% !important;
+  min-height: 100% !important;
+  overflow: hidden !important;
+}
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] .artifact-sequence,
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] .deck,
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] [data-artifact-layout="sequence"] {
+  width: 100% !important;
+  height: 100% !important;
+  min-height: 100% !important;
+  padding: 0 !important;
+  margin: 0 !important;
+  display: block !important;
+  position: relative !important;
+  overflow: hidden !important;
+  background: transparent !important;
+  box-shadow: none !important;
+}
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] [data-artifact-frame] {
+  display: none !important;
+  position: absolute !important;
+  inset: 0 auto auto 0 !important;
+  margin: 0 !important;
+}
+html[data-artifact-context="fullscreen"][data-artifact-stepper="true"] [data-artifact-frame][data-studiograph-active-frame] {
+  display: block !important;
+}
+`
+        : '';
+    const pagedFullscreen = bundle.viewport.mode === 'paged'
+        ? `
+html[data-artifact-context="fullscreen"],
+html[data-artifact-context="fullscreen"] body {
+  width: 100% !important;
+  min-height: 100% !important;
+  overflow: auto !important;
+}
+html[data-artifact-context="fullscreen"] .pages,
+html[data-artifact-context="fullscreen"] .document-board,
+html[data-artifact-context="fullscreen"] .artifact-board[data-artifact-layout="paged"],
+html[data-artifact-context="fullscreen"] [data-artifact-layout="paged"] {
+  width: 100% !important;
+  height: auto !important;
+  min-height: 100% !important;
+  padding: 48px 0 !important;
+  display: flex !important;
+  flex-direction: column !important;
+  align-items: center !important;
+  justify-content: flex-start !important;
+  align-content: center !important;
+  gap: 32px !important;
+  background: transparent !important;
+  box-shadow: none !important;
+  overflow: visible !important;
+}
+html[data-artifact-context="fullscreen"] .page,
+html[data-artifact-context="fullscreen"] [data-artifact-page] {
+  position: relative !important;
+  left: auto !important;
+  right: auto !important;
+  top: auto !important;
+  bottom: auto !important;
+  transform: none !important;
+}
+`
+        : '';
+    const printPagination = `
+@media print {
+  html[data-artifact-context="fullscreen"],
+  html[data-artifact-context="fullscreen"] body,
+  html[data-artifact-context="export"],
+  html[data-artifact-context="export"] body {
+    height: auto !important;
+    min-height: 0 !important;
+    overflow: visible !important;
+  }
+  html[data-artifact-context="fullscreen"] .artifact-sequence,
+  html[data-artifact-context="fullscreen"] .deck,
+  html[data-artifact-context="fullscreen"] .pages,
+  html[data-artifact-context="fullscreen"] .document-board,
+  html[data-artifact-context="fullscreen"] [data-artifact-layout="sequence"],
+  html[data-artifact-context="fullscreen"] [data-artifact-layout="paged"],
+  html[data-artifact-context="export"] .artifact-sequence,
+  html[data-artifact-context="export"] .deck,
+  html[data-artifact-context="export"] .pages,
+  html[data-artifact-context="export"] .document-board,
+  html[data-artifact-context="export"] .artifact-board,
+  html[data-artifact-context="export"] [data-artifact-layout="sequence"],
+  html[data-artifact-context="export"] [data-artifact-layout="paged"] {
+    display: block !important;
+    width: 100% !important;
+    height: auto !important;
+    min-height: 0 !important;
+    padding: 0 !important;
+    margin: 0 !important;
+    overflow: visible !important;
+    background: transparent !important;
+    box-shadow: none !important;
+  }
+  html[data-artifact-context="fullscreen"] [data-artifact-frame],
+  html[data-artifact-context="fullscreen"] [data-artifact-page],
+  html[data-artifact-context="fullscreen"] .page,
+  html[data-artifact-context="export"] [data-artifact-frame],
+  html[data-artifact-context="export"] [data-artifact-page],
+  html[data-artifact-context="export"] .page {
+    display: block !important;
+    position: relative !important;
+    box-sizing: border-box !important;
+${exportFrameSizing}
+    isolation: isolate !important;
+    clip-path: inset(0) !important;
+    inset: auto !important;
+    left: auto !important;
+    top: auto !important;
+    right: auto !important;
+    bottom: auto !important;
+    transform: none !important;
+    margin: 0 !important;
+    overflow: hidden !important;
+    break-after: page;
+    page-break-after: always;
+  }
+  html[data-artifact-context="fullscreen"] [data-artifact-frame]:not(:first-child),
+  html[data-artifact-context="fullscreen"] [data-artifact-page]:not(:first-child),
+  html[data-artifact-context="fullscreen"] .page:not(:first-child),
+  html[data-artifact-context="export"] [data-artifact-frame]:not(:first-child),
+  html[data-artifact-context="export"] [data-artifact-page]:not(:first-child),
+  html[data-artifact-context="export"] .page:not(:first-child) {
+    break-before: page;
+    page-break-before: always;
+  }
+  html[data-artifact-context="fullscreen"] [data-artifact-frame]:last-child,
+  html[data-artifact-context="fullscreen"] [data-artifact-page]:last-child,
+  html[data-artifact-context="fullscreen"] .page:last-child,
+  html[data-artifact-context="export"] [data-artifact-frame]:last-child,
+  html[data-artifact-context="export"] [data-artifact-page]:last-child,
+  html[data-artifact-context="export"] .page:last-child {
+    break-after: auto;
+    page-break-after: auto;
+  }
+}
+`;
+    return `<style data-artifact-export-host>
+html, body {
+  margin: 0;
+  padding: 0;
+}
+${pagedFullscreen}
+${stepperFullscreen}
+${exportFlattening}
+${printPagination}
+</style>`;
+}
+export function buildArtifactHtmlExport(bundle, options = {}) {
+    // Append the capability token to asset URLs in the final document (idempotent;
+    // no-op without a token). Used by headless PNG/PDF render so its cookie-less
+    // image requests are authorized.
+    const finalize = (html) => options.assetToken ? appendAssetToken(html, options.assetToken) : html;
+    const rawEntry = stripNetworkAssetTags(bundle.files[bundle.entrypoint] ?? '');
+    const deferred = requestedLibraries(bundle).length > 0 ? deferInlineScripts(rawEntry) : { html: rawEntry, scripts: [] };
+    const entry = deferred.html;
+    const styles = headAdditions(bundle, entry, options);
+    const libraries = libraryTags(bundle, options.librarySources);
+    const scripts = scriptTags(bundle, deferred.scripts);
+    const runtime = standaloneFullscreenRuntimeTags(bundle, options);
+    const bodyScripts = [runtime, scripts].filter(Boolean).join('\n');
+    const htmlAttrs = options.context
+        ? {
+            'data-artifact-context': options.context,
+            'data-artifact-stepper': bundle.display?.controls?.stepper ? 'true' : undefined,
+        }
+        : {};
+    if (/<html[\s>]/i.test(entry)) {
+        let html = addAttributesToHtmlTag(entry, htmlAttrs);
+        if (/<head[\s>]/i.test(html)) {
+            html = html.replace(/<head([^>]*)>/i, `<head$1>\n${styles}\n${libraries}\n`);
+        }
+        else {
+            html = html.replace(/<html([^>]*)>/i, `<html$1>\n<head>\n${styles}\n${libraries}\n</head>`);
+        }
+        if (bodyScripts) {
+            if (/<\/body>/i.test(html)) {
+                html = html.replace(/<\/body>/i, `${bodyScripts}\n</body>`);
+            }
+            else {
+                html = `${html}\n${bodyScripts}`;
+            }
+        }
+        return finalize(withDoctype(html));
+    }
+    return finalize(`<!doctype html>
+<html${options.context ? ` data-artifact-context="${escapeAttribute(options.context)}"${bundle.display?.controls?.stepper ? ' data-artifact-stepper="true"' : ''}` : ''}>
+<head>
+${styles}
+${libraries}
+</head>
+<body>
+${entry}
+${bodyScripts}
+</body>
+</html>`);
+}
+//# sourceMappingURL=artifact-export.js.map

package/dist/core/artifact-export.js.map

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

package/dist/core/cell-anchor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Server-side validation for dataset cell-anchored comments.
+ *
+ * The full anchor model + the (pure, client-side) resolver live in the web
+ * app at `web/src/lib/utils/cell-anchor.ts` — resolution recomputes
+ * `{row, col}` against the live grid on every render and never runs on the
+ * server. The server's only job is to guard the write path: a cell comment
+ * stores its anchor JSON in the existing `anchor_relpos` column, so we must
+ * make sure (a) only datasets receive cell (JSON) anchors and (b) the JSON is
+ * structurally well-formed, so a markdown comment's base64 relpos is never
+ * confused for a cell anchor and a cell anchor is never fed to the text
+ * resolver. The two copies are intentionally small and independent (the web
+ * app does not import from `src/`).
+ */
+export interface CellAnchor {
+    kind: 'cell';
+    /** The commented row's cells at creation; absent when the snapshot was
+     *  dropped to fit `MAX_ANCHOR_RELPOS_LENGTH` (rowHash fallback). */
+    rowCells?: string[];
+    rowHash: string;
+    columnIndex: number;
+    headerName: string;
+}
+/** Cheap discriminator: a cell anchor is JSON (`{…}`); a markdown comment's
+ *  anchor is a base64 relpos blob, which never starts with `{`. */
+export declare function looksLikeCellAnchor(relpos: string | null | undefined): boolean;
+export declare function isValidCellAnchor(value: unknown): value is CellAnchor;
+/** Parse + validate a stored anchor string as a cell anchor, or null. */
+export declare function parseCellAnchor(relpos: string | null | undefined): CellAnchor | null;

package/dist/core/cell-anchor.js

@@ -0,0 +1,53 @@
+/**
+ * Server-side validation for dataset cell-anchored comments.
+ *
+ * The full anchor model + the (pure, client-side) resolver live in the web
+ * app at `web/src/lib/utils/cell-anchor.ts` — resolution recomputes
+ * `{row, col}` against the live grid on every render and never runs on the
+ * server. The server's only job is to guard the write path: a cell comment
+ * stores its anchor JSON in the existing `anchor_relpos` column, so we must
+ * make sure (a) only datasets receive cell (JSON) anchors and (b) the JSON is
+ * structurally well-formed, so a markdown comment's base64 relpos is never
+ * confused for a cell anchor and a cell anchor is never fed to the text
+ * resolver. The two copies are intentionally small and independent (the web
+ * app does not import from `src/`).
+ */
+/** Cheap discriminator: a cell anchor is JSON (`{…}`); a markdown comment's
+ *  anchor is a base64 relpos blob, which never starts with `{`. */
+export function looksLikeCellAnchor(relpos) {
+    return !!relpos && relpos[0] === '{';
+}
+export function isValidCellAnchor(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const a = value;
+    if (a.kind !== 'cell')
+        return false;
+    if (typeof a.rowHash !== 'string' || a.rowHash.length === 0)
+        return false;
+    if (typeof a.columnIndex !== 'number' || !Number.isInteger(a.columnIndex) || a.columnIndex < 0)
+        return false;
+    if (typeof a.headerName !== 'string')
+        return false;
+    if (a.rowCells !== undefined) {
+        if (!Array.isArray(a.rowCells))
+            return false;
+        if (!a.rowCells.every((c) => typeof c === 'string'))
+            return false;
+    }
+    return true;
+}
+/** Parse + validate a stored anchor string as a cell anchor, or null. */
+export function parseCellAnchor(relpos) {
+    if (!looksLikeCellAnchor(relpos))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(relpos);
+    }
+    catch {
+        return null;
+    }
+    return isValidCellAnchor(parsed) ? parsed : null;
+}
+//# sourceMappingURL=cell-anchor.js.map

package/dist/core/cell-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-anchor.js","sourceRoot":"","sources":["../../src/core/cell-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH;mEACmE;AACnE,MAAM,UAAU,mBAAmB,CAAC,MAAiC;IACpE,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7G,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,MAAiC;IAChE,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAgB,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

package/dist/core/comment-anchor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Yjs-native anchor serialization for span-anchored comments.
+ *
+ * Anchors are pairs of `Y.RelativePosition` objects pointing at the start
+ * and end of the comment’s target span. RelativePosition is symbolic
+ * (“between these two Yjs items”) rather than offset-based, so it survives
+ * concurrent edits automatically — that’s the whole reason we built on Yjs
+ * for the editor. Comments survive other users typing in front of the
+ * highlighted span, surrounding deletes, or remote rewrites, with no
+ * server-side migration logic.
+ *
+ * Wire format:
+ *   2 bytes (big-endian)  — length of start blob
+ *   start blob            — Y.encodeRelativePosition output
+ *   end blob              — Y.encodeRelativePosition output
+ *   ↓ base64-encoded for SQLite blob storage / JSON transport
+ *
+ * Resolution falls back to fuzzy-quote matching when the primary anchor
+ * resolves to null AND the original highlighted text still exists exactly
+ * once in the document — Google Docs / Hypothesis pattern. If both fail,
+ * the comment renders as orphaned with the preserved quote as context.
+ */
+import * as Y from 'yjs';
+export interface SerializedAnchor {
+    /** Base64-encoded blob for the API. */
+    relpos: string;
+    /** Original highlighted text, ≤256 chars. Falls back to “” for empty selections. */
+    quote: string;
+}
+export interface ResolvedAnchor {
+    /** Inclusive absolute offset within the live Y.Text. */
+    from: number;
+    /** Exclusive absolute offset within the live Y.Text. */
+    to: number;
+    /** True iff the Yjs RelativePosition could not resolve AND quote-fallback also failed. */
+    orphaned: boolean;
+    /** True iff the primary RelativePosition failed but the quote was found exactly once. */
+    recovered: boolean;
+}
+export declare function serializeAnchor(ytext: Y.Text, from: number, to: number): SerializedAnchor;
+export declare function resolveAnchor(ydoc: Y.Doc, ytext: Y.Text, relposBase64: string, quote: string): ResolvedAnchor;