@drawnagency/primitives 0.1.113 → 0.1.115

package/dist/lib/dexie.js

@@ -169,7 +169,13 @@ async function restoreLocalChanges() {
     const siteId = metaRow?.siteId || getDb().siteId;
     return {
       sections,
-      siteIndex: { siteId, pages: indexRow.pages, sections: indexRow.sections, nav: indexRow.nav },
+      siteIndex: {
+        siteId,
+        pages: indexRow.pages,
+        sections: indexRow.sections,
+        nav: indexRow.nav,
+        ...indexRow.tags !== void 0 ? { tags: indexRow.tags } : {}
+      },
       siteConfig: configRow?.config,
       deletedSections: indexRow.deletedSections ?? []
     };
@@ -197,6 +203,7 @@ async function persistSiteIndex(index, deletedSections = []) {
       pages: index.pages,
       sections: index.sections,
       nav: index.nav,
+      tags: index.tags,
       deletedSections,
       updatedAt: now
     });
@@ -275,6 +282,7 @@ async function persistAll(sections, siteIndex, deletedSectionIds, siteConfig) {
           pages: siteIndex.pages,
           sections: siteIndex.sections,
           nav: siteIndex.nav,
+          tags: siteIndex.tags,
           // Record the deletion INTENT, not just its effect on the order. The
           // restore path reads this back; when it was hardcoded `[]` that path
           // had to re-derive deletions by diffing this snapshot against a fresh
@@ -295,13 +303,14 @@ async function persistAll(sections, siteIndex, deletedSectionIds, siteConfig) {
     }
   );
 }
