@drawnagency/primitives 0.1.114 → 0.1.115

package/dist/lib/loader.d.ts

@@ -1,5 +1,8 @@
 import { type Section } from "../schemas/sections";
 import { type SiteIndex, type SectionMeta } from "../schemas/site-config";
+import type { NavEntry } from "../schemas/nav";
+import type { TagEntry } from "../schemas/tags";
+import type { SidecarRead } from "./sidecars";
 export interface LoadedSection {
     section: Section;
     meta: SectionMeta;
@@ -10,39 +13,35 @@ export interface LoadedSection {
 export interface SiteContent {
     sections: LoadedSection[];
     index: SiteIndex;
-    /** True when nav.json was present but held entries this package version could
-     *  not represent (unknown kinds, invalid shapes) — the returned nav is missing
-     *  them. Writers must treat a degraded nav as read-only: wholesale-replacing
-     *  nav.json from a degraded read permanently destroys the entries this
-     *  version dropped. */
+    /** A Degraded read of nav.json (see SidecarRead): the returned nav is missing
+     *  entries, so writers treat it as read-only — wholesale-replacing nav.json
+     *  from it permanently destroys the entries this version dropped. */
     navDegraded: boolean;
     /** Same contract as navDegraded, for tags.json: a degraded read is
      *  read-only for tags. */
     tagsDegraded: boolean;
 }
 /**
- * Whether a load looked for tags.json. Not loaded ⇒ no `index.tags` is attached
- * and writers leave the file alone; loaded ⇒ `file` is its parsed contents,
- * with null/undefined meaning absent (an empty registry). Unlike nav, the
- * difference is load-bearing — an attached `[]` that a writer saves back
- * deletes every tag — hence an explicit flag rather than undefined-vs-null.
+ * The Sidecars a load read, from the Sidecar module's readers. A Sidecar the
+ * load did not look for is omitted. Tags then stay unattached ("not loaded":
+ * writers leave tags.json alone, where an attached `[]` saved back would delete
+ * every tag). Nav is attached as `[]` either way — the editor has no nav gate
+ * yet to make "not loaded" safe for nav (exploration B).
  */
-export type TagsSidecar = {
-    loaded: false;
-} | {
-    loaded: true;
-    file: unknown;
+export type SidecarReads = {
+    nav?: SidecarRead<NavEntry>;
+    tags?: SidecarRead<TagEntry>;
 };
 /**
  * Merge a validated index with raw section file contents.
  * Validates each section file against its Zod schema.
  * Returns sections in the concatenated order of every page's order.
  */
-export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): SiteContent;
+export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, sidecars?: SidecarReads): SiteContent;
 /**
  * Build a SiteContent from a Vite `import.meta.glob` result.
  * Callers glob the section JSON files at build time, pass the parsed index, and
  * receive sections merged across every page's order.
  */
-export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): SiteContent;
+export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, sidecars?: SidecarReads): SiteContent;
 //# sourceMappingURL=loader.d.ts.map

package/dist/lib/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB;+DAC2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;2BAIuB;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB;8BAC0B;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAyDD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,GAAE,WAA+B,GAC3C,WAAW,CA4Db;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,GAAE,WAA+B,GAC3C,WAAW,CAQb"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB;+DAC2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB;;yEAEqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB;8BAC0B;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEzF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,GAAE,YAAiB,GAC1B,WAAW,CA2Db;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,GAAE,YAAiB,GAC1B,WAAW,CAQb"}

package/dist/lib/media-ops.d.ts

