smoodly 0.0.15 → 0.0.17

package/dist/admin/forms/RichtextElementCard.js

@@ -2,16 +2,19 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // The element node view (spec 2026-09-08 block nodes §3): the node view IS
 // the form — a header (icon, title, collapse, delete) and the element's
-// fields then styles through FieldWidget, reading and writing attrs.
+// fields then settings through FieldWidget, reading and writing attrs.
 // A richtext field inside mounts a nested RichtextWidget with its own
-// toolset. Errors come from the enclosing form under
+// toolset. Settings sit under a divider; a field hidden by a condition
+// leaves the card — the element's own values are the scope (spec
+// 2026-09-14 §12). Errors come from the enclosing form under
 // `<path>.elements.<i>.<key>`, i being this node's index among the
 // document's element nodes. Collapse is component state only: a card
 // starts collapsed (2026-09-09) unless it holds nothing yet — a freshly
 // inserted element opens, so its fields can be filled straight away.
 import { useState } from "react";
 import { NodeViewWrapper } from "@tiptap/react";
-import { IconButton } from "../ui/primitives.js";
+import { isHidden } from "../../conditions.js";
+import { IconButton, SectionLabel } from "../ui/primitives.js";
 import { FieldWidget } from "./FieldWidget.js";
 import { useElements } from "./elements-context.js";
 import { cardClass, useRichtextForm } from "./richtext-form-context.js";
@@ -26,12 +29,15 @@ export function RichtextElementCard({ node, editor, getPos, updateAttributes, de
     const name = String(node.attrs.name ?? "");
     const element = elements.find((e) => e.name === name);
     const fields = (node.attrs.fields && typeof node.attrs.fields === "object" ? node.attrs.fields : {});
-    const styles = (node.attrs.styles && typeof node.attrs.styles === "object" ? node.attrs.styles : {});
+    const settings = (node.attrs.settings && typeof node.attrs.settings === "object" ? node.attrs.settings : {});
     const [open, setOpen] = useState(() => isBlank(fields));
     const pos = getPos();
     const index = typeof pos === "number" ? elementIndexAt(editor.state.doc, pos) : 0;
     const base = `${form.path}.elements.${index}`;
     const select = () => { if (typeof pos === "number")
         editor.commands.setNodeSelection(pos); };
-    return (_jsxs(NodeViewWrapper, { className: cardClass(selected, form.canvas), "data-theme": form.canvas ? "light" : undefined, children: [_jsxs("div", { className: "sm-rtcard__head", "data-drag-handle": true, onClick: select, children: [_jsx("span", { className: "sm-rtcard__icon", "aria-hidden": "true", children: element?.icon ?? "▤" }), _jsx("span", { className: "sm-rtcard__title", children: element?.title ?? `Unknown element "${name}"` }), _jsx(IconButton, { label: open ? "Collapse" : "Expand", onClick: (e) => { e.stopPropagation(); setOpen((o) => !o); }, children: open ? "▾" : "▸" }), _jsx(IconButton, { label: "Delete element", onClick: (e) => { e.stopPropagation(); deleteNode(); }, children: "\u00D7" })] }), open && element && (_jsxs("div", { className: "sm-rtcard__body", contentEditable: false, children: [Object.entries(element.fields).map(([key, d]) => (_jsx(FieldWidget, { fieldKey: key, descriptor: d, value: fields[key], errors: form.errors, path: `${base}.${key}`, onChange: (v) => updateAttributes({ fields: { ...fields, [key]: v } }) }, key))), Object.entries(element.styles).map(([key, d]) => (_jsx(FieldWidget, { fieldKey: key, descriptor: d, value: styles[key], path: `${base}.styles.${key}`, onChange: (v) => updateAttributes({ styles: { ...styles, [key]: v } }) }, `style-${key}`)))] }))] }));
+    const scope = { fields, settings };
+    const visibleFields = Object.entries(element?.fields ?? {}).filter(([, d]) => !isHidden(d, { self: fields, ...scope }));
+    const visibleSettings = Object.entries(element?.settings ?? {}).filter(([, d]) => !isHidden(d, { self: settings, ...scope }));
+    return (_jsxs(NodeViewWrapper, { className: cardClass(selected, form.canvas), "data-theme": form.canvas ? "light" : undefined, children: [_jsxs("div", { className: "sm-rtcard__head", "data-drag-handle": true, onClick: select, children: [_jsx("span", { className: "sm-rtcard__icon", "aria-hidden": "true", children: element?.icon ?? "▤" }), _jsx("span", { className: "sm-rtcard__title", children: element?.title ?? `Unknown element "${name}"` }), _jsx(IconButton, { label: open ? "Collapse" : "Expand", onClick: (e) => { e.stopPropagation(); setOpen((o) => !o); }, children: open ? "▾" : "▸" }), _jsx(IconButton, { label: "Delete element", onClick: (e) => { e.stopPropagation(); deleteNode(); }, children: "\u00D7" })] }), open && element && (_jsxs("div", { className: "sm-rtcard__body", contentEditable: false, children: [visibleFields.map(([key, d]) => (_jsx(FieldWidget, { fieldKey: key, descriptor: d, value: fields[key], errors: form.errors, path: `${base}.${key}`, scope: scope, onChange: (v) => updateAttributes({ fields: { ...fields, [key]: v } }) }, key))), visibleSettings.length > 0 && _jsx(SectionLabel, { mono: true, children: "Settings" }), visibleSettings.map(([key, d]) => (_jsx(FieldWidget, { fieldKey: key, descriptor: d, value: settings[key], errors: form.errors, path: `${base}.settings.${key}`, scope: scope, onChange: (v) => updateAttributes({ settings: { ...settings, [key]: v } }) }, `setting-${key}`)))] }))] }));
 }

package/dist/admin/forms/RowsWidget.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement } from "react";
+import type { AdminField } from "../serialize.ts";
+import { type CustomRow } from "../../custom/index.ts";
+export declare function RowsWidget({ descriptor, value, onChange, errors, path, inlinePath, onEditHere }: {
+    descriptor: AdminField;
+    value: unknown;
+    onChange(rows: CustomRow[]): void;
+    errors?: Record<string, string>;
+    path: string;
+    /** The path of the column being edited in the canvas: its widget yields to a note. */
+    inlinePath?: string;
+    onEditHere?(): void;
+}): ReactElement;