-async function cacheContent(sha, sections, index, siteConfig, manifests, diff) {
+async function cacheContent(sha, sections, index, siteConfig, manifests, tagsDegraded, diff) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const { tags: _partialTags, ...untaggedIndex } = index;
   await getDb().contentCache.put({
     key: "current",
     sha,
     sections,
-    index,
+    index: tagsDegraded ? untaggedIndex : index,
     siteConfig,
     updatedAt: now,
     savedBranchSha: diff?.savedBranchSha ?? null,

package/dist/lib/env.d.ts

@@ -4,4 +4,8 @@ declare global {
     }
 }
 export declare function env(key: string): string;
+/** Vite replaces `import.meta.env.PROD` with a boolean literal at build time
+ *  (packages are `noExternal`, so that covers this file too), which is why the
+ *  declared string type above is bypassed here. False under Node and vitest. */
+export declare function isProd(): boolean;
 //# sourceMappingURL=env.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACnD;CACF;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACnD;CACF;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvC;AAED;;gFAEgF;AAChF,wBAAgB,MAAM,IAAI,OAAO,CAEhC"}

package/dist/lib/env.js

@@ -1,7 +1,9 @@
 import {
-  env
-} from "../chunk-WKZ7OENC.js";
+  env,
+  isProd
+} from "../chunk-BQ5TZZUE.js";
 import "../chunk-JSBRDJBE.js";
 export {
-  env
+  env,
+  isProd
 };

package/dist/lib/events.d.ts

@@ -1,4 +1,4 @@
-import type { NavItem, SiteNav } from "./nav";
+import type { SiteNav } from "./nav";
 export interface TypedEvent<T> {
     dispatch(detail: T): void;
     listen(callback: (detail: T) => void): () => void;
@@ -7,7 +7,6 @@ export declare function createEvent<T>(name: string): TypedEvent<T>;
 export declare const editModeEvent: TypedEvent<{
     isEditMode: boolean;
 }>;
-export declare const navChangeEvent: TypedEvent<NavItem[]>;
 export declare const darkModeEvent: TypedEvent<string>;
 export declare const siteNameChangeEvent: TypedEvent<string>;
 export declare const historySelectEvent: TypedEvent<{

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE9C,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAW1D;AAED,eAAO,MAAM,aAAa;gBAA6B,OAAO;EAAqB,CAAC;AACpF,eAAO,MAAM,cAAc,uBAA0C,CAAC;AACtE,eAAO,MAAM,aAAa,oBAAsC,CAAC;AACjE,eAAO,MAAM,mBAAmB,oBAAwC,CAAC;AACzE,eAAO,MAAM,kBAAkB;SAAsB,MAAM;UAAQ,MAAM;EAAqB,CAAC;AAC/F;;2EAE2E;AAC3E,eAAO,MAAM,mBAAmB;SAAsB,MAAM;UAAQ,MAAM;EAAsB,CAAC;AACjG;;4BAE4B;AAC5B,eAAO,MAAM,yBAAyB;aAA0B,MAAM;EAA6B,CAAC;AACpG;8EAC8E;AAC9E,eAAO,MAAM,gBAAgB;uBAAoC,OAAO;EAAmB,CAAC;AAC5F,eAAO,MAAM,kBAAkB,qBAA2C,CAAC;AAC3E,eAAO,MAAM,eAAe,oBAAoC,CAAC;AACjE;kFACkF;AAClF,eAAO,MAAM,oBAAoB,kBAA2C,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAW1D;AAED,eAAO,MAAM,aAAa;gBAA6B,OAAO;EAAqB,CAAC;AACpF,eAAO,MAAM,aAAa,oBAAsC,CAAC;AACjE,eAAO,MAAM,mBAAmB,oBAAwC,CAAC;AACzE,eAAO,MAAM,kBAAkB;SAAsB,MAAM;UAAQ,MAAM;EAAqB,CAAC;AAC/F;;2EAE2E;AAC3E,eAAO,MAAM,mBAAmB;SAAsB,MAAM;UAAQ,MAAM;EAAsB,CAAC;AACjG;;4BAE4B;AAC5B,eAAO,MAAM,yBAAyB;aAA0B,MAAM;EAA6B,CAAC;AACpG;8EAC8E;AAC9E,eAAO,MAAM,gBAAgB;uBAAoC,OAAO;EAAmB,CAAC;AAC5F,eAAO,MAAM,kBAAkB,qBAA2C,CAAC;AAC3E,eAAO,MAAM,eAAe,oBAAoC,CAAC;AACjE;kFACkF;AAClF,eAAO,MAAM,oBAAoB,kBAA2C,CAAC"}

package/dist/lib/image-background.d.ts

@@ -0,0 +1,8 @@
+import type { CSSProperties } from "react";
+import type { ImageBackground } from "../schemas/shared";
+export interface ImageBackdrop {
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function imageBackdrop(bg: ImageBackground | undefined): ImageBackdrop | undefined;
+//# sourceMappingURL=image-background.d.ts.map

package/dist/lib/image-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-background.d.ts","sourceRoot":"","sources":["../../src/lib/image-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAkBjF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAMxF"}

package/dist/lib/image-variant-plan.d.ts

@@ -0,0 +1,42 @@
+import type { MediaConfig, MediaItem, Variant } from "../schemas/media";
+export interface MediaIdentity {
+    id: string;
+    hash: string;
+    originalName: string;
+    /** Storage dir under assets/images/. Never changes once committed. */
+    folder: string;
+}
+/** `hash` is the 16-hex content hash both sides compute (hashFileBuffer / hashBuffer). */
+export declare function mediaIdentity(hash: string, fileName: string): MediaIdentity;
+/** Repo path of one stored file in a media folder: a variant width, or `poster`. */
+export declare function imageVariantPath(folder: string, key: number | string): string;
+export interface ImageVariantPlan extends MediaIdentity {
+    width: number;
+    height: number;
+    /** WebP quality, 1-100. */
+    quality: number;
+    /** Ascending by width. */
+    variants: {
+        width: number;
+        path: string;
+    }[];
+}
+export declare function planImageVariants(input: {
+    hash: string;
+    fileName: string;
+    width: number;
+    height: number;
+    media: Pick<MediaConfig, "sizes" | "quality">;
+}): ImageVariantPlan;
+export type ImageManifestEntry = Omit<MediaItem, "kind" | "storage" | "url" | "duration" | "folderId" | "hidden"> & {
+    kind: "image";
+    storage: "github";
+};
+/**
+ * `rendered` is what the adapter measured for each planned width (heights come
+ * from the encoder, not the plan). `size` is the adapter's byte count for the
+ * item: the editor records its largest variant, the sharp path the original's
+ * length — they differ today and this module does not decide that.
+ */
+export declare function imageManifestEntry(plan: ImageVariantPlan, rendered: Variant[], size: number): ImageManifestEntry;
+//# sourceMappingURL=image-variant-plan.d.ts.map

package/dist/lib/image-variant-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-variant-plan.d.ts","sourceRoot":"","sources":["../../src/lib/image-variant-plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAUxE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAG3E;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7E;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;CAC/C,GAAG,gBAAgB,CAanB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG;IAClH,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAoBhH"}

package/dist/lib/image-variant-plan.js

@@ -0,0 +1,53 @@
+import {
+  sanitizeMediaName
+} from "../chunk-CDBURDPX.js";
+import "../chunk-S7QRHUWO.js";
+import "../chunk-JSBRDJBE.js";
+
+// src/lib/image-variant-plan.ts
+function mediaIdentity(hash, fileName) {
+  const originalName = sanitizeMediaName(fileName);
+  return { id: hash, hash, originalName, folder: `${originalName}-${hash}` };
+}
+function imageVariantPath(folder, key) {
+  return `assets/images/${folder}/${key}.webp`;
+}
+function planImageVariants(input) {
+  const identity = mediaIdentity(input.hash, input.fileName);
+  const widths = input.media.sizes.filter((s) => s <= input.width).sort((a, b) => a - b);
+  if (widths.length === 0) widths.push(input.width);
+  return {
+    ...identity,
+    width: input.width,
+    height: input.height,
+    quality: input.media.quality,
+    variants: widths.map((width) => ({ width, path: imageVariantPath(identity.folder, width) }))
+  };
+}
+function imageManifestEntry(plan, rendered, size) {
+  const variants = plan.variants.map(({ width }) => {
+    const out = rendered.find((r) => r.width === width);
+    if (!out) throw new Error(`[image-variant-plan] no rendered variant for planned width ${width}`);
+    return { width, height: out.height, size: out.size };
+  });
+  return {
+    id: plan.id,
+    hash: plan.hash,
+    kind: "image",
+    originalName: plan.originalName,
+    width: plan.width,
+    height: plan.height,
+    mimeType: "image/webp",
+    size,
+    folder: plan.folder,
+    variants,
+    alt: "",
+    storage: "github"
+  };
+}
+export {
+  imageManifestEntry,
+  imageVariantPath,
+  mediaIdentity,
+  planImageVariants
+};

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

@@ -1 +1 @@
-{"version":3,"file":"index-ops.d.ts","sourceRoot":"","sources":["../../src/lib/index-ops.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index-ops.d.ts","sourceRoot":"","sources":["../../src/lib/index-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,gBAAgB,EAA2B,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAalI;;;;;;;;;GASG;AAOH,QAAA,MAAM,cAAc;;;;EAAwC,CAAC;AAa7D,QAAA,MAAM,mBAAmB;;;;;;;;iBAIvB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA2ExB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GACxF;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GAC/E;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACnE;IACE,EAAE,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC7D,GACD;IACE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7D,GACD;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/F;IAAE,EAAE,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACpF;IAAE,EAAE,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,KAAK,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC/C,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACnD,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnH;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAQ5D;AAcD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAEnD;AAiCD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,OAAO,EAAE,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,mBAAmB,CAkXrB"}

package/dist/lib/index-ops.js

@@ -1,25 +1,36 @@
 import {
-  addGroup,
   addPage,
-  deleteGroup,
   deletePage,
+  uniquePageSlug
+} from "../chunk-VY3IFGE3.js";
+import {
+  liftSidecars
+} from "../chunk-DJABADOO.js";
+import {
+  addGroup,
+  deleteGroup,
   groupOfPage,
   moveNavEntry,
   navEntries,
   reconcileNav,
   renameGroup,
-  setGroupStartCollapsed,
-  slugifyPageSlug,
-  uniquePageSlug
-} from "../chunk-NHN2LSIU.js";
+  setGroupStartCollapsed
+} from "../chunk-DJOGPSRU.js";
+import "../chunk-4WQ36ZP7.js";
+import "../chunk-GNF6KFQ7.js";
+import {
+  slugifyPageSlug
+} from "../chunk-S7QRHUWO.js";
 import {
   IndexSchema,
   PageStatusSchema,
   RESERVED_SLUGS,
   SLUG_RE
-} from "../chunk-AHALSCQH.js";
+} from "../chunk-67P34WNW.js";
 import "../chunk-4TZJZU2T.js";
-import "../chunk-GGXZZ77Z.js";
+import "../chunk-4Y2JQQZL.js";
+import "../chunk-APIJPTFG.js";
+import "../chunk-AASEGXNT.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/lib/index-ops.ts
@@ -152,19 +163,12 @@ function applyIndexOps(rawIndex, ops, newSectionTypes) {
       error: "the site's current index could not be parsed, so indexOps cannot be applied \u2014 read it with get_site_index and post a repaired full `index` instead. " + base.error.issues.map((i) => i.message).join("; ")
     };
   }
-  const rawNav = rawIndex?.nav;
+  const lifted = liftSidecars(rawIndex);
   let index = {
     ...base.data,
     pages: base.data.pages.map((p) => ({ ...p, order: [...p.order] })),
     sections: Object.fromEntries(Object.entries(base.data.sections).map(([k, v]) => [k, { ...v }])),
-    // COPIED, not aliased. Taking the caller's array by reference meant any nav
-    // op that spliced in place would mutate the caller's index — the one thing
-    // this function's own comment promises it never does.
-    ...Array.isArray(rawNav) ? {
-      nav: rawNav.map(
-        (entry) => entry && typeof entry === "object" && "pageIds" in entry ? { ...entry, pageIds: [...entry.pageIds] } : { ...entry }
-      )
-    } : {}
+    ...lifted.nav ? { nav: lifted.nav.entries } : {}
   };
   const removed = /* @__PURE__ */ new Set();
   const warnings = [];

package/dist/lib/index.d.ts

@@ -4,15 +4,18 @@ export { audiencePasses } from "./pages";
 export { resolveChatbotName, resolveThinkingPhrases, DEFAULT_CHATBOT_NAME } from "./chatbot";
 export { generateNavLinks, toSectionId, type NavItem } from "./nav";
 export { navEntries, pagesInNavOrder, groupOfPage, groupDisplayLabel, reconcileNav } from "./nav-tree";
+export { siteTags, tagDisplayLabel, reconcileTags } from "./tags";
+export { NAV, TAGS, SIDECARS, readSidecar, readSidecarText, liftSidecars, planSidecarWrite, type SidecarDefinition, type SidecarFileState, type SidecarWritePlan, type SidecarRead, type SidecarDiagnostic, } from "./sidecars";
+export { resolveReference, type ReferenceContent } from "./references";
+export { REFERENCE_TYPE } from "./reference-type";
 export { deriveContrast, contrastColor, relativeLuminance, contrastRatio, wcagLevel, suggestAccessibleOn, type WcagLevel, } from "./contrast";
 export { primaryVarValue, accentVarValue, onPrimaryVarValue } from "./theme-vars";
 export { sanitizeHtml, ensureSanitizer } from "./sanitize";
-export { gridColsClass } from "./grid";
 export { getIcon, curatedIcons, type IconEntry } from "./icons";
 export { buildGoogleFontsUrl } from "./google-fonts";
 export { formatTimestamp } from "./timestamp";
-export { safeRedirect } from "./safeRedirect";
-export { createEvent, editModeEvent, navChangeEvent, darkModeEvent, type TypedEvent } from "./events";
+export { safeRedirect } from "./safe-redirect";
+export { createEvent, editModeEvent, darkModeEvent, type TypedEvent } from "./events";
 export { createRegistry, defineSection, registerSection, registerSchema, getSection, getSchema, getAllSections, getAllSchemas, clearRegistry, type SectionRegistry, type SectionDefinition, type SectionProps, type WrapperProps, type SettingsFieldDef, type SettingsSchema, type CustomSettingsFormProps, } from "./registry";
-export { mergeSiteContent, loadStaticSiteContent, loadSiteContent, type LoadedSection, type SiteContent, } from "./loader";
+export { mergeSiteContent, loadStaticSiteContent, type LoadedSection, type SiteContent, type SidecarReads, } from "./loader";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,EACL,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC"}

package/dist/lib/index.js

@@ -5,8 +5,6 @@ import {
   contrastColor,
   contrastRatio,
   deriveContrast,
-  gridColsClass,
-  loadSiteContent,
   loadStaticSiteContent,
   mergeSiteContent,
   onPrimaryVarValue,
@@ -17,49 +15,71 @@ import {
   safeRedirect,
   suggestAccessibleOn,
   wcagLevel
-} from "../chunk-VWWY5TL5.js";
-import "../chunk-FRVO75DK.js";
+} from "../chunk-O37AV27P.js";
 import {
   formatTimestamp
 } from "../chunk-MM7KZS5C.js";
-import {
-  curatedIcons,
-  getIcon
-} from "../chunk-WDSVHKAH.js";
-import {
-  createEvent,
-  darkModeEvent,
-  editModeEvent,
-  navChangeEvent
-} from "../chunk-4RNF2DRG.js";
 import {
   generateNavLinks,
+  resolveReference,
   toSectionId
-} from "../chunk-DNY72JZN.js";
-import "../chunk-CXZ5YJG4.js";
+} from "../chunk-WYOFQHKI.js";
 import {
   ensureSanitizer,
   sanitizeHtml
 } from "../chunk-QQ3S3P5P.js";
+import {
+  curatedIcons,
+  getIcon
+} from "../chunk-WDSVHKAH.js";
+import "../chunk-L45X7DKX.js";
+import {
+  createEvent,
+  darkModeEvent,
+  editModeEvent
+} from "../chunk-XDEPXTBY.js";
+import "../chunk-FRVO75DK.js";
 import {
   cn
 } from "../chunk-7EOSDFS3.js";
 import {
-  audiencePasses,
+  audiencePasses
+} from "../chunk-VY3IFGE3.js";
+import {
+  NAV,
+  SIDECARS,
+  TAGS,
+  liftSidecars,
+  planSidecarWrite,
+  readSidecar,
+  readSidecarText
+} from "../chunk-DJABADOO.js";
+import {
   groupDisplayLabel,
   groupOfPage,
   navEntries,
   pagesInNavOrder,
   reconcileNav
-} from "../chunk-NHN2LSIU.js";
-import "../chunk-S2L3BPLS.js";
+} from "../chunk-DJOGPSRU.js";
+import {
+  reconcileTags,
+  siteTags,
+  tagDisplayLabel
+} from "../chunk-4WQ36ZP7.js";
+import "../chunk-GNF6KFQ7.js";
+import "../chunk-S7QRHUWO.js";
+import {
+  REFERENCE_TYPE
+} from "../chunk-5GFACGSN.js";
+import "../chunk-7SX42OP4.js";
 import {
   env
-} from "../chunk-WKZ7OENC.js";
-import "../chunk-REDDTTGJ.js";
+} from "../chunk-BQ5TZZUE.js";
 import "../chunk-DMCGN5AS.js";