@@ -0,0 +1,73 @@
+import type { MediaItem, MediaManifest } from "../schemas/media";
+import type { DocumentManifest, DocumentManifestEntry } from "../schemas/documents";
+export type MediaBlob = {
+    path: string;
+    base64: string;
+};
+export type MediaOp = 
+/**
+ * A new image and its variant files, keyed by its id (the content hash).
+ * `alt` is the caller's alt text, if it sent one — the only alt applied when
+ * the image turns out to be in the library already (`entry.alt` is just the
+ * new entry's default).
+ */
+{
+    op: "addImage";
+    entry: MediaItem;
+    blobs: MediaBlob[];
+    alt?: string;
+} | {
+    op: "setImageAlt";
+    imageId: string;
+    alt: string;
+} | {
+    op: "deleteImage";
+    imageId: string;
+}
+/**
+ * A document's manifest entry, with its bytes when they ride in the commit
+ * (git tier; bucket-tier bytes are uploaded beforehand). For an id already in
+ * the library — git-tier ids are the content hash, so the same bytes — only
+ * the filename is applied: its stored bytes and path stay. That is how a
+ * rename lands.
+ */
+ | {
+    op: "putDocument";
+    documentId: string;
+    entry: DocumentManifestEntry;
+    blob?: MediaBlob;
+};
+/**
+ * Per op, in order. `existed` means `addImage` found the image already in the
+ * library: its bytes are not committed again, and only a differing alt text is
+ * applied.
+ */
+export type MediaOpOutcome = "added" | "existed" | "updated" | "deleted";
+export type AppliedMediaOps = {
+    ok: true;
+    images: MediaManifest;
+    /** Null when no op touched documents, so the write leaves that file alone. */
+    documents: DocumentManifest | null;
+    uploads: {
+        item: {
+            id: string;
+            folder: string;
+        };
+        blobs: MediaBlob[];
+    }[];
+    /** Images whose variant folders the write deletes. */
+    deletions: {
+        id: string;
+        folder: string;
+    }[];
+    outcomes: MediaOpOutcome[];
+};
+export declare function applyMediaOps(manifests: {
+    images: MediaManifest;
+    documents: DocumentManifest;
+}, ops: MediaOp[]): AppliedMediaOps | {
+    ok: false;
+    code: "not_found";
+    error: string;
+};
+//# sourceMappingURL=media-ops.d.ts.map

package/dist/lib/media-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-ops.d.ts","sourceRoot":"","sources":["../../src/lib/media-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AASpF,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,OAAO;AACjB;;;;;GAKG;AACD;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACxC;;;;;;GAMG;GACD;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9F;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,aAAa,CAAC;IACtB,8EAA8E;IAC9E,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,EAAE,CAAC;IACxE,sDAAsD;IACtD,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,EACjE,GAAG,EAAE,OAAO,EAAE,GACb,eAAe,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2DnE"}

package/dist/lib/media-ops.js

@@ -0,0 +1,60 @@
+import "../chunk-JSBRDJBE.js";
+
+// src/lib/media-ops.ts
+function applyMediaOps(manifests, ops) {
+  const images = { ...manifests.images, images: { ...manifests.images.images } };
+  let documents = null;
+  const uploads = [];
+  const deletions = [];
+  const outcomes = [];
+  const keyOf = (imageId) => imageId in images.images ? imageId : Object.keys(images.images).find((key) => images.images[key].id === imageId);
+  const notFound = (imageId) => ({ ok: false, code: "not_found", error: `No media with imageId "${imageId}" in the site's media library.` });
+  for (const op of ops) {
+    switch (op.op) {
+      case "addImage": {
+        const key = keyOf(op.entry.id);
+        if (key === void 0) {
+          images.images[op.entry.id] = op.entry;
+          uploads.push({ item: { id: op.entry.id, folder: op.entry.folder }, blobs: op.blobs });
+          outcomes.push("added");
+        } else {
+          if (op.alt !== void 0) images.images[key] = { ...images.images[key], alt: op.alt };
+          outcomes.push("existed");
+        }
+        break;
+      }
+      case "setImageAlt": {
+        const key = keyOf(op.imageId);
+        if (key === void 0) return notFound(op.imageId);
+        images.images[key] = { ...images.images[key], alt: op.alt };
+        outcomes.push("updated");
+        break;
+      }
+      case "deleteImage": {
+        const key = keyOf(op.imageId);
+        if (key === void 0) return notFound(op.imageId);
+        deletions.push({ id: key, folder: images.images[key].folder });
+        delete images.images[key];
+        outcomes.push("deleted");
+        break;
+      }
+      case "putDocument": {
+        documents ??= { ...manifests.documents };
+        const existing = documents[op.documentId];
+        if (existing) {
+          documents[op.documentId] = { ...existing, filename: op.entry.filename };
+          outcomes.push(existing.filename === op.entry.filename ? "existed" : "updated");
+        } else {
+          documents[op.documentId] = op.entry;
+          if (op.blob) uploads.push({ item: { id: op.documentId, folder: op.blob.path.split("/")[2] ?? "" }, blobs: [op.blob] });
+          outcomes.push("added");
+        }
+        break;
+      }
+    }
+  }
+  return { ok: true, images, documents, uploads, deletions, outcomes };
+}
+export {
+  applyMediaOps
+};

