@abraca/nuxt 2.11.0 → 2.13.0

package/dist/runtime/utils/docTypes.js

@@ -138,6 +138,19 @@ export const DOC_TYPES = {
       () => import("../components/renderers/ATableRenderer.vue")
     )
   },
+  sheets: {
+    key: "sheets",
+    label: "Sheets",
+    icon: "i-lucide-grid-3x3",
+    description: "Spreadsheet \u2014 cells, formulas, and formatting in a collaborative grid",
+    available: true,
+    supportsChildren: true,
+    childLabel: "Column",
+    grandchildLabel: "Cell",
+    component: defineDocComponent(
+      () => import("../components/renderers/ASheetsRenderer.client.vue")
+    )
+  },
   outline: {
     key: "outline",
     label: "Outline",
@@ -226,6 +239,24 @@ export const DOC_TYPES = {
       () => import("../components/renderers/AGraphRenderer.vue")
     )
   },
+  chart: {
+    key: "chart",
+    label: "Chart",
+    icon: "i-lucide-bar-chart-3",
+    description: "Charts \u2014 manual data points or aggregation over document trees",
+    available: true,
+    supportsChildren: true,
+    childLabel: "Data Point",
+    grandchildLabel: "Data Point",
+    component: defineDocComponent(
+      () => import("../components/renderers/AChartRenderer.client.vue")
+    ),
+    metaSchema: [
+      { type: "number", key: "number", step: 0.01, label: "Value" },
+      { type: "colorPreset", key: "color", presets: ["#6366f1", "#ec4899", "#f97316", "#22c55e", "#3b82f6", "#a855f7", "#14b8a6", "#eab308"], label: "Color" },
+      { type: "tags", key: "tags", label: "Tags" }
+    ]
+  },
   dashboard: {
     key: "dashboard",
     label: "Dashboard",
@@ -271,6 +302,18 @@ export const DOC_TYPES = {
       { type: "select", key: "slidesTransition", options: ["none", "fade", "slide"], label: "Transition" },
       { type: "colorPreset", key: "color", presets: ["#6366f1", "#ec4899", "#f97316", "#22c55e", "#3b82f6", "#a855f7"], label: "Accent" }
     ]
+  },
+  overview: {
+    key: "overview",
+    label: "Overview",
+    icon: "i-lucide-radar",
+    description: "Space home \u2014 activity, people, stats, and health at a glance",
+    available: true,
+    supportsChildren: true,
+    childLabel: "Page",
+    component: defineDocComponent(
+      () => import("../components/renderers/AOverviewRenderer.vue")
+    )
   }
 };
 export const DEFAULT_DOC_TYPE = DOC_TYPES.doc;

package/dist/runtime/utils/titleSync.d.ts

