@drawnagency/primitives 0.1.117 → 0.1.119

package/dist/lib/deck-media-refs.js

@@ -1,36 +0,0 @@
-import "../chunk-JSBRDJBE.js";
-
-// src/lib/deck-media-refs.ts
-function step(path, key) {
-  return path === "" ? key : `${path}.${key}`;
-}
-function deckMediaRefSites(deck) {
-  const sites = [];
-  const visit = (node, path) => {
-    if (Array.isArray(node)) {
-      node.forEach((item, i) => visit(item, `${path}[${i}]`));
-      return;
-    }
-    if (typeof node !== "object" || node === null) return;
-    const record = node;
-    if (record.kind === "portal" && typeof record.id === "string" && record.id !== "") {
-      sites.push({ path, id: record.id });
-    }
-    for (const [key, value] of Object.entries(record)) visit(value, step(path, key));
-  };
-  visit(deck, "");
-  return sites;
-}
-function deckMediaIds(deck) {
-  return new Set(deckMediaRefSites(deck).map((site) => site.id));
-}
-function deckUnknownMediaIssues(deck, catalogIds) {
-  return deckMediaRefSites(deck).filter((site) => !catalogIds.has(site.id)).map(
-    (site) => `${step(site.path, "id")}: "${site.id}" is not in the portal media catalog \u2014 use only the ids listed under "Media catalog", copied exactly.`
-  );
-}
-export {
-  deckMediaIds,
-  deckMediaRefSites,
-  deckUnknownMediaIssues
-};

package/dist/lib/deck-tool.d.ts

@@ -1,25 +0,0 @@
-/**
- * The `update_deck` tool the deck-chat loop hands the model (#35, ADR 0001).
- *
- * The input schema is DERIVED from `DeckSchema` rather than written out, so the
- * contract cannot drift from what the server will actually accept: every
- * `.describe()` in the deck schema IS the LLM's documentation, and a field
- * added there reaches the model on the next request with no second edit here.
- *
- * Emitted INLINE (zod's default `reused: "inline"`), not with `$defs`/`$ref`.
- * The ref form is less than half the bytes, but names every shared node
- * `__schema7`, which puts the layout and component descriptions an indirection
- * away from the slot that uses them. The tool block sits in the cached prefix
- * (tools precede `system`, and the corpus block carries the cache breakpoint),
- * so the size is paid once per conversation while the legibility is paid on
- * every turn.
- */
-export declare const UPDATE_DECK_TOOL_NAME = "update_deck";
-export interface DeckToolDefinition {
-    name: string;
-    description: string;
-    /** JSON Schema; the tool's input IS the whole deck. */
-    input_schema: Record<string, unknown>;
-}
-export declare function updateDeckTool(): DeckToolDefinition;
-//# sourceMappingURL=deck-tool.d.ts.map

package/dist/lib/deck-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deck-tool.d.ts","sourceRoot":"","sources":["../../src/lib/deck-tool.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AA8CD,wBAAgB,cAAc,IAAI,kBAAkB,CAenD"}

package/dist/lib/deck-tool.js

