@drawnagency/primitives 0.1.76 → 0.1.78

package/dist/{chunk-Q3T23HVW.js → chunk-2DDWWTRX.js}

@@ -1,12 +1,12 @@
-import {
-  Button,
-  usePages
-} from "./chunk-ZSPCE6MZ.js";
 import {
   Checkbox,
   FormLabel,
   Input
 } from "./chunk-5THS4K5D.js";
+import {
+  Button,
+  usePages
+} from "./chunk-ZSPCE6MZ.js";
 import {
   DeleteIcon,
   DragHandle,
@@ -14,7 +14,7 @@ import {
   SettingsIcon,
   useMediaLibrary,
   useResolvedMedia
-} from "./chunk-IFHRHV7S.js";
+} from "./chunk-EMGLZQCM.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";

package/dist/chunk-2G2S36SY.js

@@ -0,0 +1,13 @@
+// src/collab/provider-registry.ts
+var provider = null;
+function setCollabProvider(p) {
+  provider = p;
+}
+function getCollabProvider() {
+  return provider;
+}
+
+export {
+  setCollabProvider,
+  getCollabProvider
+};

package/dist/{chunk-S55OZ7F2.js → chunk-3LNKOLZP.js}

@@ -60,6 +60,9 @@ function formatFileSize(bytes) {
   if (bytes >= 1024) return `${Math.round(bytes / 1024)}KB`;
   return `${bytes}B`;
 }