package/dist/admin/forms/RowsWidget.js

@@ -0,0 +1,26 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, Field, IconButton, Switch } from "../ui/primitives.js";
+import { FieldWidget, InlineNote } from "./FieldWidget.js";
+import { RichtextWidget } from "./RichtextWidget.js";
+import { SpanBar } from "./SpanBar.js";
+import { moveItem, removeItem } from "./list.js";
+import { MAX_COLUMNS, defaultRow, presetsFor, setColumnCount } from "../../custom/index.js";
+const isRow = (r) => typeof r === "object" && r !== null && Array.isArray(r.columns) && Array.isArray(r.spans);
+export function RowsWidget({ descriptor, value, onChange, errors, path, inlinePath, onEditHere }) {
+    const rows = Array.isArray(value) ? value.filter(isRow) : [];
+    const item = descriptor.item?.fields ?? {};
+    const columnDescriptor = (item.columns?.item ?? { type: "richtext" });
+    const patch = (i, row) => onChange(rows.map((r, j) => (j === i ? row : r)));
+    return (_jsxs("div", { className: "sm-rowcards", children: [rows.map((row, i) => {
+                const n = row.columns.length;
+                const base = `${path}.${i}`;
+                const presets = presetsFor(n);
+                return (_jsxs("div", { className: "sm-rowcard", "data-sm-path": base, children: [_jsxs("div", { className: "sm-rowcard__head", children: [_jsxs("span", { className: "sm-rowcard__title", children: ["Row ", i + 1] }), _jsx(IconButton, { label: "Move up", disabled: i === 0, onClick: () => onChange(moveItem(rows, i, i - 1)), children: "\u2191" }), _jsx(IconButton, { label: "Move down", disabled: i === rows.length - 1, onClick: () => onChange(moveItem(rows, i, i + 1)), children: "\u2193" }), _jsx(IconButton, { label: "Remove row", disabled: rows.length === 1, onClick: () => onChange(removeItem(rows, i)), children: "\u00D7" })] }), _jsx(Field, { label: "Columns", asDiv: true, error: errors?.[`${base}.columns`] ?? errors?.[`${base}.spans`], children: _jsxs("div", { className: "sm-stepper", children: [_jsx(IconButton, { label: "Fewer columns", disabled: n <= 1, onClick: () => patch(i, setColumnCount(row, n - 1)), children: "\u2212" }), _jsx("span", { className: "sm-stepper__value", children: n }), _jsx(IconButton, { label: "More columns", disabled: n >= MAX_COLUMNS, onClick: () => patch(i, setColumnCount(row, n + 1)), children: "+" })] }) }), n > 1 && (_jsxs(_Fragment, { children: [_jsxs(Field, { label: "Widths", asDiv: true, path: `${base}.spans`, children: [_jsx(SpanBar, { spans: row.spans, onChange: (spans) => patch(i, { ...row, spans }) }), presets.length > 0 && (_jsx("div", { className: "sm-rowcard__presets", children: presets.map((p) => (_jsx(Button, { variant: "secondary", onClick: () => patch(i, { ...row, spans: p.spans }), children: p.label }, p.label))) }))] }), _jsx(FieldWidget, { fieldKey: "gap", descriptor: item.gap, value: row.gap, path: `${base}.gap`, onChange: (v) => patch(i, { ...row, gap: v }) }), _jsx(FieldWidget, { fieldKey: "verticalAlign", descriptor: item.align, value: row.align, path: `${base}.align`, onChange: (v) => patch(i, { ...row, align: v }) }), _jsx(Field, { label: "Reverse on mobile", asDiv: true, path: `${base}.reverse`, children: _jsx(Switch, { checked: row.reverse === true, onChange: (v) => patch(i, { ...row, reverse: v }), label: "Reverse on mobile" }) })] })), row.columns.map((doc, j) => {
+                            const colPath = `${base}.columns.${j}`;
+                            return (_jsx(Field, { label: `Column ${j + 1}`, asDiv: true, path: colPath, error: errors?.[colPath], children: inlinePath === colPath
+                                    ? _jsx(InlineNote, { onEditHere: onEditHere })
+                                    : _jsx(RichtextWidget, { value: doc, toolset: columnDescriptor.toolset, errors: errors, path: colPath, onChange: (next) => patch(i, { ...row, columns: row.columns.map((c, k) => (k === j ? next : c)) }) }) }, j));
+                        })] }, i));
+            }), _jsx(Button, { variant: "secondary", onClick: () => onChange([...rows, defaultRow()]), children: "+ Add row" })] }));
+}