@@ -1,58 +0,0 @@
-import {
-  DECK_COMPONENT_TYPES,
-  DECK_LAYOUT_TYPES,
-  DECK_MAX_SLIDES,
-  DECK_SCHEMA_VERSION,
-  DeckSchema
-} from "../chunk-VAYZJKVR.js";
-import "../chunk-JSBRDJBE.js";
-
-// src/lib/deck-tool.ts
-import { z } from "zod";
-var UPDATE_DECK_TOOL_NAME = "update_deck";
-var VOCABULARY = [
-  `Layouts (a slide uses exactly one, and \`type\` must be one of these ${DECK_LAYOUT_TYPES.length}): ${DECK_LAYOUT_TYPES.map((t) => `\`${t}\``).join(", ")}.`,
-  "- `centeredText` \u2014 a title card. Slot: `content` (one Component). Optional `background`: `base` or `brand`.",
-  "- `fullBleedImage` \u2014 the image IS the slide. Takes `media` directly, plus an optional `overlay` panel whose `content` must be a `richText` Component. It has no other slots.",
-  "- `columnSplit` \u2014 two slots, `left` and `right`, each one Component, at a `ratio` of `1-2` or `2-1`.",
-  "",
-  `Components (what fills a Layout slot; \`type\` must be one of these ${DECK_COMPONENT_TYPES.length}): ${DECK_COMPONENT_TYPES.map((t) => `\`${t}\``).join(", ")}.`,
-  "- `richText` \u2014 kicker / heading / subheading / paragraphs / bullets. Text only; no media.",
-  "- `image` \u2014 one `media` reference and an optional caption.",
-  "- `imageGrid` \u2014 two to twelve `items`, each with its own `media`.",
-  "- `video` \u2014 one `media` reference.",
-  "",
-  "There is nothing else. A `type` outside those lists is rejected, and so is a slot a Layout does not have \u2014 do not invent `body`, `columns`, `slots` or `children`."
-].join("\n");
-var DESCRIPTION = [
-  "Replace the ENTIRE deck with a new version. This is how every change to the deck is made \u2014 adding a slide, rewriting a line, reordering, or building the deck from nothing.",
-  "",
-  VOCABULARY,
-  "",
-  "Rules:",
-  "- Emit the COMPLETE deck every time, including slides you are not changing. There is no patch or partial form: whatever you send becomes the deck, and anything you leave out is deleted.",
-  `- Keep \`id\` exactly as it is in the current deck, and keep \`schemaVersion\` at ${DECK_SCHEMA_VERSION}.`,
-  "- Reuse a slide's existing `id` when that slide survives the edit, so revisions stay diffable. Give a genuinely new slide a new lowercase-hyphen id that no other slide uses.",
-  "- Every `media` reference must be a portal media id copied exactly from the Media catalog in your instructions. Never invent one, and never use a filename, path or URL.",
-  `- At most ${DECK_MAX_SLIDES} slides.`,
-  "",
-  "Say what you changed in your reply text; do not restate the deck JSON there."
-].join("\n");
-function updateDeckTool() {
-  const schema = z.toJSONSchema(DeckSchema, {
-    // `io: "input"` is what makes fields with defaults optional — under
-    // "output" the model would be told `background` is required. `unrepresentable
-    // : "any"` is for the superRefines (duplicate slide ids, the "a richText
-    // needs some content" rule); they are enforced server-side by parseDeck,
-    // and their messages are what a failed turn gets handed back.
-    target: "draft-2020-12",
-    io: "input",
-    unrepresentable: "any"
-  });
-  delete schema.$schema;
-  return { name: UPDATE_DECK_TOOL_NAME, description: DESCRIPTION, input_schema: schema };
-}
-export {
-  UPDATE_DECK_TOOL_NAME,
-  updateDeckTool
-};

package/dist/lib/document-input.d.ts

@@ -1,25 +0,0 @@
-import type { MediaManifest } from "../schemas/media";
-import type { Page } from "../schemas/site-config";
-import type { LoadedSection } from "./loader";
-import type { DocImage, DocSourceContent } from "../document";
-/**
- * Map a media manifest to the engine's pre-resolved image dictionary. Port of
- * the harness's `portalImagesFrom` against the real MediaManifest type:
- * - only `kind === "image"` entries (videos/animated skipped);
- * - SVGs → `original.svg` for both preview and print;
- * - other images: previewFile = largest variant ≤ 1080 (else the smallest),
- *   printFile = largest; images with zero variants are skipped.
- * The manifest is already schema-parsed upstream, so no tolerant re-parse here.
- */
-export declare function docImagesFrom(manifest: MediaManifest): Record<string, DocImage>;
-/**
- * Editor path: build the engine's source content from the caller's already-
- * selected page + its draft sections, verbatim. No status/audience filtering —
- * editors see everything (the shell passes in-memory draft content).
- */
-export declare function buildDraftDocumentInput(opts: {
-    page: Page;
-    sections: LoadedSection[];
-    manifest: MediaManifest;
-}): DocSourceContent;
-//# sourceMappingURL=document-input.d.ts.map

package/dist/lib/document-input.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"document-input.d.ts","sourceRoot":"","sources":["../../src/lib/document-input.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAe/E;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;CACzB,GAAG,gBAAgB,CAOnB"}

package/dist/schemas/deck-meta.d.ts