package/dist/lib/nav-tree.d.ts

@@ -1,5 +1,6 @@
 import type { NavEntry, NavGroupEntry } from "../schemas/nav";
 import type { Page, SiteIndex } from "../schemas/site-config";
+import { type SidecarDiagnostic } from "./sidecar-diagnostics";
 /**
  * Repair an authored nav against the current page set.
  *
@@ -18,6 +19,11 @@ import type { Page, SiteIndex } from "../schemas/site-config";
  * prior state and defeat identity-based re-render checks.
  */
 export declare function reconcileNav(entries: NavEntry[], pages: Page[]): NavEntry[];
+/** reconcileNav plus what the repair changed — what a validator reports. */
+export declare function reconcileNavReport(entries: NavEntry[], pages: Page[]): {
+    entries: NavEntry[];
+    diagnostics: SidecarDiagnostic[];
+};
 /**
  * The ONLY sanctioned way to read the nav. Always reconciles, so callers never
  * have to reason about whether index.nav is present, stale, or authored by an

package/dist/lib/nav-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nav-tree.d.ts","sourceRoot":"","sources":["../../src/lib/nav-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAwD3E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAexD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKlF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAIxC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMrB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAIvF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,SAAS,CAI5G;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,SAAS,CAgC5F;AAqBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkD5G"}
+{"version":3,"file":"nav-tree.d.ts","sourceRoot":"","sources":["../../src/lib/nav-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAErF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAE3E;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,QAAQ,EAAE,EACnB,KAAK,EAAE,IAAI,EAAE,GACZ;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,iBAAiB,EAAE,CAAA;CAAE,CA4E3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAexD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKlF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAIxC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMrB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAIvF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,SAAS,CAI5G;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,SAAS,CAgC5F;AAqBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkD5G"}

package/dist/lib/pages.d.ts

@@ -1,12 +1,13 @@
 import type { Page, SiteIndex, SectionMeta } from "../schemas/site-config";
 import { type DocumentOptions } from "../document/engine/settings";
+import { slugifyPageSlug } from "./slug";
 /**
  * Display fallback for blank page titles. addPage creates pages with an empty
  * title (the editor prompts for one), and closing the modal can leave it blank
  * — every UI that renders a page title must go through this.
  */
 export declare function pageDisplayTitle(title: string): string;
-export declare function slugifyPageSlug(input: string): string;
+export { slugifyPageSlug };
 export declare function uniquePageSlug(base: string, existing: string[]): string;
 export declare function pageById(index: SiteIndex, id: string): Page | undefined;
 export declare function homePage(index: SiteIndex): Page;

package/dist/lib/pages.d.ts.map

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