package/dist/admin/forms/SpanBar.d.ts

@@ -0,0 +1,5 @@
+import { type ReactElement } from "react";
+export declare function SpanBar({ spans, onChange }: {
+    spans: number[];
+    onChange(spans: number[]): void;
+}): ReactElement;

package/dist/admin/forms/SpanBar.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The width bar (spec 2026-09-14 §6): one box per column sized by its
+// span, a handle on each boundary dragged in twelfths (pointer events on
+// the bar's own width — no library) or nudged with the arrow keys.
+import { useRef } from "react";
+import { setSpan, spanAtX } from "../../custom/index.js";
+export function SpanBar({ spans, onChange }) {
+    const bar = useRef(null);
+    const drag = (handle) => (e) => {
+        const el = bar.current;
+        if (!el)
+            return;
+        e.preventDefault();
+        e.currentTarget.setPointerCapture(e.pointerId);
+        const rect = el.getBoundingClientRect();
+        let current = spans;
+        const move = (ev) => {
+            const next = setSpan(current, handle, spanAtX(ev.clientX - rect.left, rect.width, current, handle));
+            if (next[handle] !== current[handle]) {
+                current = next;
+                onChange(next);
+            }
+        };
+        const up = () => { window.removeEventListener("pointermove", move); window.removeEventListener("pointerup", up); };
+        window.addEventListener("pointermove", move);
+        window.addEventListener("pointerup", up);
+    };
+    const key = (handle) => (e) => {
+        const delta = e.key === "ArrowLeft" ? -1 : e.key === "ArrowRight" ? 1 : 0;
+        if (delta === 0)
+            return;
+        e.preventDefault();
+        onChange(setSpan(spans, handle, spans[handle] + delta));
+    };
+    return (_jsx("div", { className: "sm-spanbar", ref: bar, children: spans.map((s, i) => (_jsxs("div", { className: "sm-spanbar__col", style: { flex: s }, children: [s, i < spans.length - 1 && (_jsx("button", { type: "button", className: "sm-spanbar__handle", role: "slider", "aria-label": `Resize columns ${i + 1} and ${i + 2}`, "aria-valuemin": 1, "aria-valuemax": s + spans[i + 1] - 1, "aria-valuenow": s, onPointerDown: drag(i), onKeyDown: key(i) }))] }, `c${i}`))) }));
+}