@@ -1,85 +0,0 @@
-import { z } from "zod";
-/**
- * `decks/{deckId}/meta.json` — the sidecar beside a published deck on the
- * Decks Branch (ADR 0002). It carries everything a listing needs, so the list
- * route never reads a single `deck.json`.
- *
- * Ownership is dual-identity from day one (feasibility decision 9): a viewer
- * credential, an editor session, or — on env-mode standalone portals, which
- * have no named credentials — the audience alone. Retrofitting that later
- * would mean rewriting every deck's meta.
- */
-/** Bumped when the sidecar's shape changes in a way old readers can't parse. */
-export declare const DECK_META_SCHEMA_VERSION = 1;
-/**
- * Who owns a deck. `viewer` is the normal case (ownership is credential-keyed);
- * `editor` covers a deck an agency editor built; `audience` is the env-mode
- * standalone degradation, where a shared per-audience password means there is
- * no person to attribute to.
- */
-export declare const DeckOwnerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"viewer">;
-    username: z.ZodString;
-    audience: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"editor">;
-    userId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"audience">;
-    audience: z.ZodString;
-}, z.core.$strip>], "kind">;
-/**
- * Deliberately a LOOSE object: grants and the Public Link token land in later
- * tickets (#36/#37), and a portal running an older package version must not
- * silently strip fields it doesn't know when it rewrites this file. This is the
- * same failure mode the nav sidecar exists to avoid — with unknown keys
- * preserved, an old writer round-trips them instead of deleting them.
- */
-export declare const DeckMetaSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    id: z.ZodString;
-    /** Mirrors deck.title so a listing needs no deck body. */
-    title: z.ZodString;
-    /** Mirrors deck.slides.length, for the same reason. */
-    slideCount: z.ZodNumber;
-    owner: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"viewer">;
-        username: z.ZodString;
-        audience: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"editor">;
-        userId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"audience">;
-        audience: z.ZodString;
-    }, z.core.$strip>], "kind">;
-    createdAt: z.ZodISODateTime;
-    updatedAt: z.ZodISODateTime;
-    /**
-     * Bucket hashes this deck's media resolved to when it was published, and the
-     * whole reason publish-time GC can protect them (ADR 0002).
-     *
-     * A deck references media by MANIFEST ID, and an id is only resolvable to a
-     * bucket hash while the manifest still carries the entry — which is exactly
-     * what stops being true in the case the keep-set exists for: the editor
-     * removes the media from the library, the entry goes, and the object then
-     * looks unreferenced to every reader. Resolving at publish time and recording
-     * the answer here is what survives that. Absent when the deck references no
-     * bucket-backed media, which is every deck until the media components land.
-     */
-    assetHashes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$loose>;
-export type DeckOwner = z.infer<typeof DeckOwnerSchema>;
-export type DeckMeta = z.infer<typeof DeckMetaSchema>;
-export type DeckMetaParseResult = {
-    ok: true;
-    meta: DeckMeta;
-} | {
-    ok: false;
-    errors: string[];
-};
-/** Parse an untrusted meta sidecar, reporting every problem at once. */
-export declare function parseDeckMeta(input: unknown): DeckMetaParseResult;
-/** Pretty-printed with a trailing newline, matching every other repo-stored JSON. */
-export declare function serializeDeckMeta(meta: DeckMeta): string;
-//# sourceMappingURL=deck-meta.d.ts.map

package/dist/schemas/deck-meta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deck-meta.d.ts","sourceRoot":"","sources":["../../src/schemas/deck-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;2BAgB1B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;IAGzB,0DAA0D;;IAE1D,uDAAuD;;;;;;;;;;;;;;;IAKvD;;;;;;;;;;;OAWG;;iBAEH,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjG,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAGjE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAExD"}

package/dist/schemas/deck-meta.js

@@ -1,64 +0,0 @@
-import {
-  DeckIdSchema,
-  formatDeckIssues
-} from "../chunk-VAYZJKVR.js";
-import "../chunk-JSBRDJBE.js";
-
-// src/schemas/deck-meta.ts
-import { z } from "zod";
-var DECK_META_SCHEMA_VERSION = 1;
-var DeckOwnerSchema = z.discriminatedUnion("kind", [
-  z.object({
-    kind: z.literal("viewer"),
-    /** The `viewer_credentials` username — the person-level key. */
-    username: z.string().min(1).max(200),
-    /** The audience that credential signed in as, for editor-side context. */
-    audience: z.string().min(1).max(200)
-  }),
-  z.object({
-    kind: z.literal("editor"),
-    userId: z.string().min(1).max(200)
-  }),
-  z.object({
-    kind: z.literal("audience"),
-    audience: z.string().min(1).max(200)
-  })
-]);
-var DeckMetaSchema = z.looseObject({
-  schemaVersion: z.literal(DECK_META_SCHEMA_VERSION),
-  id: DeckIdSchema,
-  /** Mirrors deck.title so a listing needs no deck body. */
-  title: z.string().min(1).max(120),
-  /** Mirrors deck.slides.length, for the same reason. */
-  slideCount: z.number().int().min(1),
-  owner: DeckOwnerSchema,
-  createdAt: z.iso.datetime(),
-  updatedAt: z.iso.datetime(),
-  /**
-   * Bucket hashes this deck's media resolved to when it was published, and the
-   * whole reason publish-time GC can protect them (ADR 0002).
-   *
-   * A deck references media by MANIFEST ID, and an id is only resolvable to a
-   * bucket hash while the manifest still carries the entry — which is exactly
-   * what stops being true in the case the keep-set exists for: the editor
-   * removes the media from the library, the entry goes, and the object then
-   * looks unreferenced to every reader. Resolving at publish time and recording
-   * the answer here is what survives that. Absent when the deck references no
-   * bucket-backed media, which is every deck until the media components land.
-   */
-  assetHashes: z.array(z.string().min(1)).optional()
-});
-function parseDeckMeta(input) {
-  const result = DeckMetaSchema.safeParse(input);
-  return result.success ? { ok: true, meta: result.data } : { ok: false, errors: formatDeckIssues(result.error) };
-}
-function serializeDeckMeta(meta) {
-  return JSON.stringify(meta, null, 2) + "\n";
-}
-export {
-  DECK_META_SCHEMA_VERSION,
-  DeckMetaSchema,
-  DeckOwnerSchema,
-  parseDeckMeta,
-  serializeDeckMeta
-};