package/dist/lib/sidecar-diagnostics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a Sidecar reconcile changed. Reconcile repairs silently on every read, so
+ * these are only ever warnings: a validator reports them, nothing rejects on them.
+ *  - dangling: ids of pages/sections the index does not have, dropped
+ *  - duplicate-id: a group/tag id used again, later uses dropped
+ *  - duplicate-member: a page placed twice / a section tagged twice, later placements dropped
+ *  - unlisted: pages missing from the nav, appended to its end (nav only)
+ *
+ * Its own leaf so nav-tree and tags can report without importing the Sidecar
+ * module that imports them.
+ */
+export type SidecarDiagnostic = {
+    code: "dangling" | "duplicate-id" | "duplicate-member" | "unlisted";
+    ids: string[];
+};
+export declare function diagnosticsCollector(): {
+    add(code: SidecarDiagnostic["code"], id: string): void;
+    list(): SidecarDiagnostic[];
+};
+//# sourceMappingURL=sidecar-diagnostics.d.ts.map

package/dist/lib/sidecar-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/sidecar-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,kBAAkB,GAAG,UAAU,CAAC;IACpE,GAAG,EAAE,MAAM,EAAE,CAAC;CACf,CAAC;AAEF,wBAAgB,oBAAoB;cAGtB,iBAAiB,CAAC,MAAM,CAAC,MAAM,MAAM;YAKvC,iBAAiB,EAAE;EAI9B"}

package/dist/lib/sidecars.d.ts