@@ -0,0 +1,130 @@
+/**
+ * titleSync — pure decision logic for keeping the H1 documentHeader and the
+ * tree-entry `label` field in agreement, plus a defensive `setHeaderText`.
+ *
+ * The two sources of truth are:
+ *  - the `documentHeader` Y.XmlElement inside the child doc's Y.XmlFragment
+ *    (rendered by TipTap as the H1 at the top of the page);
+ *  - the `label` field on the doc's tree entry in the root provider's treeMap
+ *    (rendered by the sidebar, breadcrumb, browser title, etc.).
+ *
+ * Past regressions in this area lost user titles because:
+ *  - the editor mounted on an empty Y.XmlFragment, y-prosemirror seeded an
+ *    empty documentHeader, then the server snapshot arrived with the real
+ *    title and the local empty got merged in — sometimes winning the
+ *    "canonical pick" inside enforceDocumentShape;
+ *  - the post-sync flow only wrote header → tree on LOCAL updates, so a
+ *    server-delivered title never reflected back into the tree label and the
+ *    sidebar stayed stuck on "Untitled";
+ *  - the tree-label → header watcher unconditionally called
+ *    `setHeaderText(editor, newLabel || '')`, which on a transient
+ *    `newLabel = undefined` would erase the user's title.
+ *
+ * `decideTitleSync` is the canonical answer for "what should I do given the
+ * current state of both sides?", returning one of three actions. It is pure
+ * so it can be exhaustively table-tested.
+ *
+ * `setHeaderText` is the only sanctioned way for the renderer to write into
+ * the documentHeader. It refuses to overwrite a non-empty header with an
+ * empty string unless the caller passes `force: true`.
+ *
+ * Ported 1:1 from cou-sh/app/utils/titleSync.ts.
+ */
+/** Sentinel placeholder label used by the tree when no real label has been set. */
+export declare const UNTITLED = "Untitled";
+/**
+ * The tree label is "empty" — meaning it carries no user-supplied title —
+ * when it's the empty string, null/undefined, or the literal placeholder
+ * `"Untitled"`. The two former cases come from a freshly-created tree row
+ * (no label yet); the latter comes from `useChildTree.renameEntry`
+ * canonicalising a cleared title to `"Untitled"` so the UI never has to
+ * render `null`.
+ */
+export declare function isEmptyTreeLabel(label: string | null | undefined): boolean;
+export type TitleSyncAction = {
+    kind: 'noop';
+} | {
+    kind: 'header-from-tree';
+    text: string;
+} | {
+    kind: 'tree-from-header';
+    label: string;
+};
+export interface TitleSyncInput {
+    /** Text content of the `documentHeader` node (what TipTap renders). */
+    headerText: string;
+    /**
+     * Current tree-entry label, or null/undefined if the entry hasn't loaded.
+     * Caller is expected to fall back to `props.docLabel` before passing in.
+     */
+    treeLabel: string | null | undefined;
+    /**
+     * True when the originating ProseMirror transaction was driven by a Yjs
+     * remote update (i.e. `transaction.getMeta('y-sync$')?.isChangeOrigin`).
+     * Used to disambiguate "the user just typed this" from "the server told
+     * us this".
+     */
+    isRemoteUpdate: boolean;
+    /**
+     * Whether `syncHeader` has already performed its first-mount reconciliation
+     * for this editor instance. Set by the caller; the first call must pass
+     * `false` and every subsequent call must pass `true`.
+     */
+    initialSyncDone: boolean;
+}
+/**
+ * Decide what (if anything) needs to change to keep the header and the tree
+ * label in agreement.
+ *
+ * The truth table — every cell is pinned by `test/title-sync-decision.test.ts`:
+ *
+ *  ┌──────────────┬───────────────────┬───────────────────────────────────────┐
+ *  │ headerText   │ treeLabel         │ result                                │
+ *  ├──────────────┼───────────────────┼───────────────────────────────────────┤
+ *  │ empty        │ empty/Untitled    │ noop (no information either way)      │
+ *  │ same         │ same              │ noop                                  │
+ *  │ has text     │ empty/Untitled    │ tree-from-header (RESCUE — incl.      │
+ *  │              │                   │   remote: server delivered the title  │
+ *  │              │                   │   via the doc fragment, tree needs    │
+ *  │              │                   │   to catch up)                        │
+ *  │ empty        │ has text          │ initial OR remote → header-from-tree  │
+ *  │              │                   │ local + post-initial → tree-from-     │
+ *  │              │                   │   header('Untitled') (user emptied    │
+ *  │              │                   │   the title, so canonicalise)         │
+ *  │ different    │ different         │ initial OR local → tree-from-header   │
+ *  │              │                   │ remote + post-initial → noop (the     │
+ *  │              │                   │   label watcher reconciles header     │
+ *  │              │                   │   from tree if needed)                │
+ *  └──────────────┴───────────────────┴───────────────────────────────────────┘
+ */
+export declare function decideTitleSync(input: TitleSyncInput): TitleSyncAction;
+export interface SetHeaderTextOptions {
+    /**
+     * Allow overwriting a non-empty `documentHeader` with an empty string.
+     * Default `false`. The watcher on the tree label MUST NOT pass `true` — a
+     * transient `newLabel = undefined` during reload would otherwise erase the
+     * user's title. Setting `force: true` is reserved for the explicit "user
+     * emptied the title locally" path.
+     */
+    force?: boolean;
+}
+/**
+ * Replace the inline text content of the first `documentHeader` node in
+ * `ed.state.doc`. Refuses the write when:
+ *  - there is no documentHeader at index 0;
+ *  - the header already has the requested text (cheap no-op);
+ *  - the user's selection is inside the header (an external sync echo must
+ *    never clobber in-flight typing);
+ *  - `text` is empty AND the existing header is non-empty AND `force`
+ *    wasn't passed (the no-destroy invariant).
+ *
+ * Returns `true` if a transaction was dispatched, `false` otherwise. Used
+ * by tests to assert the no-destroy invariant.
+ */
+export declare function setHeaderText(ed: {
+    state: any;
+    view: {
+        dispatch: (tr: any) => void;
+        hasFocus?: () => boolean;
+    };
+}, text: string, opts?: SetHeaderTextOptions): boolean;