-import "../chunk-AHALSCQH.js";
+import "../chunk-67P34WNW.js";
 import "../chunk-4TZJZU2T.js";
+import "../chunk-4Y2JQQZL.js";
+import "../chunk-APIJPTFG.js";
 import {
   clearRegistry,
   createRegistry,
@@ -71,11 +91,15 @@ import {
   registerSchema,
   registerSection
 } from "../chunk-FTPETWXE.js";
-import "../chunk-GGXZZ77Z.js";
+import "../chunk-AASEGXNT.js";
 import "../chunk-NSCT3AMV.js";
 import "../chunk-JSBRDJBE.js";
 export {
   DEFAULT_CHATBOT_NAME,
+  NAV,
+  REFERENCE_TYPE,
+  SIDECARS,
+  TAGS,
   accentVarValue,
   audiencePasses,
   buildGoogleFontsUrl,
@@ -99,26 +123,31 @@ export {
   getIcon,
   getSchema,
   getSection,
-  gridColsClass,
   groupDisplayLabel,
   groupOfPage,
-  loadSiteContent,
+  liftSidecars,
   loadStaticSiteContent,
   mergeSiteContent,
-  navChangeEvent,
   navEntries,
   onPrimaryVarValue,
   pagesInNavOrder,
+  planSidecarWrite,
   primaryVarValue,
+  readSidecar,
+  readSidecarText,
   reconcileNav,
+  reconcileTags,
   registerSchema,
   registerSection,
   relativeLuminance,
   resolveChatbotName,
+  resolveReference,
   resolveThinkingPhrases,
   safeRedirect,
   sanitizeHtml,
+  siteTags,
   suggestAccessibleOn,
+  tagDisplayLabel,
   toSectionId,
   wcagLevel
 };

package/dist/lib/loader.d.ts

@@ -1,34 +1,47 @@
 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;
+    /** Set only on render-time copies a Reference pulled in (resolveReference):
+     *  the id of that Reference. Never loaded or persisted. */
+    referencedBy?: string;
 }
 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;
 }
+/**
+ * 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 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): 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): SiteContent;
-/**
- * Load site content from the filesystem.
- * For use in scripts and tests — Astro pages should use import.meta.glob instead.
- */
-export declare function loadSiteContent(contentDir: string): Promise<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;AAMvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;2BAIuB;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AA+BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAsDb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6C9E"}
+{"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"}