@abraca/nuxt 0.3.0 → 1.6.0

package/dist/runtime/types.d.ts

@@ -1,7 +1,10 @@
 import type { ShallowRef, Ref, Component } from 'vue';
 import type { Extension } from '@tiptap/core';
 import type { Editor } from '@tiptap/vue-3';
+import type { Node as ProsemirrorNode } from '@tiptap/pm/model';
 import type * as Y from 'yjs';
+import type { AbracadabraClient, AbracadabraProvider, AbracadabraWS, CryptoIdentityKeystore } from '@abraca/dabra';
+import type { Router } from 'vue-router';
 /**
  * An Abracadabra plugin contributes editor extensions, page types, toolbar items,
  * slash commands, mentions, awareness fields, command palette items, and more.
@@ -34,7 +37,7 @@ export interface AbracadabraPlugin {
     /** Extra drag-handle menu items (per-block context menu) */
     dragHandleItems?: (ctx: DragHandlePluginCtx) => AbracadabraDragHandleItem[][];
     /** Custom editor handlers merged into UEditorCustomHandlers */
-    customHandlers?: () => Record<string, (...args: any[]) => any>;
+    customHandlers?: () => Record<string, (...args: unknown[]) => unknown>;
     /** Mention (@) providers contributing items to the mention popup */
     mentionProviders?: AbracadabraMentionProvider[];
     /** Awareness field declarations — keys this plugin reads/writes on awareness */