@@ -0,0 +1,118 @@
+import type { ZodType } from "zod";
+import { type NavEntry } from "../schemas/nav";
+import { type TagEntry } from "../schemas/tags";
+import type { SiteIndex } from "../schemas/site-config";
+import type { SidecarDiagnostic } from "./sidecar-diagnostics";
+export type { SidecarDiagnostic };
+/**
+ * One definition per Sidecar — a content file kept beside index.json rather than
+ * on it, so a writer that predates it cannot drop it (CONTEXT.md). Every rule a
+ * caller would otherwise re-implement per file lives behind these: lenient
+ * parse, lifting the wire key off an index before IndexSchema strips it, and the
+ * two places the Sidecars genuinely differ — how a list is repaired against the
+ * index, and how concurrent edits rebase. Pure and browser-safe: the editor uses
+ * it during hydration, and callers do their own I/O.
+ */
+export interface SidecarDefinition<E> {
+    /** Also the key the Sidecar travels under on the wire (`index.nav`, `index.tags`). */
+    name: "nav" | "tags";
+    path: string;
+    /** The key holding the entry list inside the file. */
+    fileKey: "entries" | "tags";
+    entrySchema: ZodType<E>;
+    fileSchema: ZodType<unknown>;
+    /** Total, pure and idempotent; also reports what it repaired. */
+    reconcile(entries: E[], index: SiteIndex): {
+        entries: E[];
+        diagnostics: SidecarDiagnostic[];
+    };
+    /** The list after a collab rebase; `undefined` when no side carries one. */
+    rebase(args: {
+        base: E[] | undefined;
+        local: E[] | undefined;
+        remote: E[] | undefined;
+    }): E[] | undefined;
+    /** Words for a declined write's warning. */
+    words: {
+        /** What the file holds: "navigation entries". */
+        entries: string;
+        /** What did not land: "Page grouping changes". */
+        changes: string;
+        /** What a valid payload is: "a valid navigation tree". */
+        valid: string;
+        /** The expected wire shape, for an agent that sent the wrong one. */
+        shape: string;
+    };
+}
+export declare const NAV: SidecarDefinition<NavEntry>;
+export declare const TAGS: SidecarDefinition<TagEntry>;
+export declare const SIDECARS: readonly SidecarDefinition<unknown>[];
+/**
+ * A Sidecar as read. `degraded` means the file was present but held something
+ * this package version could not represent, so `entries` is missing it: the read
+ * is a Degraded read, never to be cached, posted back, or written over the file.
+ */
+export type SidecarRead<E> = {
+    entries: E[];
+    degraded: boolean;
+};
+/** Read a parsed Sidecar file. Absent (null/undefined) is an empty list, not degraded. */
+export declare function readSidecar<E>(def: SidecarDefinition<E>, file: unknown): SidecarRead<E>;
+/**
+ * Read a Sidecar file's raw text. Present-but-unparseable JSON is degraded, not
+ * absent: a site whose nav.json is corrupt still has groups, and treating it as
+ * "never had any" would let a writer replace them.
+ */
+export declare function readSidecarText<E>(def: SidecarDefinition<E>, text: string | undefined): SidecarRead<E>;
+/**
+ * Lift the Sidecars off an index as it arrives on the wire, BEFORE anything
+ * parses it with IndexSchema — the parse strips unknown keys, and an index
+ * round-tripped through it has lost its Sidecars. A key the index does not carry
+ * is `undefined` (omitted: writers leave the file alone); a carried key is read
+ * with the file's per-entry leniency, into fresh objects that never alias the
+ * caller's.
+ */
+export declare function liftSidecars(rawIndex: unknown): {
+    nav?: SidecarRead<NavEntry>;
+    tags?: SidecarRead<TagEntry>;
+};
+/** The Sidecar file on the branch a write lands on, as the writer read it. */
+export type SidecarFileState = {
+    kind: "absent";
+} | {
+    kind: "present";
+    text: string;
+}
+/** The read itself failed, so nothing is known about the file. */
+ | {
+    kind: "unreadable";
+};
+export type SidecarWritePlan = {
+    action: "untouched";
+} | {
+    action: "write";
+    path: string;
+    content: string;
+}
+/** Declined. The rest of the write still lands, so the warning is what tells the caller. */
+ | {
+    action: "skip";
+    warning: string;
+};
+/**
+ * What a write does to one Sidecar file, given what was posted (from
+ * liftSidecars) and the file on the branch. Every Sidecar write REPLACES the
+ * file, and the posted list was built from what this package version could
+ * READ — so a file holding anything this version cannot fully parse (an entry
+ * from a newer package, or a corrupt file) is read-only: replacing it would
+ * destroy those entries with a clean write. The same holds for a posted
+ * Degraded read.
+ *
+ * Emptiness is judged on the POSTED list, before reconcile: an empty list never
+ * creates a file (every editor save carries the Sidecars, and nav's reconcile
+ * would turn [] into the page list), while an empty list over an existing file
+ * replaces it wholesale. A written list is reconciled against the index being
+ * written, so it never names a page or section that write removed.
+ */
+export declare function planSidecarWrite<E>(def: SidecarDefinition<E>, posted: SidecarRead<E> | undefined, branch: SidecarFileState, index: SiteIndex): SidecarWritePlan;
+//# sourceMappingURL=sidecars.d.ts.map

package/dist/lib/sidecars.d.ts.map

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

package/dist/lib/sidecars.js

@@ -0,0 +1,23 @@
+import {
+  NAV,
+  SIDECARS,
+  TAGS,
+  liftSidecars,
+  planSidecarWrite,
+  readSidecar,
+  readSidecarText
+} from "../chunk-DJABADOO.js";
+import "../chunk-DJOGPSRU.js";
+import "../chunk-4WQ36ZP7.js";
+import "../chunk-GNF6KFQ7.js";
+import "../chunk-4Y2JQQZL.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  NAV,
+  SIDECARS,
+  TAGS,
+  liftSidecars,
+  planSidecarWrite,
+  readSidecar,
+  readSidecarText
+};

package/dist/lib/slug.d.ts