package/dist/admin/forms/richtext-insert.d.ts

@@ -18,7 +18,7 @@ export type ElementNodeJSON = {
     attrs: {
         name: string;
         fields: Record<string, unknown>;
-        styles: Record<string, unknown>;
+        settings: Record<string, unknown>;
     };
 };
 export type ImageNodeJSON = {
@@ -31,7 +31,7 @@ export type ImageNodeJSON = {
         caption: string;
     };
 };
-/** A fresh element: sample first, then the empties, styles from their defaults — as a section insertion does. */
+/** A fresh element: sample first, then the empties, settings from their defaults — as a section insertion does. */
 export declare function elementNode(element: AdminElement): ElementNodeJSON;
 export declare function imageNode(assetId: string): ImageNodeJSON;
 /** How many element nodes precede `pos` — the validator's `elements.<i>` index. */

package/dist/admin/forms/richtext-insert.js

@@ -15,10 +15,10 @@ export function filterItems(items, query) {
     const q = query.trim().toLowerCase();
     return q === "" ? items : items.filter((i) => i.title.toLowerCase().includes(q));
 }
-/** A fresh element: sample first, then the empties, styles from their defaults — as a section insertion does. */
+/** A fresh element: sample first, then the empties, settings from their defaults — as a section insertion does. */
 export function elementNode(element) {
-    const { fields, styles } = nodeFromSample(element, "");
-    return { type: "element", attrs: { name: element.name, fields, styles: styles ?? {} } };
+    const { fields, settings } = nodeFromSample(element, "");
+    return { type: "element", attrs: { name: element.name, fields, settings: settings ?? {} } };
 }
 export function imageNode(assetId) {
     return { type: "image", attrs: { image: { asset: assetId }, caption: "" } };

package/dist/admin/forms/richtext-nodes.js

@@ -36,7 +36,7 @@ export const ElementNode = Node.create({
     atom: true,
     draggable: true,
     addAttributes() {
-        return { name: { default: "" }, fields: jsonAttr("fields", {}), styles: jsonAttr("styles", {}) };
+        return { name: { default: "" }, fields: jsonAttr("fields", {}), settings: jsonAttr("settings", {}) };
     },
     parseHTML() { return [{ tag: "div[data-smoodly-element]" }]; },
     renderHTML({ HTMLAttributes }) { return ["div", mergeAttributes({ "data-smoodly-element": "" }, HTMLAttributes)]; },

package/dist/admin/forms/tabs.d.ts

@@ -1,14 +1,26 @@
-import type { AdminField, AdminSection } from "../serialize.ts";
-export type TabName = "Content" | "Styles" | "Media" | "Meta";
+import type { AdminField } from "../serialize.ts";
+export type TabName = "Content" | "Settings";
+export type GroupTitle = "Spacing & layout" | "Advanced";
 export type TabEntry = {
     key: string;
-    ns: "fields" | "styles" | "meta";
+    ns: "fields" | "settings" | "styles" | "css";
     descriptor: AdminField;
 };
-export declare function tabsFor(section: AdminSection): {
-    tab: TabName;
+export type Group = {
+    title?: GroupTitle;
     entries: TabEntry[];
+};
+/** A section, an element (no styles, no css) or a global item. */
+export type FieldsHolder = {
+    fields: Record<string, AdminField>;
+    settings?: Record<string, AdminField>;
+    styles?: Record<string, AdminField>;
+    css?: boolean;
+};
+export declare const CSS_DESCRIPTOR: AdminField;
+export declare function tabsFor(holder: FieldsHolder): {
+    tab: TabName;
+    groups: Group[];
 }[];
-/** The tab holding a content field, by its dotted path's top-level key — a canvas
- *  click on a marked image reveals it on Media, where the projection put it. */
-export declare function tabOf(section: AdminSection, path: string): TabName | undefined;
+/** The tab a dotted path belongs to, by its top-level key — a canvas click reveals it there. */
+export declare function tabOf(holder: FieldsHolder, path: string): TabName | undefined;

package/dist/admin/forms/tabs.js

@@ -1,26 +1,22 @@
-const MEDIA_TYPES = new Set(["image", "video", "file"]);
-const TAB_BY_NS = {
-    fields: "Content", styles: "Styles", meta: "Meta",
-};
-const TAB_BY_OVERRIDE = {
-    content: "Content", styles: "Styles", media: "Media", meta: "Meta",
-};
-export function tabsFor(section) {
-    const buckets = { Content: [], Styles: [], Media: [], Meta: [] };
-    for (const ns of ["fields", "styles", "meta"]) {
-        for (const [key, descriptor] of Object.entries(section[ns] ?? {})) {
-            const override = typeof descriptor.tab === "string" ? TAB_BY_OVERRIDE[descriptor.tab] : undefined;
-            const tab = override ?? (MEDIA_TYPES.has(descriptor.type) ? "Media" : TAB_BY_NS[ns]);
-            buckets[tab].push({ key, ns, descriptor });
-        }
-    }
-    return ["Content", "Styles", "Media", "Meta"]
-        .filter((tab) => buckets[tab].length > 0)
-        .map((tab) => ({ tab, entries: buckets[tab] }));
+export const CSS_DESCRIPTOR = { type: "css" };
+const entries = (ns, map) => Object.entries(map ?? {}).map(([key, descriptor]) => ({ key, ns, descriptor }));
+export function tabsFor(holder) {
+    const content = [{ entries: entries("fields", holder.fields) }];
+    const settings = [
+        { entries: entries("settings", holder.settings) },
+        { title: "Spacing & layout", entries: entries("styles", holder.styles) },
+        { title: "Advanced", entries: holder.css === true ? [{ key: "css", ns: "css", descriptor: CSS_DESCRIPTOR }] : [] },
+    ];
+    return [["Content", content], ["Settings", settings]]
+        .map(([tab, groups]) => ({ tab, groups: groups.filter((g) => g.entries.length > 0) }))
+        .filter((t) => t.groups.length > 0);
 }
-/** The tab holding a content field, by its dotted path's top-level key — a canvas
- *  click on a marked image reveals it on Media, where the projection put it. */
-export function tabOf(section, path) {
+/** The tab a dotted path belongs to, by its top-level key — a canvas click reveals it there. */
+export function tabOf(holder, path) {
     const key = path.split(".")[0];
-    return tabsFor(section).find((t) => t.entries.some((e) => e.ns === "fields" && e.key === key))?.tab;
+    if (key in holder.fields)
+        return "Content";
+    if (key in (holder.settings ?? {}) || key in (holder.styles ?? {}) || (key === "css" && holder.css === true))
+        return "Settings";
+    return undefined;
 }

package/dist/admin/forms/useRichtextEditor.js

@@ -135,7 +135,14 @@ export function useRichtextEditor({ value, toolset, onChange, contentClass, onEs
         if (!editor || value === emitted.current)
             return;
         emitted.current = value;
-        editor.commands.setContent(isDoc(value) ? value : EMPTY, { emitUpdate: false });
+        // TipTap's React node views (the image and element cards) flush React synchronously inside
+        // setContent, which React forbids from a lifecycle effect ("flushSync was called from inside a
+        // lifecycle method"). One microtask later React is idle; a widget unmounted meanwhile is skipped.
+        const next = isDoc(value) ? value : EMPTY;
+        queueMicrotask(() => {
+            if (!editor.isDestroyed)
+                editor.commands.setContent(next, { emitUpdate: false });
+        });
     }, [editor, value]);
     const active = useEditorState({
         editor,

package/dist/admin/global-items.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedConfig } from "../config.ts";
+import type { Descriptor } from "../fields.ts";
+import type { EntryRecord, EntryStore } from "../entry-store.ts";
+import { type GlobalSchema } from "../global.ts";
+/** The merged fields a fresh item starts from: sampled field values, and
+ *  for a visual item `$settings` = the section's settings defaults with the
+ *  sample's settings values on top. Unsampled fields stay absent. */
+export declare function initialGlobalFields(item: GlobalSchema, settingsDescriptors: Record<string, Descriptor>): Record<string, unknown>;
+export declare function ensureGlobalItems(entries: EntryStore, config: ResolvedConfig): Promise<Record<string, EntryRecord>>;

package/dist/admin/{shared-items.js → global-items.js}

@@ -1,8 +1,9 @@
-import { STYLES_KEY } from "../shared.js";
+import { SETTINGS_KEY } from "../global.js";
+import { sectionSettings } from "./serialize.js";
 /** The merged fields a fresh item starts from: sampled field values, and
- *  for a visual item `$styles` = the resolved style defaults with the
- *  sample's style values on top. Unsampled fields stay absent. */
-export function initialSharedFields(item, resolvedStyles) {
+ *  for a visual item `$settings` = the section's settings defaults with the
+ *  sample's settings values on top. Unsampled fields stay absent. */
+export function initialGlobalFields(item, settingsDescriptors) {
     const out = {};
     for (const key of Object.keys(item.fields)) {
         const sampled = item.sample?.[key];
@@ -10,25 +11,25 @@ export function initialSharedFields(item, resolvedStyles) {
             out[key] = sampled;
     }
     if (item.section !== undefined) {
-        const styles = {};
-        for (const [key, d] of Object.entries(resolvedStyles)) {
+        const settings = {};
+        for (const [key, d] of Object.entries(settingsDescriptors)) {
             const value = item.sample?.[key] ?? d.default;
             if (value !== undefined)
-                styles[key] = value;
+                settings[key] = value;
         }
-        out[STYLES_KEY] = styles;
+        out[SETTINGS_KEY] = settings;
     }
     return out;
 }
-export async function ensureSharedItems(entries, config) {
+export async function ensureGlobalItems(entries, config) {
     const { default: def, supported } = config.locales;
     const out = {};
-    for (const item of config.registry.shared ?? []) {
+    for (const item of config.registry.globals ?? []) {
         let [record] = await entries.list(item.name);
         if (!record) {
             try {
-                const styles = item.section !== undefined ? config.resolvedStyles(item.section) : {};
-                record = await entries.create(item.name, initialSharedFields(item, styles), { locale: def });
+                const settings = item.section !== undefined ? sectionSettings(config, item.section) : {};
+                record = await entries.create(item.name, initialGlobalFields(item, settings), { locale: def });
             }
             catch (e) {
                 const message = e instanceof Error ? e.message : String(e);
@@ -37,7 +38,7 @@ export async function ensureSharedItems(entries, config) {
                 if (message.includes("it is a singleton"))
                     [record] = await entries.list(item.name);
                 else
-                    console.warn(`smoodly: could not materialize shared item "${item.name}": ${message}`);
+                    console.warn(`smoodly: could not materialize global item "${item.name}": ${message}`);
                 if (!record)
                     continue;
             }
@@ -51,10 +52,24 @@ export async function ensureSharedItems(entries, config) {
             catch (e) {
                 const message = e instanceof Error ? e.message : String(e);
                 if (!message.includes("already exists in locale")) {
-                    console.warn(`smoodly: could not materialize shared item "${item.name}" in "${locale}": ${message}`);
+                    console.warn(`smoodly: could not materialize global item "${item.name}" in "${locale}": ${message}`);
                 }
             }
         }
+        // Every global item is versioned (decided 2026-09-13). A row published before that has
+        // no pointers, so its next save would go live: publish it once more here, which snapshots
+        // what is live and points both pointers at it. Idempotent — pointed rows are skipped.
+        for (const locale of supported) {
+            const row = record.locales[locale];
+            if (!row || row.status !== "published" || row.publishedVersionId !== null)
+                continue;
+            try {
+                record = await entries.setStatus(item.name, record.id, locale, "published");
+            }
+            catch (e) {
+                console.warn(`smoodly: could not version global item "${item.name}" in "${locale}": ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
         out[item.name] = record;
     }
     return out;

package/dist/admin/index.d.ts

@@ -1,11 +1,11 @@
-export type { AdminOps, AdminOpCall, AdminOpAction, OpResult, OpError, PageCreateInput, PageGetResult, SharedListItem, SharedGetResult, AssetUsageItem } from "./ops.ts";
+export type { AdminOps, AdminOpCall, AdminOpAction, OpResult, OpError, PageCreateInput, PageGetResult, GlobalListItem, GlobalGetResult, AssetUsageItem } from "./ops.ts";
 export { createAdminOps, runAdminOp, type AdminEffects } from "./ops-impl.ts";
 export { fixedNodeSpecs, fixedNodeOf, ensureFixedNodes, type FixedNode } from "./fixed-nodes.ts";
-export { ensureSharedItems, initialSharedFields } from "./shared-items.ts";
+export { ensureGlobalItems, initialGlobalFields } from "./global-items.ts";
 export { makeClientOps } from "./client-ops.ts";
 export { gateAdminOp, type AdminAuth } from "./auth.ts";
 export { supabaseAdminAuth } from "./supabase-auth.ts";
 export { serializeAdminConfig } from "./serialize.ts";
-export type { AdminRegistry, AdminSection, AdminCollection, AdminPageTemplate, AdminShared, AdminField } from "./serialize.ts";
+export type { AdminRegistry, AdminSection, AdminCollection, AdminPageTemplate, AdminGlobal, AdminField } from "./serialize.ts";
 export * from "./tree-ops.ts";
 export { validateFields, type FieldError } from "./validate.ts";

package/dist/admin/index.js

@@ -1,6 +1,6 @@
 export { createAdminOps, runAdminOp } from "./ops-impl.js";
 export { fixedNodeSpecs, fixedNodeOf, ensureFixedNodes } from "./fixed-nodes.js";
-export { ensureSharedItems, initialSharedFields } from "./shared-items.js";
+export { ensureGlobalItems, initialGlobalFields } from "./global-items.js";
 export { makeClientOps } from "./client-ops.js";
 export { gateAdminOp } from "./auth.js";
 export { supabaseAdminAuth } from "./supabase-auth.js";

package/dist/admin/next/op-handler.js

@@ -7,7 +7,7 @@ import { draftMode } from "next/headers";
 import { gateAdminOp } from "../auth.js";
 import { createAdminOps, runAdminOp } from "../ops-impl.js";
 export function createAdminOpHandler(deps) {
-    const ops = createAdminOps({
+    const base = {
         config: deps.config,
         pages: deps.pages,
         entries: deps.entries,
@@ -24,6 +24,7 @@ export function createAdminOpHandler(deps) {
                 disable: async () => (await draftMode()).disable(),
             },
         },
-    });
-    return (call) => gateAdminOp(deps.auth, call, (c) => runAdminOp(ops, c));
+    };
+    // Ops are built per call so the verified session rides into every store write as `by` (spec 2026-09-13 history §2).
+    return (call) => gateAdminOp(deps.auth, call, (c, session) => runAdminOp(createAdminOps({ ...base, actor: session }), c));
 }

package/dist/admin/ops-impl.d.ts

@@ -3,6 +3,7 @@ import type { EntryStore } from "../entry-store.ts";
 import type { AssetStore } from "../asset-store.ts";
 import type { PageStore } from "../store.ts";
 import type { AdminOpCall, AdminOps, OpResult } from "./ops.ts";
+import type { AdminSession } from "./auth.ts";
 export type AdminEffects = {
     /** Expire one cache tag (`pageTag(id)` / `entryTag(id)`). */
     revalidate?(tag: string): void;
@@ -20,6 +21,8 @@ export declare function createAdminOps(deps: {
     href?: (path: string, locale: string) => string;
     /** The media library; absent = every assets op answers "no media store". */
     assets?: AssetStore;
+    /** The verified editor; their email is every write's `by`. Absent for the seed and tests (spec 2026-09-13 history §2). */
+    actor?: AdminSession;
 }): AdminOps;
 /** Path-dispatch for the one-server-action seam. Own-property checks only —
  * "constructor.constructor" and prototype paths must not resolve. */