package/dist/runtime/utils/titleSync.js

@@ -0,0 +1,53 @@
+import { Fragment } from "@tiptap/pm/model";
+export const UNTITLED = "Untitled";
+export function isEmptyTreeLabel(label) {
+  return !label || label === UNTITLED;
+}
+export function decideTitleSync(input) {
+  const { headerText, treeLabel, isRemoteUpdate, initialSyncDone } = input;
+  const treeEmpty = isEmptyTreeLabel(treeLabel);
+  const headerEmpty = isEmptyTreeLabel(headerText);
+  if (treeEmpty && headerEmpty) return { kind: "noop" };
+  if (!headerEmpty && !treeEmpty && headerText === treeLabel) {
+    return { kind: "noop" };
+  }
+  if (!headerEmpty && treeEmpty) {
+    return { kind: "tree-from-header", label: headerText };
+  }
+  if (headerEmpty && !treeEmpty) {
+    if (!initialSyncDone) {
+      return { kind: "header-from-tree", text: treeLabel };
+    }
+    if (isRemoteUpdate) {
+      return { kind: "header-from-tree", text: treeLabel };
+    }
+    return { kind: "noop" };
+  }
+  if (!initialSyncDone) {
+    return { kind: "tree-from-header", label: headerText };
+  }
+  if (!isRemoteUpdate) {
+    return { kind: "tree-from-header", label: headerText };
+  }
+  return { kind: "noop" };
+}
+export function setHeaderText(ed, text, opts = {}) {
+  const first = ed.state.doc.firstChild;
+  if (!first || first.type.name !== "documentHeader") return false;
+  if (first.textContent === text) return false;
+  const hasFocus = typeof ed.view.hasFocus === "function" ? ed.view.hasFocus() : false;
+  if (hasFocus) {
+    const { $head } = ed.state.selection;
+    if ($head?.parent?.type?.name === "documentHeader") return false;
+  }
+  if (!text && first.textContent && !opts.force) return false;
+  const { tr, schema } = ed.state;
+  const to = 1 + first.content.size;
+  if (text) {
+    tr.replaceWith(1, to, schema.text(text));
+  } else {
+    tr.replaceWith(1, to, Fragment.empty);
+  }
+  ed.view.dispatch(tr);
+  return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/nuxt",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "First-class Nuxt module for the Abracadabra CRDT collaboration platform",
   "repository": "abracadabra/abracadabra-nuxt",
   "license": "MIT",
@@ -70,6 +70,8 @@
     "@tiptap/extension-text-style": "^3.0.0",
     "@tiptap/starter-kit": "^3.0.0",
     "@tiptap/vue-3": "^3.0.0",
+    "@unovis/ts": "^1.6.5",
+    "@unovis/vue": "^1.6.5",
     "d3-force": "^3.0.0",
     "jszip": "^3.0.0",
     "lowlight": "^3.0.0",
@@ -131,6 +133,12 @@
     },
     "@tiptap/extension-emoji": {
       "optional": true
+    },
+    "@unovis/vue": {
+      "optional": true
+    },
+    "@unovis/ts": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -163,6 +171,8 @@
     "@types/d3-force": "^3.0.10",
     "@types/node": "latest",
     "@types/ws": "^8.18.1",
+    "@unovis/ts": "^1.6.5",
+    "@unovis/vue": "^1.6.5",
     "@vue/test-utils": "^2.4.10",
     "changelogen": "^0.6.2",
     "d3-force": "^3.0.0",