@@ -0,0 +1,2 @@
+export declare function slugifyPageSlug(input: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/lib/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/lib/slug.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/lib/storage-tier.d.ts

@@ -0,0 +1,17 @@
+import { DOCUMENT_GIT_MAX_BYTES, DOCUMENT_BUCKET_MAX_BYTES } from "../schemas/documents";
+import { MEDIA_GIT_MAX_BYTES, MEDIA_BUCKET_MAX_BYTES, type MediaConfig } from "../schemas/media";
+export { DOCUMENT_GIT_MAX_BYTES, DOCUMENT_BUCKET_MAX_BYTES, MEDIA_GIT_MAX_BYTES, MEDIA_BUCKET_MAX_BYTES };
+/**
+ * The MCP connector's own document ceiling, half the bucket cap. The binding
+ * constraint is memory, not time: a presigned PUT cannot stream, so the whole
+ * body is buffered (peak about 2x the file). The browser path has no such
+ * limit because those bytes never pass through a function.
+ */
+export declare const DOCUMENT_CONNECTOR_MAX_BYTES = 104857600;
+export type StorageTier = "git" | "bucket" | "too_large";
+type MediaLimits = Pick<MediaConfig, "maxFileSize" | "maxAssetSize">;
+/** Media limits come from the site's `media` config; documents' are fixed. */
+export declare function tierFor(kind: "document" | "media", bytes: number, media?: MediaLimits): StorageTier;
+/** "2.5 MB", "100 MB" — one decimal at most, in binary megabytes. */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=storage-tier.d.ts.map

package/dist/lib/storage-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-tier.d.ts","sourceRoot":"","sources":["../../src/lib/storage-tier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOjG,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,CAAC;AAE1G;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,YAAc,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD,KAAK,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;AAErE,8EAA8E;AAC9E,wBAAgB,OAAO,CACrB,IAAI,EAAE,UAAU,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,WAAwF,GAC9F,WAAW,CAKb;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/storage-tier.js

@@ -0,0 +1,29 @@
+import {
+  MEDIA_BUCKET_MAX_BYTES,
+  MEDIA_GIT_MAX_BYTES
+} from "../chunk-APIJPTFG.js";
+import {
+  DOCUMENT_BUCKET_MAX_BYTES,
+  DOCUMENT_GIT_MAX_BYTES
+} from "../chunk-BS5AQHZG.js";
+import "../chunk-JSBRDJBE.js";
+
+// src/lib/storage-tier.ts
+var DOCUMENT_CONNECTOR_MAX_BYTES = 104857600;
+function tierFor(kind, bytes, media = { maxFileSize: MEDIA_GIT_MAX_BYTES, maxAssetSize: MEDIA_BUCKET_MAX_BYTES }) {
+  const [gitMax, bucketMax] = kind === "document" ? [DOCUMENT_GIT_MAX_BYTES, DOCUMENT_BUCKET_MAX_BYTES] : [media.maxFileSize, media.maxAssetSize];
+  if (bytes <= gitMax) return "git";
+  return bytes <= bucketMax ? "bucket" : "too_large";
+}
+function formatBytes(bytes) {
+  return `${Math.round(bytes / 1024 / 1024 * 10) / 10} MB`;
+}
+export {
+  DOCUMENT_BUCKET_MAX_BYTES,
+  DOCUMENT_CONNECTOR_MAX_BYTES,
+  DOCUMENT_GIT_MAX_BYTES,
+  MEDIA_BUCKET_MAX_BYTES,
+  MEDIA_GIT_MAX_BYTES,
+  formatBytes,
+  tierFor
+};

package/dist/lib/tags.d.ts

@@ -1,5 +1,6 @@
 import type { TagEntry } from "../schemas/tags";
 import type { SiteIndex } from "../schemas/site-config";
+import { type SidecarDiagnostic } from "./sidecar-diagnostics";
 /**
  * Repair the tag sidecar against the current section set.
  *
@@ -18,6 +19,11 @@ import type { SiteIndex } from "../schemas/site-config";
  * React state, where a shared array would let a later edit mutate prior state).
  */
 export declare function reconcileTags(entries: TagEntry[], sections: SiteIndex["sections"]): TagEntry[];
+/** reconcileTags plus what the repair changed — what a validator reports. */
+export declare function reconcileTagsReport(entries: TagEntry[], sections: SiteIndex["sections"]): {
+    entries: TagEntry[];
+    diagnostics: SidecarDiagnostic[];
+};
 /**
  * The ONLY sanctioned way to read the tags. Always reconciles, so callers never
  * reason about whether index.tags is present, stale, or names deleted sections.

package/dist/lib/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/lib/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,EAAE,CAmB9F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAErD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;2EAC2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI/E;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAIjG;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAS/G;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;CAChC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAsCzB"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/lib/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAErF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,EAAE,CAE9F;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,QAAQ,EAAE,EACnB,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAC9B;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,iBAAiB,EAAE,CAAA;CAAE,CA2B3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAErD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;2EAC2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI/E;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAIjG;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAS/G;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;CAChC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAsCzB"}

package/dist/media/index.js

@@ -1,36 +1,36 @@
 import {
   BAKED_MEDIA_KEYS,
-  EXT_TO_MIME,
-  MIME_TO_EXT,
   ProcessingQueue,
   composePreviewImage,
+  generateVideoPoster,
+  getMediaProvider,
+  rebindImageRef,
+  resolveLogo,
+  resolveManifestReferences,
+  resolveMedia,
+  setMediaProvider
+} from "../chunk-HHNPSKPT.js";
+import {
+  EXT_TO_MIME,
+  MIME_TO_EXT,
   displayFilename,
   displayFilenameExt,
   displayName,
   formatFileSize,
-  generateVideoPoster,
-  getMediaProvider,
   hashFileBuffer,
   imageThumbnailUrl,
   mediaThumbnailUrl,
   mimeToExt,
-  rebindImageRef,
-  resolveLogo,
-  resolveManifestReferences,
-  resolveMedia,
-  sanitizeMediaName,
-  setMediaProvider
-} from "../chunk-QHMKIODQ.js";
-import "../chunk-IP2SEBAJ.js";
+  sanitizeMediaName
+} from "../chunk-CDBURDPX.js";
+import "../chunk-S7QRHUWO.js";
 import {
   ImageManifestSchema,
   MediaConfigSchema,
   MediaFolderSchema,
   MediaItemSchema,
   VariantSchema
-} from "../chunk-PTY2RG2K.js";
-import "../chunk-4TZJZU2T.js";
-import "../chunk-AASEGXNT.js";
+} from "../chunk-APIJPTFG.js";
 import "../chunk-JSBRDJBE.js";
 export {
   BAKED_MEDIA_KEYS,

package/dist/media/queue.d.ts

@@ -1,4 +1,5 @@
 import type { MediaKind } from "./types";
+import type { ImageVariantPlan } from "../lib/image-variant-plan";
 export interface QueueInput {
     buffer: ArrayBuffer;
     originalName: string;
@@ -26,6 +27,7 @@ export interface QueueItem {
         posterBlob?: Blob;
         width: number;
         height: number;
+        plan?: ImageVariantPlan;
     };
 }
 export type QueueEvent = {

package/dist/media/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/media/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,IAAI,CAAA;SAAE,EAAE,CAAC;QACxE,WAAW,EAAE,IAAI,CAAC;QAClB,UAAU,CAAC,EAAE,IAAI,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvC,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,EAAE,YAAY;IAIjC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAkB9B,SAAS,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAelF,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,eAAe;IA8DvB,OAAO,CAAC,aAAa;IAKrB,OAAO,IAAI,IAAI;CAUhB"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/media/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,IAAI,CAAA;SAAE,EAAE,CAAC;QACxE,WAAW,EAAE,IAAI,CAAC;QAClB,UAAU,CAAC,EAAE,IAAI,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;KACzB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvC,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,EAAE,YAAY;IAIjC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAkB9B,SAAS,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAelF,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,eAAe;IA+DvB,OAAO,CAAC,aAAa;IAKrB,OAAO,IAAI,IAAI;CAUhB"}