@@ -51,14 +54,14 @@ export interface AbracadabraPlugin {
      * Client-side setup hook — called once after client + provider are ready.
      * May return a teardown function called on app unmount.
      */
-    clientSetup?: (ctx: ClientPluginCtx) => void | Promise<void | (() => void)>;
+    clientSetup?: (ctx: ClientPluginCtx) => undefined | Promise<undefined | (() => void)>;
     /** TipTap extensions safe for server-side Y.Doc → HTML rendering (no Vue NodeViews) */
     serverExtensions?: () => Extension[];
     /**
      * Custom cache renderer for non-doc page types.
      * Receives the Y.Doc and returns serializable data for the cache.
      */
-    serverCacheRenderer?: (docId: string, ydoc: Y.Doc) => any;
+    serverCacheRenderer?: (docId: string, ydoc: Y.Doc) => unknown;
     /**
      * Server-side background runners (Nitro context).
      * Each runner receives a ServerRunnerContext and returns a cleanup function.
@@ -78,7 +81,7 @@ export interface EditorPluginCtx {
 /** Context passed to drag-handle plugin hooks */
 export interface DragHandlePluginCtx extends EditorPluginCtx {
     selectedNode: Ref<{
-        node: any | null;
+        node: ProsemirrorNode | null;
         pos: number;
     } | undefined>;
 }
@@ -130,9 +133,30 @@ export interface AbracadabraDragHandleItem {
 }
 export interface CommandPaletteCtx {
     docId: string | null;
-    router: any;
-    abracadabra: any;
-    tree: any | null;
+    router: Router;
+    abracadabra: AbracadabraState;
+    tree: DocTreeHelper | null;
+}
+/**
+ * Tree helper shape — matches useChildTree()'s return type.
+ * Declared here to avoid circular imports.
+ */
+export interface DocTreeHelper {
+    entries: import('vue').ComputedRef<TreeEntry[]>;
+    childrenOf: (parentId: string | null) => TreeEntry[];
+    descendantsOf: (id: string) => TreeEntry[];
+    createChild: (parentId: string | null, label: string, type?: string) => string;
+    moveEntry: (id: string, newParentId: string | null, newOrder: number) => void;
+    deleteEntry: (id: string) => void;
+    renameEntry: (id: string, label: string) => void;
+    updateMeta: (id: string, patch: Partial<DocPageMeta>) => void;
+    duplicateEntry: (id: string) => string;
+    treeMap: {
+        data: Record<string, any>;
+    };
+    trashMap: {
+        data: Record<string, any>;
+    };
 }
 export interface AbracadabraCommandItem {
     id: string;
@@ -152,14 +176,14 @@ export interface AbracadabraMentionProvider {
 export interface MentionPluginCtx {
     docId: string;
     connectedUsers: CollaborationUser[];
-    rootDoc: any;
+    rootDoc: Y.Doc;
 }
 export interface AbracadabraMentionItem {
     id: string;
     label: string;
     avatar?: string;
     color?: string;
-    attrs?: Record<string, any>;
+    attrs?: Record<string, unknown>;
 }
 export interface AbracadabraAwarenessContribution {
     /** Namespaced keys this plugin writes, e.g. ['cursor', 'presence:kanban'] */
@@ -176,11 +200,11 @@ export interface AbracadabraNodePanelSlot {
 }
 export interface NodePanelCtx {
     childId: string;
-    childDoc: any | null;
+    childDoc: Y.Doc | null;
     parentDocId: string;
     parentType: string | undefined;
-    meta: Record<string, any>;
-    tree: any;
+    meta: Record<string, unknown>;
+    tree: DocTreeHelper;
 }
 export interface AbracadabraSettingsPanel {
     label: string;
@@ -259,6 +283,27 @@ export interface DocPageMeta extends Record<string, unknown> {
     graphPinned?: boolean;
     _metaFields?: UserMetaField[];
     _metaInitialized?: boolean;
+    tableMode?: 'hierarchy' | 'flat';
+    tableColumns?: TableColumnDef[];
+    tableColumnOrder?: string[];
+    tableColumnWidths?: Record<string, number>;
+    tableSortKey?: string;
+    tableSortDir?: 'asc' | 'desc';
+    timelinePixelsPerDay?: number;
+    timelineCenterDate?: string;
+    timelineZoom?: string;
+}
+export interface TableColumnDef {
+    id: string;
+    type: 'label' | 'meta';
+    metaKey?: string;
+    metaType?: string;
+    label: string;
+    options?: string[];
+    sliderMin?: number;
+    sliderMax?: number;
+    step?: number;
+    unit?: string;
 }
 export interface TreeEntry {
     id: string;
@@ -306,6 +351,15 @@ export interface SpaceMeta {
     created_at: number;
     updated_at: number;
 }
+export interface InviteInfo {
+    code: string;
+    role: string;
+    max_uses: number;
+    uses: number;
+    created_at: number;
+    expires_at: number | null;
+    created_by: string | null;
+}
 export interface SavedServer {
     url: string;
     label: string;
@@ -324,20 +378,37 @@ export interface LogEntry {
     message: string;
     type: 'system' | 'connection' | 'auth' | 'sync' | 'user' | 'data';
 }
-export declare const UI_COLORS: readonly ["red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose", "grass", "diamond", "gold", "redstone", "lapis", "wood", "discord", "steam", "oxidized"];
-export declare const UI_NEUTRALS: readonly ["slate", "gray", "zinc", "neutral", "stone", "cobblestone", "bedrock", "cream", "sage", "lavender", "blush", "copper", "oxidized", "mint", "peach", "mist", "mauve"];
+export declare const UI_COLORS: readonly ["red", "coral", "orange", "amber", "yellow", "chartreuse", "lime", "green", "jade", "emerald", "teal", "cyan", "sky", "blue", "sapphire", "indigo", "violet", "purple", "fuchsia", "magenta", "pink", "rose", "oxidized"];
+export declare const UI_NEUTRALS: readonly ["slate", "gray", "zinc", "neutral", "stone", "cobblestone", "bedrock", "cream", "sand", "bark", "sage", "moss", "lavender", "blush", "wine", "copper", "oxidized", "mint", "peach", "fog", "mist", "mauve", "dusk"];
 export declare const COLOR_HUES: Record<string, number>;
 export declare function deriveColorFromPubKey(pubKey: string): {
     name: string;
     hsl: string;
     neutralName: string;
 };
+/**
+ * Explicit identity state machine.
+ *
+ * Transitions:
+ *   initializing → guest       (soft-key generated)
+ *   initializing → claimed     (passkey restored from cache)
+ *   initializing → identityLost (was claimed but cached key missing)
+ *   guest → claimed            (claimAccount succeeds)
+ *   claimed → needsReauth      (token expired, passkey re-auth available)
+ *   claimed → identityLost     (passkey/key cache lost)
+ *   needsReauth → claimed      (loginWithHardware succeeds)
+ *   → connectionBlocked      (AUTH_FAILURE_LIMIT reached or permanent denial)
+ *   connectionBlocked → (previous) (unblockConnection called)
+ */
+export type IdentityState = 'initializing' | 'guest' | 'claimed' | 'identityLost' | 'needsReauth' | 'connectionBlocked';
 /** Injected into nuxtApp as $abracadabra */
 export interface AbracadabraState {
     doc: ShallowRef<Y.Doc>;
-    provider: ShallowRef<any | null>;
-    client: ShallowRef<any | null>;
-    keystore: ShallowRef<any | null>;
+    /** The doc ID of the current space (the invisible root of the tree). */
+    spaceDocId: Ref<string | null>;
+    provider: ShallowRef<AbracadabraProvider | null>;
+    client: ShallowRef<AbracadabraClient | null>;
+    keystore: ShallowRef<CryptoIdentityKeystore | null>;
     status: Ref<'disconnected' | 'connecting' | 'connected'>;
     synced: Ref<boolean>;
     isReady: Ref<boolean>;
@@ -349,15 +420,23 @@ export interface AbracadabraState {
     userCount: Ref<number>;
     publicKeyB64: Ref<string>;
     connectionError: Ref<string | null>;
+    /** Explicit identity state machine — prefer over individual booleans. */
+    identityState: Ref<IdentityState>;
+    /** @deprecated Use `identityState === 'claimed'` */
     isClaimed: Ref<boolean>;
+    /** @deprecated Use `identityState === 'identityLost'` */
     identityLost: Ref<boolean>;
+    /** @deprecated Use `identityState === 'needsReauth'` */
     needsReauth: Ref<boolean>;
     requirePasskeyOnLogin: Ref<boolean>;
+    /** @deprecated Use `identityState === 'connectionBlocked'` */
     isConnectionBlocked: Ref<boolean>;
+    effectiveRole: Ref<string | null>;
+    unsyncedChanges: Ref<number>;
     currentServerUrl: Ref<string>;
     savedServers: Ref<SavedServer[]>;
-    currentServerSpaces: any;
-    currentServerSpacesEnabled: any;
+    currentServerSpaces: Ref<SpaceMeta[]>;
+    currentServerSpacesEnabled: Ref<boolean>;
     pendingInviteCode: Ref<string | null>;
     registry: import('./plugin-registry').PluginRegistry;
     addLog: (message: string, type?: LogEntry['type']) => void;
@@ -387,32 +466,51 @@ export interface AbracadabraState {
         role?: string;
         maxUses?: number;
         expiresIn?: number;
-    }) => Promise<any>;
-    listInvites: () => Promise<any[]>;
+    }) => Promise<InviteInfo>;
+    listInvites: () => Promise<InviteInfo[]>;
     revokeInvite: (code: string) => Promise<void>;
+    /**
+     * Attempt identity recovery: tries silent passkey re-auth, then falls back
+     * to emitting a recoverable event so the app can show mnemonic input.
+     * Returns true if recovery succeeded.
+     */
+    recoverIdentity: () => Promise<boolean>;
+    /**
+     * Reset auth failure count and reconnect. Use when the user has resolved
+     * the issue that caused repeated auth failures (e.g. re-invited, role fixed).
+     */
+    unblockConnection: () => void;
     broadcastSyncActive: Ref<boolean>;
     init: (serverUrl?: string) => Promise<void>;
 }
+/** Nitro storage interface (subset used by runners) */
+export interface NitroStorage {
+    getItem: (key: string) => Promise<unknown>;
+    setItem: (key: string, value: unknown) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+    getKeys: (base?: string) => Promise<string[]>;
+    hasItem: (key: string) => Promise<boolean>;
+}
 /**
  * Cleanup function returned by a runner's start().
  * Called on graceful server shutdown.
  */
-export type RunnerCleanup = (() => void | Promise<void>) | void;
+export type RunnerCleanup = (() => void | Promise<void>) | undefined;
 /**
  * Context provided to every server-side runner.
  * Available after the service provider successfully syncs with the root document.
  */
 export interface ServerRunnerContext {
     /** Service-role REST + auth client (AbracadabraClient) */
-    client: any;
-    /** Shared HocuspocusProviderWebsocket — reuse for all child providers */
-    wsp: any;
+    client: AbracadabraClient;
+    /** Shared AbracadabraWS — reuse for all child providers */
+    wsp: AbracadabraWS;
     /** Root Y.Doc (the world document) */
-    rootDoc: any;
+    rootDoc: Y.Doc;
     /** Root AbracadabraProvider — call .loadChild(docId) to open sub-documents */
-    rootProvider: any;
+    rootProvider: AbracadabraProvider;
     /** Nitro useStorage() handle — use for persistent cache across requests */
-    storage: any;
+    storage: NitroStorage;
     /** Document cache API: read/write HTML+JSON renders, build tree snapshots */
     docCache: DocCacheAPI;
 }
@@ -430,7 +528,7 @@ export interface ServerRunnerDefinition {
  */
 export interface DocCacheAPI {
     getHTML: (docId: string) => Promise<string | null>;
-    getJSON: (docId: string) => Promise<any | null>;
+    getJSON: (docId: string) => Promise<Record<string, unknown> | null>;
     invalidate: (docId: string) => Promise<void>;
     getTree: () => Promise<CachedTreeNode[]>;
 }
@@ -440,6 +538,6 @@ export interface CachedTreeNode {
     label: string;
     type: string;
     html: string | null;
-    data: any | null;
+    data: Record<string, unknown> | null;
     children: CachedTreeNode[];
 }

package/dist/runtime/types.js

@@ -1,29 +1,26 @@
 export const UI_COLORS = [
   "red",
+  "coral",
   "orange",
   "amber",
   "yellow",
+  "chartreuse",
   "lime",
   "green",
+  "jade",
   "emerald",
   "teal",
   "cyan",
   "sky",
   "blue",
+  "sapphire",
   "indigo",
   "violet",
   "purple",
   "fuchsia",
+  "magenta",
   "pink",
   "rose",
-  "grass",
-  "diamond",
-  "gold",
-  "redstone",
-  "lapis",
-  "wood",
-  "discord",
-  "steam",
   "oxidized"
 ];
 export const UI_NEUTRALS = [
@@ -35,15 +32,21 @@ export const UI_NEUTRALS = [
   "cobblestone",
   "bedrock",
   "cream",
+  "sand",
+  "bark",
   "sage",
+  "moss",
   "lavender",
   "blush",
+  "wine",
   "copper",
   "oxidized",
   "mint",
   "peach",
+  "fog",
   "mist",
-  "mauve"
+  "mauve",
+  "dusk"
 ];
 export const COLOR_HUES = {
   red: 0,
@@ -61,16 +64,13 @@ export const COLOR_HUES = {
   violet: 258,
   purple: 271,
   fuchsia: 292,
+  magenta: 310,
   pink: 330,
   rose: 350,
-  grass: 142,
-  diamond: 187,
-  gold: 48,
-  redstone: 0,
-  lapis: 217,
-  wood: 20,
-  discord: 235,
-  steam: 84,
+  coral: 16,
+  chartreuse: 75,
+  jade: 152,
+  sapphire: 225,
   oxidized: 168
 };
 export function deriveColorFromPubKey(pubKey) {

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

@@ -0,0 +1,41 @@
+/**
+ * Chat message content parsing and rendering utilities.
+ *
+ * Handles doc-quote, doc-link, and plain text messages with @mention
+ * and URL segment extraction for rich rendering.
+ *
+ * Ported from cou-sh/app/utils/chatContent.ts.
+ */
+export type ParsedMessage = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'doc-quote';
+    text: string;
+    docId: string;
+    from: number;
+    to: number;
+    label: string;
+    section: string;
+} | {
+    kind: 'doc-link';
+    docId: string;
+    label: string;
+    icon?: string;
+};
+export declare function parseMessageContent(content: string): ParsedMessage;
+/** Segment types for rich text rendering */
+export type TextSegment = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'link';
+    url: string;
+} | {
+    type: 'mention';
+    name: string;
+};
+/** Split plain text into segments for rich rendering (links, @mentions) */
+export declare function renderMessageSegments(text: string): TextSegment[];
+/** Return a short plain-text preview for any message content string. */
+export declare function previewMessageContent(content: string): string;

package/dist/runtime/utils/chatContent.js

@@ -0,0 +1,65 @@
+export function parseMessageContent(content) {
+  if (content.startsWith("{")) {
+    try {
+      const obj = JSON.parse(content);
+      if (obj.type === "doc-quote") {
+        return {
+          kind: "doc-quote",
+          text: obj.text ?? "",
+          docId: obj.docId ?? "",
+          from: obj.from ?? 0,
+          to: obj.to ?? 0,
+          label: obj.label ?? "",
+          section: obj.section ?? ""
+        };
+      }
+      if (obj.type === "doc-link") {
+        return {
+          kind: "doc-link",
+          docId: obj.docId ?? "",
+          label: obj.label ?? "",
+          icon: obj.icon
+        };
+      }
+    } catch {
+    }
+  }
+  return { kind: "text", text: content };
+}
+const URL_RE = /https?:\/\/[^\s<>)"']+/g;
+const MENTION_RE = /@(\w+)/g;
+export function renderMessageSegments(text) {
+  const segments = [];
+  const matches = [];
+  for (const m of text.matchAll(URL_RE)) {
+    matches.push({ index: m.index, length: m[0].length, segment: { type: "link", url: m[0] } });
+  }
+  for (const m of text.matchAll(MENTION_RE)) {
+    matches.push({ index: m.index, length: m[0].length, segment: { type: "mention", name: m[1] } });
+  }
+  matches.sort((a, b) => a.index - b.index);
+  let cursor = 0;
+  for (const m of matches) {
+    if (m.index < cursor) continue;
+    if (m.index > cursor) {
+      segments.push({ type: "text", value: text.slice(cursor, m.index) });
+    }
+    segments.push(m.segment);
+    cursor = m.index + m.length;
+  }
+  if (cursor < text.length) {
+    segments.push({ type: "text", value: text.slice(cursor) });
+  }
+  return segments.length > 0 ? segments : [{ type: "text", value: text }];
+}
+export function previewMessageContent(content) {
+  const parsed = parseMessageContent(content);
+  if (parsed.kind === "doc-quote") {
+    const quote = parsed.text ? `"${parsed.text}"` : "";
+    return parsed.label ? `${parsed.label} \u2014 ${quote}` : quote || content;
+  }
+  if (parsed.kind === "doc-link") {
+    return parsed.label || "Document";
+  }
+  return parsed.text;
+}

package/dist/runtime/utils/colorPalettes.js

@@ -23,11 +23,7 @@ export const COLOR_PALETTES = [
   palette("gray", [[50, "#f9fafb"], [100, "#f3f4f6"], [200, "#e5e7eb"], [300, "#d1d5db"], [400, "#9ca3af"], [500, "#6b7280"], [600, "#4b5563"], [700, "#374151"], [800, "#1f2937"], [900, "#111827"], [950, "#030712"]]),
   palette("zinc", [[50, "#fafafa"], [100, "#f4f4f5"], [200, "#e4e4e7"], [300, "#d4d4d8"], [400, "#a1a1aa"], [500, "#71717a"], [600, "#52525b"], [700, "#3f3f46"], [800, "#27272a"], [900, "#18181b"], [950, "#09090b"]]),
   palette("stone", [[50, "#fafaf9"], [100, "#f5f5f4"], [200, "#e7e5e4"], [300, "#d6d3d1"], [400, "#a8a29e"], [500, "#78716c"], [600, "#57534e"], [700, "#44403c"], [800, "#292524"], [900, "#1c1917"], [950, "#0c0a09"]]),
-  palette("grass", [[50, "#f0fdf4"], [100, "#dcfce7"], [200, "#bbf7d0"], [300, "#86efac"], [400, "#4ade80"], [500, "#22c55e"], [600, "#16a34a"], [700, "#15803d"], [800, "#166534"], [900, "#14532d"], [950, "#052e16"]]),
-  palette("diamond", [[50, "#ecfeff"], [100, "#cffafe"], [200, "#a5f3fc"], [300, "#67e8f9"], [400, "#22d3ee"], [500, "#06b6d4"], [600, "#0891b2"], [700, "#0e7490"], [800, "#155e75"], [900, "#164e63"], [950, "#083344"]]),
-  palette("gold", [[50, "#fefce8"], [100, "#fef9c3"], [200, "#fef08a"], [300, "#fde047"], [400, "#facc15"], [500, "#eab308"], [600, "#ca8a04"], [700, "#a16207"], [800, "#854d0e"], [900, "#713f12"], [950, "#422006"]]),
-  palette("redstone", [[50, "#fef2f2"], [100, "#fee2e2"], [200, "#fecaca"], [300, "#fca5a5"], [400, "#f87171"], [500, "#ef4444"], [600, "#dc2626"], [700, "#b91c1c"], [800, "#991b1b"], [900, "#7f1d1d"], [950, "#450a0a"]]),
-  palette("lapis", [[50, "#eff6ff"], [100, "#dbeafe"], [200, "#bfdbfe"], [300, "#93c5fd"], [400, "#60a5fa"], [500, "#3b82f6"], [600, "#2563eb"], [700, "#1d4ed8"], [800, "#1e40af"], [900, "#1e3a8a"], [950, "#172554"]]),
+  palette("dusk", [[50, "#f8f7fb"], [100, "#f0eef6"], [200, "#e3dfee"], [300, "#cec7e0"], [400, "#b3a8cd"], [500, "#9688b8"], [600, "#7d6da0"], [700, "#685a85"], [800, "#564b6e"], [900, "#48405b"], [950, "#2d283a"]]),
   palette("mist", [[50, "#f4f7fb"], [100, "#e8eff6"], [200, "#d6e3f0"], [300, "#b8cfe5"], [400, "#94b4d8"], [500, "#7598ca"], [600, "#607fbc"], [700, "#536baa"], [800, "#48598b"], [900, "#3e4c6f"], [950, "#293044"]]),
   palette("sage", [[50, "#f6f7f6"], [100, "#e8ebe8"], [200, "#d6dcd6"], [300, "#b8c3b8"], [400, "#95a595"], [500, "#758875"], [600, "#5d6e5d"], [700, "#4b584b"], [800, "#3e493e"], [900, "#353d35"], [950, "#1c211c"]]),
   palette("lavender", [[50, "#faf9fc"], [100, "#f3f1f8"], [200, "#ebe6f3"], [300, "#dcd2ea"], [400, "#c5b4dd"], [500, "#ab93cc"], [600, "#9276b8"], [700, "#7d62a0"], [800, "#685285"], [900, "#56446d"], [950, "#372b4a"]]),
@@ -36,7 +32,17 @@ export const COLOR_PALETTES = [
   palette("oxidized", [[50, "#f0fdf9"], [100, "#ccfbef"], [200, "#99f6e0"], [300, "#5fe9ce"], [400, "#2dd4b8"], [500, "#14b8a0"], [600, "#0d9384"], [700, "#0f766c"], [800, "#115e57"], [900, "#134e48"], [950, "#042f2c"]]),
   palette("mint", [[50, "#f0fdf7"], [100, "#dcfce9"], [200, "#bbf7d5"], [300, "#86efb3"], [400, "#4ade89"], [500, "#22c563"], [600, "#16a34d"], [700, "#15803f"], [800, "#166535"], [900, "#14532d"], [950, "#052e16"]]),
   palette("peach", [[50, "#fef8f3"], [100, "#fef0e6"], [200, "#fcddc2"], [300, "#fac59d"], [400, "#f7a46f"], [500, "#f38744"], [600, "#e46d28"], [700, "#bd561e"], [800, "#97461f"], [900, "#7a3c1d"], [950, "#421c0d"]]),
-  palette("mauve", [[50, "#faf8fb"], [100, "#f3eff6"], [200, "#e9e2ee"], [300, "#d8cae0"], [400, "#c0a9ce"], [500, "#a687b8"], [600, "#8d6a9f"], [700, "#765786"], [800, "#62496f"], [900, "#523f5c"], [950, "#33253a"]])
+  palette("mauve", [[50, "#faf8fb"], [100, "#f3eff6"], [200, "#e9e2ee"], [300, "#d8cae0"], [400, "#c0a9ce"], [500, "#a687b8"], [600, "#8d6a9f"], [700, "#765786"], [800, "#62496f"], [900, "#523f5c"], [950, "#33253a"]]),
+  palette("coral", [[50, "#fff5f1"], [100, "#ffe8de"], [200, "#ffd0bc"], [300, "#ffb08f"], [400, "#ff8657"], [500, "#ff6630"], [600, "#f04e18"], [700, "#c73b12"], [800, "#9e3215"], [900, "#802e17"], [950, "#45140a"]]),
+  palette("chartreuse", [[50, "#f8fee7"], [100, "#effbcc"], [200, "#ddf79e"], [300, "#c5ee64"], [400, "#aee035"], [500, "#90c318"], [600, "#6f9b0f"], [700, "#567611"], [800, "#455d14"], [900, "#3a4f16"], [950, "#1e2c07"]]),
+  palette("jade", [[50, "#effef6"], [100, "#d8fce9"], [200, "#b4f7d5"], [300, "#7aefb8"], [400, "#3bdf95"], [500, "#18c677"], [600, "#0da35f"], [700, "#0e824e"], [800, "#116740"], [900, "#105436"], [950, "#042f1e"]]),
+  palette("sapphire", [[50, "#eef3ff"], [100, "#dfe8ff"], [200, "#c6d4ff"], [300, "#a3b8ff"], [400, "#7e93fd"], [500, "#5d6ef6"], [600, "#4149ea"], [700, "#353bcf"], [800, "#2d33a7"], [900, "#2b3184"], [950, "#1a1c4e"]]),
+  palette("magenta", [[50, "#fdf3fd"], [100, "#fbe5fb"], [200, "#f6cef5"], [300, "#f0a8eb"], [400, "#e675dc"], [500, "#d549c7"], [600, "#b82da6"], [700, "#982387"], [800, "#7d206e"], [900, "#671d5b"], [950, "#420638"]]),
+  palette("sand", [[50, "#faf9f6"], [100, "#f3f0e8"], [200, "#e7e0d0"], [300, "#d5c9b0"], [400, "#beac8a"], [500, "#a3906e"], [600, "#8a7659"], [700, "#716149"], [800, "#5e513f"], [900, "#4e4336"], [950, "#2c251e"]]),
+  palette("fog", [[50, "#f7f8fa"], [100, "#eef0f5"], [200, "#dfe4ec"], [300, "#c8cfdc"], [400, "#a9b4c7"], [500, "#8b97ae"], [600, "#727e96"], [700, "#5f687c"], [800, "#505766"], [900, "#434a55"], [950, "#2a2e36"]]),
+  palette("moss", [[50, "#f7f8f5"], [100, "#eef0e9"], [200, "#dde2d4"], [300, "#c5ccb6"], [400, "#a7b093"], [500, "#8b9673"], [600, "#717b5c"], [700, "#5c644b"], [800, "#4c533f"], [900, "#404536"], [950, "#23261d"]]),
+  palette("bark", [[50, "#faf8f6"], [100, "#f3eee8"], [200, "#e7dcd1"], [300, "#d6c4b1"], [400, "#bfa58a"], [500, "#a68868"], [600, "#8d7054"], [700, "#745b44"], [800, "#604c3a"], [900, "#504031"], [950, "#2d231b"]]),
+  palette("wine", [[50, "#faf7f8"], [100, "#f5edef"], [200, "#ebdce0"], [300, "#dcc4cb"], [400, "#c6a3ae"], [500, "#ad8391"], [600, "#946b78"], [700, "#7c5864"], [800, "#674953"], [900, "#563f46"], [950, "#302227"]])
 ];
 export function findPaletteByHex(hex) {
   const normalized = hex.toLowerCase();

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

@@ -0,0 +1,12 @@
+/**
+ * Session-level LRU cache for gallery cover image blob URLs.
+ *
+ * Multiple gallery cards referencing the same upload only make one
+ * network request. Cache keys: `${docId}/${uploadId}`.
+ *
+ * Ported from cou-sh/app/utils/coverCache.ts.
+ */
+/**
+ * Fetches a cover blob URL for a given upload, with session-level caching.
+ */
+export declare function getCoverBlobUrl(client: any, docId: string, uploadId: string): Promise<string>;

package/dist/runtime/utils/coverCache.js

@@ -0,0 +1,14 @@
+const cache = /* @__PURE__ */ new Map();
+export function getCoverBlobUrl(client, docId, uploadId) {
+  const key = `${docId}/${uploadId}`;
+  if (!cache.has(key)) {
+    cache.set(
+      key,
+      client.getUpload(docId, uploadId).then((blob) => URL.createObjectURL(blob)).catch(() => {
+        cache.delete(key);
+        return "";
+      })
+    );
+  }
+  return cache.get(key);
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Document reference edge scanner.
+ *
+ * Scans Y.js XmlFragments for doc-link hrefs and docEmbed nodes,
+ * building a reactive backlink graph. Lazily loads child docs in batches,
+ * observes changes, and debounces re-scans.
+ *
+ * Ported from cou-sh/app/utils/docReferenceEdges.ts.
+ */
+import { type ShallowRef, type ComputedRef } from 'vue';
+import * as Y from 'yjs';
+/**
+ * Scan a Y.js XmlFragment for doc-link hrefs and docEmbed nodes.
+ * Returns an array of referenced document IDs.
+ */
+export declare function scanDocReferences(fragment: Y.XmlFragment): string[];
+/**
+ * Composable that lazily loads child docs, scans their content for
+ * doc-links and doc-embeds, and returns reactive reference edges.
+ */
+export declare function useDocReferenceEdges(childProviderRef: ShallowRef<any>, allEntries: ComputedRef<Array<{
+    id: string;
+}>>): ComputedRef<{
+    source: string;
+    target: string;
+}[]>;