+function displayName(item) {
+  return item.originalName;
+}
 
 // src/media/queue.ts
 var ProcessingQueue = class {
@@ -315,6 +318,7 @@ export {
   displayFilenameExt,
   displayFilename,
   formatFileSize,
+  displayName,
   ProcessingQueue,
   resolveMedia,
   resolveManifestReferences,

package/dist/{chunk-SWIHUIFT.js → chunk-4SIWBWKZ.js}

@@ -68,6 +68,11 @@ var VariantSchema = z2.object({
   height: z2.number().int().positive(),
   size: z2.number().int().nonnegative()
 });
+var MediaFolderSchema = z2.object({
+  name: z2.string().min(1),
+  parentId: z2.string().nullable()
+  // null = root
+});
 var MediaItemSchema = z2.object({
   id: z2.string(),
   hash: z2.string(),
@@ -88,10 +93,14 @@ var MediaItemSchema = z2.object({
   // resolution needs no env access in the browser or at SSR.
   url: z2.string().optional(),
   // Seconds; videos only. Informational (library UI).
-  duration: z2.number().positive().optional()
+  duration: z2.number().positive().optional(),
+  // Display folder (MediaFolderSchema key). Absent = root/unfiled. NOT the
+  // git storage dir — that's `folder` above, which never changes.
+  folderId: z2.string().optional()
 });
 var ImageManifestSchema = z2.object({
-  images: z2.record(z2.string(), MediaItemSchema)
+  images: z2.record(z2.string(), MediaItemSchema),
+  folders: z2.record(z2.string(), MediaFolderSchema).default({})
 });
 var MediaConfigSchema = z2.object({
   sizes: z2.array(z2.number()).default([640, 1080, 1920]),
@@ -268,6 +277,7 @@ export {
   HexColorSchema,
   FontNameSchema,
   VariantSchema,
+  MediaFolderSchema,
   MediaItemSchema,
   ImageManifestSchema,
   MediaConfigSchema,

package/dist/{chunk-SWEVWC5K.js → chunk-BAQYZSFF.js}

@@ -1,25 +1,9 @@
-import {
-  EditableRichText,
-  defineHeadingSection
-} from "./chunk-NKVZGPR6.js";
-import {
-  embedUrl
-} from "./chunk-Y4JQGO6G.js";
 import {
   brandGuideSectionDefs,
   pluralize,
   stripHtmlToPlainText,
   truncate
-} from "./chunk-7T2WQSWF.js";
-import {
-  EditablePlainText,
-  ImageDropZone,
-  MAX_CONTAINER_COLUMNS,
-  MediaBlock,
-  colSpanClass,
-  containerGridClass,
-  spacerHiddenClass
-} from "./chunk-T7MP7ANP.js";
+} from "./chunk-NS3UTJ3E.js";
 import {
   DeleteButton,
   DragHandle,
@@ -31,11 +15,27 @@ import {
   buildBlockDropData,
   canDropBlock,
   isBlockDragData
-} from "./chunk-Q3T23HVW.js";
+} from "./chunk-2DDWWTRX.js";
+import {
+  EditableRichText,
+  defineHeadingSection
+} from "./chunk-K4JD6FD3.js";
+import {
+  EditablePlainText,
+  ImageDropZone,
+  MAX_CONTAINER_COLUMNS,
+  MediaBlock,
+  colSpanClass,
+  containerGridClass,
+  spacerHiddenClass
+} from "./chunk-UA6OCJJK.js";
 import {
   useMediaLibrary,
   useResolvedMedia
-} from "./chunk-IFHRHV7S.js";
+} from "./chunk-EMGLZQCM.js";
+import {
+  embedUrl
+} from "./chunk-Y4JQGO6G.js";
 import {
   DEFAULT_LINK,
   LinkValueSchema
@@ -49,13 +49,13 @@ import {
 import {
   getSectionSchema
 } from "./chunk-TZQPOR5A.js";
+import {
+  SingleMediaReferenceSchema
+} from "./chunk-4SIWBWKZ.js";
 import {
   defineSection,
   getSection
 } from "./chunk-VKAGMEKE.js";
-import {
-  SingleMediaReferenceSchema
-} from "./chunk-SWIHUIFT.js";
 
 // src/components/sections/LinkHeading/index.tsx
 import { Heading1 } from "lucide-react";

package/dist/{chunk-IFHRHV7S.js → chunk-EMGLZQCM.js}

@@ -1,6 +1,6 @@
 import {
   getMediaProvider
-} from "./chunk-S55OZ7F2.js";
+} from "./chunk-3LNKOLZP.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";

package/dist/{chunk-NKVZGPR6.js → chunk-K4JD6FD3.js}

@@ -1,6 +1,6 @@
 import {
   EditablePlainText
-} from "./chunk-T7MP7ANP.js";
+} from "./chunk-UA6OCJJK.js";
 import {
   Button,
   usePages

package/dist/{chunk-SFKYUKVN.js → chunk-MK4POMLZ.js}

@@ -1,6 +1,6 @@
 import {
   HexColorSchema
-} from "./chunk-SWIHUIFT.js";
+} from "./chunk-4SIWBWKZ.js";
 
 // src/schemas/audience.ts
 import { z } from "zod";

package/dist/{chunk-7T2WQSWF.js → chunk-NS3UTJ3E.js}

@@ -1,21 +1,21 @@
+import {
+  Checkbox,
+  FormLabel,
+  Input
+} from "./chunk-5THS4K5D.js";
 import {
   EditableGrid,
   EditablePlainText,
   MediaBlock,
   containerGridClass,
   useEditableCollection
-} from "./chunk-T7MP7ANP.js";
-import {
-  Checkbox,
-  FormLabel,
-  Input
-} from "./chunk-5THS4K5D.js";
+} from "./chunk-UA6OCJJK.js";
 import {
   AddIcon,
   DeleteIcon,
   DragHandle,
   IconButton
-} from "./chunk-IFHRHV7S.js";
+} from "./chunk-EMGLZQCM.js";
 import {
   DEFAULT_LINK,
   LinkValueSchema
@@ -27,13 +27,13 @@ import {
 import {
   cn
 } from "./chunk-7EOSDFS3.js";
-import {
-  defineSection
-} from "./chunk-VKAGMEKE.js";
 import {
   HexColorSchema,
   SingleMediaReferenceSchema
-} from "./chunk-SWIHUIFT.js";
+} from "./chunk-4SIWBWKZ.js";
+import {
+  defineSection
+} from "./chunk-VKAGMEKE.js";
 
 // src/components/sections/Colors/index.tsx
 import { z as z2 } from "zod";

package/dist/chunk-REM2NH7K.js

@@ -0,0 +1,44 @@
+// src/collab/types.ts
+import { z } from "zod";
+var HEARTBEAT_INTERVAL_MS = 15e3;
+var LOCK_STALE_MS = 45e3;
+var CollabPeerSchema = z.object({
+  userId: z.string(),
+  email: z.string(),
+  focusSectionId: z.string().nullable(),
+  heldSectionIds: z.array(z.string())
+});
+var SectionUpdateMessageSchema = z.object({
+  v: z.literal(1),
+  sectionId: z.string(),
+  content: z.unknown(),
+  userId: z.string()
+});
+var IndexUpdateMessageSchema = z.object({
+  v: z.literal(1),
+  index: z.unknown(),
+  userId: z.string()
+});
+var TakeoverMessageSchema = z.object({
+  v: z.literal(1),
+  sectionId: z.string(),
+  byUserId: z.string(),
+  byEmail: z.string()
+});
+var SavedMessageSchema = z.object({
+  v: z.literal(1),
+  newSha: z.string(),
+  changedSectionIds: z.array(z.string()),
+  deletedSectionIds: z.array(z.string()),
+  source: z.enum(["editor", "api"])
+});
+
+export {
+  HEARTBEAT_INTERVAL_MS,
+  LOCK_STALE_MS,
+  CollabPeerSchema,
+  SectionUpdateMessageSchema,
+  IndexUpdateMessageSchema,
+  TakeoverMessageSchema,
+  SavedMessageSchema
+};

package/dist/{chunk-T7MP7ANP.js → chunk-UA6OCJJK.js}

@@ -6,10 +6,10 @@ import {
   SettingsIcon,
   useMediaLibrary,
   useResolvedMedia
-} from "./chunk-IFHRHV7S.js";
+} from "./chunk-EMGLZQCM.js";
 import {
   rebindImageRef
-} from "./chunk-S55OZ7F2.js";
+} from "./chunk-3LNKOLZP.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";

package/dist/{chunk-ZRWGV5O6.js → chunk-Z5IYWUW3.js}

@@ -7,12 +7,12 @@ import {
 import {
   getSectionSchema
 } from "./chunk-TZQPOR5A.js";
+import {
+  IndexSchema
+} from "./chunk-4SIWBWKZ.js";
 import {
   getAllSchemas
 } from "./chunk-VKAGMEKE.js";
-import {
-  IndexSchema
-} from "./chunk-SWIHUIFT.js";
 import {
   MAX_BLOCK_DEPTH,
   blockDepth

package/dist/collab/provider-registry.d.ts

@@ -0,0 +1,4 @@
+import type { CollabProvider } from "./types";
+export declare function setCollabProvider(p: CollabProvider | null): void;
+export declare function getCollabProvider(): CollabProvider | null;
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/collab/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/collab/provider-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEhE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD"}

package/dist/collab/provider-registry.js

@@ -0,0 +1,9 @@
+import {
+  getCollabProvider,
+  setCollabProvider
+} from "../chunk-2G2S36SY.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  getCollabProvider,
+  setCollabProvider
+};

package/dist/collab/rebase.d.ts

@@ -0,0 +1,37 @@
+import type { LoadedSection } from "../lib/loader";
+import type { SiteIndex } from "../schemas/site-config";
+export interface RebaseArgs {
+    localSections: LoadedSection[];
+    localIndex: SiteIndex;
+    localIndexDirty: boolean;
+    dirtySectionIds: Set<string>;
+    /** Section ids created locally since the last clean baseline (i.e. dirty ids
+     *  absent from the last-loaded saved-branch index). Callers derive this from
+     *  the cached clean baseline (Dexie contentCache index), NOT from remoteIndex —
+     *  remote absence is exactly what this field disambiguates: without it, a
+     *  locally-added unsaved section is indistinguishable from a section deleted
+     *  remotely while dirty (both dirty, present locally, absent remotely). */
+    locallyAddedIds: Set<string>;
+    locallyDeletedIds: Set<string>;
+    remoteSections: LoadedSection[];
+    remoteIndex: SiteIndex;
+    remoteChangedIds: Set<string>;
+}
+export interface RebaseResult {
+    sections: LoadedSection[];
+    index: SiteIndex;
+    conflictIds: string[];
+}
+/** Merge a fresh remote (saved-branch) snapshot under local unsaved work.
+ *  Remote wins everywhere the local editor has no unsaved edits; dirty local
+ *  sections are kept verbatim; overlaps are reported as conflicts for the
+ *  caller's keep-mine/take-theirs dialog. Implements the 5 merge rules from
+ *  the collaboration spec ("conflict-free by construction under lock
+ *  discipline").
+ *
+ *  Invariants: inputs are never mutated (the returned index is a fresh
+ *  structure in both branches), and the result partitions: every section in
+ *  `sections` is reachable from `index`; a dirty section deleted remotely is
+ *  kept, re-linked into the index, and reported in `conflictIds`. */
+export declare function rebaseContent(args: RebaseArgs): RebaseResult;
+//# sourceMappingURL=rebase.d.ts.map

package/dist/collab/rebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebase.d.ts","sourceRoot":"","sources":["../../src/collab/rebase.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,UAAU,EAAE,SAAS,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;;+EAK2E;IAC3E,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,SAAS,CAAC;IAKvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IAIjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;qEAUqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CA2F5D"}

package/dist/collab/rebase.js

@@ -0,0 +1,64 @@
+import "../chunk-JSBRDJBE.js";
+
+// src/collab/rebase.ts
+function rebaseContent(args) {
+  const localById = new Map(args.localSections.map((s) => [s.section.id, s]));
+  const remoteIds = new Set(args.remoteSections.map((s) => s.section.id));
+  const merged = args.remoteSections.filter((s) => !args.locallyDeletedIds.has(s.section.id)).map((s) => args.dirtySectionIds.has(s.section.id) ? localById.get(s.section.id) ?? s : s);
+  for (const id of args.dirtySectionIds) {
+    if (remoteIds.has(id) || args.locallyDeletedIds.has(id)) continue;
+    const local = localById.get(id);
+    if (local) merged.push(local);
+  }
+  const conflictSet = /* @__PURE__ */ new Set();
+  for (const id of args.dirtySectionIds) {
+    if (args.locallyDeletedIds.has(id)) continue;
+    if (args.remoteChangedIds.has(id)) {
+      conflictSet.add(id);
+    } else if (localById.has(id) && !(id in args.remoteIndex.sections) && !args.locallyAddedIds.has(id)) {
+      conflictSet.add(id);
+    }
+  }
+  const conflictIds = [...conflictSet].sort();
+  let index;
+  if (!args.localIndexDirty) {
+    index = {
+      ...args.remoteIndex,
+      pages: args.remoteIndex.pages.map((p) => ({ ...p, order: [...p.order] })),
+      sections: { ...args.remoteIndex.sections }
+    };
+  } else {
+    const localOrderIds = new Set(args.localIndex.pages.flatMap((p) => p.order));
+    const pages = args.localIndex.pages.map((p) => ({
+      ...p,
+      order: p.order.filter((id) => id in args.remoteIndex.sections || args.dirtySectionIds.has(id))
+    }));
+    const sections = {};
+    for (const [id, meta] of Object.entries(args.localIndex.sections)) {
+      if (id in args.remoteIndex.sections || args.dirtySectionIds.has(id)) sections[id] = meta;
+    }
+    for (const remotePage of args.remoteIndex.pages) {
+      for (const id of remotePage.order) {
+        if (localOrderIds.has(id) || args.locallyDeletedIds.has(id)) continue;
+        const target = pages.find((p) => p.id === remotePage.id) ?? pages[0];
+        if (target && !target.order.includes(id)) target.order.push(id);
+        sections[id] = args.remoteIndex.sections[id];
+      }
+    }
+    index = { ...args.localIndex, pages, sections };
+  }
+  for (const s of merged) {
+    const id = s.section.id;
+    if (id in index.sections) continue;
+    const meta = args.localIndex.sections[id] ?? s.meta;
+    const localPage = args.localIndex.pages.find((p) => p.order.includes(id));
+    const target = (localPage && index.pages.find((p) => p.id === localPage.id)) ?? index.pages[0];
+    if (!target) continue;
+    if (!target.order.includes(id)) target.order.push(id);
+    index.sections[id] = meta;
+  }
+  return { sections: merged, index, conflictIds };
+}
+export {
+  rebaseContent
+};

package/dist/collab/recovery.d.ts

@@ -0,0 +1,89 @@
+import type { LoadedSection } from "../lib/loader";
+import type { Section, SectionContent } from "../schemas/sections";
+import type { SiteIndex } from "../schemas/site-config";
+/** The last CLEAN saved-branch snapshot (no local dirty overlays folded in).
+ *  Lifecycle: primed by loadContent, re-primed with the committed snapshot on
+ *  every successful save, and re-primed with the fetched remote snapshot on
+ *  every recovery — so it is always the editor's last agreed-with-server state. */
+export interface RecoveryBaseline {
+    sections: LoadedSection[];
+    index: SiteIndex;
+}
+/** Derive rebaseContent's remoteChangedIds + locallyAddedIds from a clean
+ *  baseline and the freshly fetched remote snapshot.
+ *
+ *  - remoteChangedIds: sections whose content differs between the clean baseline
+ *    and the fresh remote. The baseline MUST be clean — diffing against the dirty
+ *    in-memory view would flag every locally-edited section as remote-changed,
+ *    turning every dirty section into a false conflict.
+ *  - locallyAddedIds: dirty ids absent from the clean baseline INDEX — sections
+ *    created locally and never saved. This is what lets rebase distinguish a
+ *    local add from a section deleted remotely while dirty.
+ *
+ *  Degraded mode (baseline === null — should be unreachable, since every load,
+ *  save, and recovery re-primes the cache): fail SAFE, not silent. Every dirty
+ *  section that still exists remotely is flagged remote-changed (forcing the
+ *  keep-mine/take-theirs dialog instead of a silent local-wins merge), and every
+ *  dirty section absent remotely is treated as locally added (kept — a true
+ *  remote-deletion-while-dirty resurrects instead of conflicting, which loses
+ *  nothing). This is deliberately NOT derived from the published mainIndex: a
+ *  main-based baseline would silently local-win every dirty section that already
+ *  exists on main — the exact lost-update this path exists to prevent. */
+export declare function deriveRecoveryInputs({ baseline, remote, dirtyRows, deletedIds }: {
+    baseline: RecoveryBaseline | null;
+    remote: {
+        sections: LoadedSection[];
+        index: SiteIndex;
+    };
+    dirtyRows: {
+        sectionId: string;
+    }[];
+    deletedIds: Set<string>;
+}): {
+    remoteChangedIds: Set<string>;
+    locallyAddedIds: Set<string>;
+};
+/** Apply the user's keep-mine/take-theirs choices to a rebase result.
+ *  Pure — inputs are never mutated. For every conflict the LOCAL copy is
+ *  returned in `preserved` (the caller snapshots it via preserveEdit so no
+ *  choice is destructive). "theirs" swaps in the remote section — or, when the
+ *  remote side DELETED it, removes the section AND strips its id from the index
+ *  (pages' order + sections map); leaving the dangling index ref would make the
+ *  server's dangling-ref gate reject every later save. `droppedDirtyIds` lists
+ *  the "theirs" ids whose local dirty rows must be deleted so the retry doesn't
+ *  re-send the overridden local content. */
+export declare function applyConflictChoices({ merged, remoteSections, choices }: {
+    merged: {
+        sections: LoadedSection[];
+        index: SiteIndex;
+    };
+    remoteSections: LoadedSection[];
+    choices: Record<string, "mine" | "theirs">;
+}): {
+    sections: LoadedSection[];
+    index: SiteIndex;
+    droppedDirtyIds: string[];
+    preserved: {
+        sectionId: string;
+        section: Section;
+    }[];
+};
+/** Build the COMMITTED post-save snapshot for re-priming the clean baseline.
+ *  The committed content is exactly what performSave sent (savedRows), NOT the
+ *  current view state — edits typed while the request was in flight must not
+ *  leak into the "clean" baseline (they are still dirty rows and would otherwise
+ *  read as remote changes on the next recovery). Base = the previous clean
+ *  baseline when available (post-recovery it is the fetched remote snapshot);
+ *  fallback = the loaded sections captured at save start. Ids absent from the
+ *  sent index (deleted this save) are dropped; saved ids absent from the base
+ *  (locally added) are appended with their meta from the sent index. */
+export declare function buildCommittedBaseline({ baselineSections, fallbackSections, savedRows, sentIndex }: {
+    baselineSections: LoadedSection[] | null;
+    fallbackSections: LoadedSection[];
+    savedRows: {
+        sectionId: string;
+        content: SectionContent;
+    }[];
+    sentIndex: SiteIndex;
+}): LoadedSection[];
+//# sourceMappingURL=recovery.d.ts.map

package/dist/collab/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/collab/recovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;mFAGmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;0EAmB0E;AAC1E,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE;IAChF,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IACxD,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB,GAAG;IAAE,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CA0BlE;AAED;;;;;;;;4CAQ4C;AAC5C,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE;IACxE,MAAM,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IACxD,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CAC5C,GAAG;IACF,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACtD,CA4BA;AAED;;;;;;;;wEAQwE;AACxE,wBAAgB,sBAAsB,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE;IACnG,gBAAgB,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACzC,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,EAAE,CAAC;IAC5D,SAAS,EAAE,SAAS,CAAC;CACtB,GAAG,aAAa,EAAE,CAiBlB"}

package/dist/collab/types.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod";
+export declare const HEARTBEAT_INTERVAL_MS = 15000;
+export declare const LOCK_STALE_MS = 45000;
+export declare const CollabPeerSchema: z.ZodObject<{
+    userId: z.ZodString;
+    email: z.ZodString;
+    focusSectionId: z.ZodNullable<z.ZodString>;
+    heldSectionIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type CollabPeer = z.infer<typeof CollabPeerSchema>;
+export declare const SectionUpdateMessageSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    sectionId: z.ZodString;
+    content: z.ZodUnknown;
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type SectionUpdateMessage = z.infer<typeof SectionUpdateMessageSchema>;
+export declare const IndexUpdateMessageSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    index: z.ZodUnknown;
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type IndexUpdateMessage = z.infer<typeof IndexUpdateMessageSchema>;
+export declare const TakeoverMessageSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    sectionId: z.ZodString;
+    byUserId: z.ZodString;
+    byEmail: z.ZodString;
+}, z.core.$strip>;
+export type TakeoverMessage = z.infer<typeof TakeoverMessageSchema>;
+export declare const SavedMessageSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    newSha: z.ZodString;
+    changedSectionIds: z.ZodArray<z.ZodString>;
+    deletedSectionIds: z.ZodArray<z.ZodString>;
+    source: z.ZodEnum<{
+        editor: "editor";
+        api: "api";
+    }>;
+}, z.core.$strip>;
+export type SavedMessage = z.infer<typeof SavedMessageSchema>;
+export type CollabStatus = "connecting" | "connected" | "offline";
+/** Opaque server-minted connection blob. Provider-specific keys ride along;
+ *  primitives only reads the three identity fields. */
+export interface CollabBootstrap {
+    siteId: string;
+    userId: string;
+    email: string;
+    [key: string]: unknown;
+}
+export interface CollabEvents {
+    onPeers(peers: CollabPeer[]): void;
+    onSectionUpdate(msg: SectionUpdateMessage): void;
+    onIndexUpdate(msg: IndexUpdateMessage): void;
+    onTakeover(msg: TakeoverMessage): void;
+    onSaved(msg: SavedMessage): void;
+    onStatus(status: CollabStatus): void;
+}
+/** A live connection to one site channel. The session owns the held-lock set
+ *  (heartbeats them every HEARTBEAT_INTERVAL_MS and includes them in its
+ *  presence payload). acquireLock({steal:true}) also emits the takeover
+ *  broadcast on success. */
+export interface CollabSession {
+    setFocus(sectionId: string | null): void;
+    acquireLock(sectionId: string, opts?: {
+        steal?: boolean;
+    }): Promise<boolean>;
+    releaseLocks(sectionIds: string[]): Promise<void>;
+    broadcastSectionUpdate(sectionId: string, content: unknown): void;
+    broadcastIndexUpdate(index: unknown): void;
+    disconnect(): Promise<void>;
+}
+export interface SavedBroadcast {
+    newSha: string;
+    changedSectionIds: string[];
+    deletedSectionIds: string[];
+    source: "editor" | "api";
+}
+export interface CollabProvider {
+    /** Browser: join the site channel. Resolves null when collaboration is
+     *  unavailable (no session, join refused) — caller runs solo-mode. */
+    connect(bootstrap: CollabBootstrap, events: CollabEvents): Promise<CollabSession | null>;
+    /** Server: mint the browser bootstrap for an authenticated editor session,
+     *  or null when the provider can't support collab (e.g. missing env). */
+    getBootstrap(args: {
+        siteId: string;
+        userId: string;
+        email: string;
+    }): CollabBootstrap | null;
+    /** Server: post-commit fan-out of a successful save to all connected editors. */
+    broadcastSaved(siteId: string, event: SavedBroadcast): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/collab/types.d.ts.map

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

package/dist/collab/types.js

@@ -0,0 +1,19 @@
+import {
+  CollabPeerSchema,
+  HEARTBEAT_INTERVAL_MS,
+  IndexUpdateMessageSchema,
+  LOCK_STALE_MS,
+  SavedMessageSchema,
+  SectionUpdateMessageSchema,
+  TakeoverMessageSchema
+} from "../chunk-REM2NH7K.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  CollabPeerSchema,
+  HEARTBEAT_INTERVAL_MS,
+  IndexUpdateMessageSchema,
+  LOCK_STALE_MS,
+  SavedMessageSchema,
+  SectionUpdateMessageSchema,
+  TakeoverMessageSchema
+};