@odla-ai/brand 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -1,7 +1,113 @@
-import { P as ProposalKind, a as ProposalStatus, A as AssetKind, b as AssetAnalysis, B as BookStatus, c as BrandTokensSnapshot, d as PaletteStatus, S as Swatch, e as PaletteSource, f as SectionKind, g as SectionStatus } from './index-CRl3IXHB.cjs';
-export { h as ASSET_KINDS, i as BOOK_STATUSES, j as BRAND_CHART_TOKENS, k as BRAND_CHAT_TOKENS, l as BRAND_DERIVED_TOKENS, m as BRAND_EMITTED_TOKENS, n as BRAND_NS, o as BRAND_REQUIRED_TOKENS, p as BrandTokens, C as CompileInput, q as CompiledBrandTokens, D as DARK_FLIP_L_MAX, r as DARK_FLIP_L_MIN, s as DEFAULT_ACCENT_SEED, I as ImagerySection, L as LogoSection, M as MapResult, t as PALETTE_SOURCES, u as PALETTE_STATUSES, v as PROPOSAL_KINDS, w as PROPOSAL_STATUSES, x as PaletteSection, R as RenderTokensCssOptions, y as SECTION_KINDS, z as SECTION_STATUSES, E as SWATCH_ROLES, F as SwatchRole, T as TokenWarning, G as TypographySection, V as VoiceSection, H as compileBrandTokens, J as deriveDarkTokens, K as mapPaletteToTokens, N as renderTokensCss } from './index-CRl3IXHB.cjs';
+import { P as ProposalKind, a as ProposalStatus, A as AssetKind, b as AssetAnalysis, B as BookStatus, c as BrandTokensSnapshot, d as PaletteStatus, S as Swatch, e as PaletteSource, f as SectionKind, g as SectionStatus, h as SwatchRole } from './index-r36KQK5n.cjs';
+export { i as ASSET_KINDS, j as BOOK_STATUSES, k as BRAND_CHART_TOKENS, l as BRAND_CHAT_TOKENS, m as BRAND_DERIVED_TOKENS, n as BRAND_EMITTED_TOKENS, o as BRAND_NS, p as BRAND_REQUIRED_TOKENS, q as BrandTokens, C as CompileInput, r as CompiledBrandTokens, D as DARK_FLIP_L_MAX, s as DARK_FLIP_L_MIN, t as DEFAULT_ACCENT_SEED, u as DESIGN_ASSET_KIND, I as ImagerySection, L as LogoSection, M as MapResult, v as PALETTE_SOURCES, w as PALETTE_STATUSES, x as PROPOSAL_KINDS, y as PROPOSAL_STATUSES, z as PaletteSection, R as ROLE_TOKEN, E as RenderTokensCssOptions, F as SECTION_KINDS, G as SECTION_STATUSES, H as SWATCH_ROLES, T as TokenWarning, J as TypographySection, V as VoiceSection, K as compileBrandTokens, N as deriveDarkTokens, O as mapPaletteToTokens, Q as renderTokensCss } from './index-r36KQK5n.cjs';
 import { ToolHandler, Skill, ToolDef, Persona, Inference, AgentRunInput, ImageBlock, OracleContentBlock } from '@odla-ai/ai';
 
+/** One entry of the bundle's base64 asset manifest, without its payload. */
+interface DesignBundleAsset {
+    /** The manifest key; also the placeholder the template substitutes. */
+    uuid: string;
+    /** Declared MIME type (`font/woff2`, `image/png`, `text/javascript`, …). */
+    mime: string;
+    /** Decoded byte length, derived from the base64 payload's length. */
+    bytes: number;
+    /** Whether the payload is gzipped (the loader inflates it at runtime). */
+    compressed: boolean;
+}
+/** A parsed bundle: the islands, split out, with payloads left encoded. */
+interface DesignBundle {
+    /** The real document, already JSON-decoded from the template island. */
+    template: string;
+    /** Manifest entries, payload-free. */
+    assets: DesignBundleAsset[];
+    /** CDN URLs the design was authored against (their bytes ship inline). */
+    externals: string[];
+    /** Nested page-bundle uuids (iframe targets); empty for a single page. */
+    pageOrder: string[];
+    /** The loader's poster SVG, if present — a hand-sized preview of the
+     * design that needs no JavaScript to render. */
+    thumbnailSvg?: string;
+}
+/** Assets grouped by MIME type — what a digest reports instead of per-file
+ * rows, since a bundle carries dozens of font subsets. */
+interface DesignAssetGroup {
+    mime: string;
+    count: number;
+    bytes: number;
+}
+/** One configurable prop the design declares (`data-props` on its logic
+ * script): the editor Claude Design renders, its default, and its grouping. */
+interface DesignProp {
+    name: string;
+    /** Editor kind — `text`, `boolean`, `enum`, … as authored. */
+    editor: string;
+    /** Allowed values, for `enum` editors. */
+    options?: string[];
+    /** The declared default, stringified. */
+    default?: string;
+    /** The design's own grouping label (e.g. "Copy", "Layout"). */
+    section?: string;
+    /** The TypeScript type the design declares for the prop. */
+    tsType?: string;
+}
+/** One heading in document order — the design's information architecture. */
+interface DesignOutlineEntry {
+    /** Heading level: 1 for `<h1>` … 6 for `<h6>`. */
+    level: number;
+    text: string;
+}
+/** A literal color the template's CSS uses, with how often it appears. */
+interface DesignColorUse {
+    hex: string;
+    count: number;
+}
+/** The `--ui-*` custom properties a design declares, split by theme. A
+ * design authored against the @odla-ai/ui contract declares these directly,
+ * which is what makes {@link import("./decompile").swatchesFromDesignTokens}
+ * possible. */
+interface DesignTokenSets {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+}
+/**
+ * Everything @odla-ai/brand knows about a design without opening its bytes:
+ * what it weighs, what it depends on, the design tokens it declares, the
+ * props it exposes, and the page outline. Computed deterministically at
+ * upload and stored on the asset row.
+ */
+interface DesignDigest {
+    /** Digest schema marker, so stored digests can be migrated. */
+    format: "claude-design-bundle/1";
+    /** The document's `<title>`, when it sets one. */
+    title?: string;
+    /** Byte length of the decoded template document. */
+    templateBytes: number;
+    /** Total decoded bytes across every manifest asset. */
+    assetBytes: number;
+    /** Manifest asset count. */
+    assetCount: number;
+    /** Assets grouped by MIME type, largest group first. */
+    assetGroups: DesignAssetGroup[];
+    /** CDN URLs the design was built against. */
+    externals: string[];
+    /** Nested page bundles (0 for a single-document design). */
+    pageCount: number;
+    /** `--ui-*` declarations, by theme. */
+    tokens: DesignTokenSets;
+    /** `font-family` values the template names, deduped in first-seen order. */
+    fonts: string[];
+    /** Literal hex colors in the template's CSS, most-used first. */
+    colors: DesignColorUse[];
+    /** The design's declared configuration surface. */
+    props: DesignProp[];
+    /** Headings in document order. */
+    outline: DesignOutlineEntry[];
+    /** The loader's poster SVG, when small enough to carry. */
+    thumbnailSvg?: string;
+    /** What was dropped to stay inside the digest caps, for honesty in the
+     * UI and in agent-facing output. Empty when nothing was truncated. */
+    truncated: string[];
+}
+
 /** Immutable storage snapshot captured by the trusted semantic Brand bridge. */
 interface BrandSourceAssetSnapshot {
     assetId: string;
@@ -245,6 +351,10 @@ interface BrandAsset {
     status: "live" | "deleting" | "deleted";
     title?: string;
     analysis?: AssetAnalysis;
+    /** Present on `design` assets: the digest computed from the bundle at
+     * upload. Deterministic and machine-derived, so it carries no review
+     * state — see {@link import("./design/types").DesignDigest}. */
+    design?: DesignDigest;
     analyzedAt?: number;
     analysisRevision: number;
     analysisDigest?: string;
@@ -458,8 +568,15 @@ declare function brandRules(): BrandRules;
 
 /** Most swatches a single palette may carry. */
 declare const MAX_SWATCHES = 24;
-/** Upload content types the asset pipeline accepts. */
+/** Upload content types the asset pipeline accepts for every kind EXCEPT
+ * `design`. Deliberately free of `text/html`: these bytes are handed back to
+ * members over signed storage URLs, and an HTML document served from a
+ * storage origin is a script-execution surface. */
 declare const ASSET_CONTENT_TYPES: ReadonlySet<string>;
+/** The only content type a `design` asset may carry. Designs are the one
+ * HTML-bearing kind, and they are never served raw — the preview route
+ * proxies them under a `sandbox` CSP (see `routes/design-preview.ts`). */
+declare const DESIGN_CONTENT_TYPES: ReadonlySet<string>;
 /**
  * Assert `value` is a `#rgb`/`#rrggbb` hex color and normalize it to
  * lowercase `#rrggbb`. Alpha channels (`#rgba`/`#rrggbbaa`) and every other
@@ -493,17 +610,50 @@ declare function assertSectionContent(kind: string, content: unknown): Record<st
  */
 declare function safeFileName(name: unknown): string;
 /**
- * Assert an upload content type is on the {@link ASSET_CONTENT_TYPES}
- * allowlist. Normalizes case and strips parameters (`; charset=…`) before
- * checking; returns the normalized bare type.
+ * Assert an upload content type is allowed FOR ITS KIND, and return the
+ * normalized bare type (case-folded, `; charset=…` stripped).
+ *
+ * The allowlist is per-kind, not global: `design` accepts
+ * {@link DESIGN_CONTENT_TYPES} and nothing else, every other kind accepts
+ * {@link ASSET_CONTENT_TYPES} and nothing else. The two sets are disjoint on
+ * purpose — it must be impossible to store HTML under a kind whose bytes are
+ * handed out by signed URL, or to store an image under the kind the preview
+ * route serves as a document.
  */
-declare function assertAssetContentType(value: unknown): string;
+declare function assertAssetContentType(value: unknown, kind?: string): string;
 /**
  * Validate + normalize an agent's asset analysis: description ≤ 2000 chars,
  * ≤ 12 dominant colors (each normalized hex), ≤ 24 tags of ≤ 60 chars.
  */
 declare function assertAnalysis(value: unknown): AssetAnalysis;
 
+/**
+ * A stored row in the shape it was WRITTEN, ready to verify.
+ *
+ * The engine stores a `date` as the epoch ms it was given and hands a reader
+ * ISO-8601 text back. Brand digests rows that CONTAIN dates — a proposal's
+ * `reviewDigest` covers its `createdAt`, and an approval receipt's
+ * `receiptDigest` covers its own — so a row read straight out of the store can
+ * never match the digest stored beside it. Two production symptoms, both 409:
+ * resolving any proposal ("proposal changed since review") and reading a book's
+ * tokens after approval.
+ *
+ * Normalising at the READ is the fix, not tolerating both shapes in the
+ * verifier. Tolerance would repair a `safeTime` check and leave the digest
+ * failing, because the digest was taken over the number and nothing can change
+ * that after the fact.
+ *
+ * Anything that is not date-shaped text passes through untouched, so a row that
+ * never round-tripped verifies exactly as before. `json` attrs are left alone:
+ * their contents round-trip as written, which is why an `authorityConsumption`
+ * and the `createdAt` beside it disagreed at all.
+ */
+declare function rowAsWritten<T>(ns: string, row: T): T;
+/** A stored approval receipt in the shape it was written. */
+declare function receiptAsWritten<T>(row: T): T;
+/** A stored proposal in the shape it was written, so `reviewDigest` matches. */
+declare function proposalAsWritten<T>(row: T): T;
+
 /** Stay materially below the server's whole-guards parser budget. */
 declare function isBoundedBrandJson(root: unknown, limits?: {
     maxDepth?: number;
@@ -741,6 +891,8 @@ interface CreateAssetInput {
     uploadedAuthorityRef: string;
     audience: string[];
     title?: string;
+    /** `design` kind only: the digest parsed from the uploaded bundle. */
+    design?: DesignDigest;
     now: number;
 }
 /**
@@ -763,6 +915,216 @@ declare function finishAssetDeleteOps(assetId: BrandEntityRef): BrandOp[];
  */
 declare function recordAnalysisOps(assetId: BrandEntityRef, analysis: unknown, priorRevision: number, analyzedBy: string, analyzedAuthorityRef: string, now: number): Promise<BrandOp[]>;
 
+/** Longest poster SVG carried into a digest; larger ones are dropped. */
+declare const MAX_THUMBNAIL_CHARS = 16384;
+/**
+ * Cheap structural sniff: does this text look like a Claude Design bundle?
+ * Checks for the two islands that carry the design itself, so a plain HTML
+ * page (or an unrelated file that happens to be HTML) is rejected before any
+ * parsing work happens.
+ */
+declare function isDesignBundle(html: string): boolean;
+/** Decoded byte length of a base64 payload, without decoding it. */
+declare function base64ByteLength(data: string): number;
+/**
+ * The loader's poster: the `<svg>` inside `#__bundler_thumbnail`. It renders
+ * with no JavaScript and no blob URLs, so it is the one part of a design that
+ * can be shown anywhere. Returns undefined when absent or over
+ * {@link MAX_THUMBNAIL_CHARS}.
+ */
+declare function extractThumbnailSvg(html: string): string | undefined;
+/** One manifest entry WITH its base64 payload. */
+interface DesignManifestEntry {
+    mime: string;
+    compressed: boolean;
+    /** Base64 payload, gzipped first when `compressed`. */
+    data: string;
+}
+/**
+ * Read the manifest island's entries INCLUDING their payloads, keyed by uuid.
+ *
+ * Everything else in this module deliberately leaves payloads encoded and
+ * only measures them, because the worker never needs the bytes. This is the
+ * one exception, for callers that genuinely write assets out — the CLI's
+ * `brand design unpack`. It holds the whole manifest in memory, so use it
+ * only where that is affordable.
+ */
+declare function readDesignManifest(html: string): Record<string, DesignManifestEntry>;
+/**
+ * Parse a Claude Design standalone-HTML export into its parts: the real
+ * document (JSON-decoded from the template island), payload-free manifest
+ * summaries, the external-resource index, nested page uuids, and the poster
+ * SVG.
+ *
+ * Throws {@link BrandInputError} when the text is not a bundle or an island
+ * is malformed — the messages are safe to return to a caller as a 400.
+ */
+declare function parseDesignBundle(html: string): DesignBundle;
+
+/** One declaration the scanner found, with the selectors it was nested in. */
+interface ScannedDeclaration {
+    /** Outermost → innermost selector/at-rule preludes. */
+    selectors: string[];
+    /** Property name, including the leading `--`. */
+    name: string;
+    /** Declaration value, trimmed, with comments already removed. */
+    value: string;
+}
+/** Remove `/* … *​/` comments so they cannot break declaration splitting. */
+declare function stripCssComments(css: string): string;
+/**
+ * Concatenate every `<style>` element's text in document order. Designs ship
+ * their theme as a sequence of style blocks (a vendored base tier, then
+ * overrides), and the cascade between them is exactly this order.
+ */
+declare function styleSheetText(html: string): string;
+/**
+ * Walk `css` and yield every custom-property declaration with its enclosing
+ * selector stack, in document order. Brace and paren depth are tracked so
+ * nested at-rules (`@media { :root { … } }`) and parenthesised values
+ * (`color-mix(in srgb, …)`) are handled correctly.
+ *
+ * Only `--*` declarations are reported; ordinary properties are skipped.
+ */
+declare function scanCustomProperties(css: string): ScannedDeclaration[];
+
+/** One token that could not become a swatch, and why. */
+interface DesignTokenSkip {
+    token: string;
+    value: string;
+    reason: string;
+}
+/** What {@link swatchesFromDesignTokens} produced. */
+interface DesignDecompilation {
+    swatches: Swatch[];
+    /** Tokens present but not literal opaque colours. */
+    skipped: DesignTokenSkip[];
+    /** Roles the design declared no token for at all. */
+    missing: SwatchRole[];
+}
+/** Parse one CSS colour value to `#rrggbb`, or null when it is not a literal
+ * opaque colour. Accepts hex and `rgb()`/`rgba()` with alpha exactly 1. */
+declare function cssColorToHex(value: string): string | null;
+/**
+ * Read a design's declared `--ui-*` tokens back into brand swatches.
+ *
+ * Reads the LIGHT set: brand palettes are authored light-first and
+ * `deriveDarkTokens` regenerates dark on compile, so importing a design's
+ * dark values would be overwritten anyway. The design's dark tokens stay
+ * visible in the digest for reference.
+ */
+declare function swatchesFromDesignTokens(tokens: DesignTokenSets): DesignDecompilation;
+
+/** Most external-resource URLs carried into a digest. */
+declare const MAX_EXTERNALS = 24;
+/** Group manifest assets by MIME type, heaviest group first. */
+declare function groupAssets(bundle: DesignBundle): DesignAssetGroup[];
+/**
+ * Build the digest for an already-parsed bundle.
+ *
+ * `templateBytes` is measured in UTF-8 bytes, not characters, so it matches
+ * what the CLI writes to disk for a template full of typographic quotes.
+ */
+declare function digestDesignBundle(bundle: DesignBundle): DesignDigest;
+/**
+ * Parse a Claude Design standalone-HTML export and digest it in one step.
+ * Throws {@link import("../errors").BrandInputError} when the file is not a
+ * design bundle.
+ */
+declare function digestDesignHtml(html: string): DesignDigest;
+
+/** Decode the named and numeric HTML entities that appear in real markup. */
+declare function decodeEntities(text: string): string;
+/** Collapse every run of whitespace to a single space and trim. */
+declare const collapseWhitespace: (text: string) => string;
+/**
+ * Strip tags and decode entities, yielding the visible text of a markup
+ * fragment. Script and style element contents are dropped whole — a heading
+ * containing an inline `<style>` would otherwise contribute CSS as prose.
+ */
+declare function htmlToText(fragment: string): string;
+
+/** Most headings carried into a digest. */
+declare const MAX_OUTLINE_ENTRIES = 120;
+/** Longest single heading kept, in characters. */
+declare const MAX_HEADING_CHARS = 200;
+/** The document `<title>`, decoded and collapsed; undefined when unset. */
+declare function extractTitle(html: string): string | undefined;
+/**
+ * Headings (`<h1>`…`<h6>`) in document order, as level + visible text.
+ *
+ * Empty headings — icon-only or decorative — are skipped rather than emitted
+ * as blanks. The scan stops at {@link MAX_OUTLINE_ENTRIES}; the caller
+ * reports the truncation in the digest.
+ */
+declare function extractOutline(html: string): {
+    entries: DesignOutlineEntry[];
+    truncated: boolean;
+};
+
+/** Most props carried into a digest. */
+declare const MAX_PROPS = 60;
+/**
+ * Extract the design's declared props, in declaration order.
+ *
+ * Returns an empty list — never throws — when the design declares none or
+ * the attribute is unparseable: props are a bonus signal, and a design
+ * without them is still perfectly usable.
+ */
+declare function extractProps(html: string): {
+    props: DesignProp[];
+    truncated: boolean;
+};
+
+/** Most typeface families reported. */
+declare const MAX_FONTS = 16;
+/** Most distinct literal colours reported. */
+declare const MAX_COLORS = 24;
+/**
+ * The typeface families a design uses: the ones it embeds when it embeds
+ * any, otherwise the quoted families its font stacks name, ranked by how
+ * often they appear.
+ */
+declare function extractFonts(templateHtml: string): string[];
+/**
+ * Literal `#rrggbb`/`#rgb` colours in the design's CSS, most-used first.
+ *
+ * Complements the token extractor rather than duplicating it: tokens say
+ * what the design DECLARES as its contract, this says what its stylesheets
+ * actually paint with — including one-off colours never promoted to a token.
+ * Function-syntax colours (`rgba()`, `color-mix()`, `oklch()`) are not
+ * counted; they carry alpha or composition that a flat hex tally would
+ * misrepresent.
+ */
+declare function extractColors(templateHtml: string): DesignColorUse[];
+
+/**
+ * Substitute every `var(--name[, fallback])` in `value` using `table`,
+ * recursively. An unresolvable reference falls back to its declared fallback
+ * when it has one, and is otherwise left literal so the caller can see that
+ * the value did not resolve.
+ */
+declare function resolveVarRefs(value: string, table: ReadonlyMap<string, string>, depth?: number): string;
+/**
+ * Extract the `--ui-*` tokens a design effectively declares, per theme, with
+ * var() chains resolved to their computed text.
+ *
+ * Declarations are read from document-level selectors only (`:root`, `html`,
+ * `[data-theme=…]`, `.ui-invert`); component-scoped custom properties are
+ * ignored. Dark inherits every light token it does not override, mirroring
+ * how theme sheets are written.
+ */
+declare function extractDesignTokens(templateHtml: string): DesignTokenSets;
+
+/**
+ * WCAG contrast ratios (2 dp) for a palette's key role pairs, stored
+ * verbatim in the proposal payload so review is numbers, not vibes.
+ *
+ * Every foreground is measured against the palette's own `bg` (white when
+ * it declares none), plus the readability of text placed on `primary`.
+ */
+declare function contrastReport(swatches: Swatch[]): Record<string, number>;
+
 /** An sRGB color with channels as fractions in [0, 1]. */
 interface Rgb {
     /** Red channel, 0..1. */
@@ -1127,6 +1489,10 @@ interface BrandToolCtx {
         expectedAnalysisRevision: number;
     }): Promise<BrandAsset>;
     readAssetContent(assetId: string): Promise<BrandFetchedBytes>;
+    /** The decoded template document of a `design` asset. Memoized per skill
+     * instance: a bundle is megabytes, and `read_design_source` is designed to
+     * be called repeatedly while an agent ports markup. */
+    readDesignTemplate(assetId: string): Promise<string>;
     resolvePrincipals(ids: string[]): Promise<BrandPrincipalProjection[]>;
     authority(capability: BrandCapability): Promise<BrandCapabilityAuthority>;
     /** Load the scoped book row; throws BrandNotFoundError when missing. */
@@ -1139,7 +1505,7 @@ interface BrandToolCtx {
  * instruction section. */
 declare const BRAND_INSTRUCTIONS: string;
 /**
- * Build the brand Skill: read/asset/palette/book tools scoped to one book,
+ * Build the brand Skill: read/asset/design/palette/book tools scoped to one book,
  * acting as one bot identity, plus {@link BRAND_INSTRUCTIONS}. Attach it to
  * a Persona (or use `createBrandPersona`).
  */
@@ -1290,6 +1656,10 @@ interface BrandRouteOpts {
      * private Brand asset. Callers never provide this URL or receive it back.
      */
     fetchPrivateAsset?: typeof fetch;
+    /** `frame-ancestors` for the design preview response — who may embed a
+     * design. Default `["'self'"]`. Widen only to origins you control: the
+     * preview renders untrusted design HTML. */
+    previewFrameAncestors?: string[];
     /** Upload size cap in bytes (checked against `File.size`). Default 8 MiB. */
     maxUploadBytes?: number;
     /** Serve `GET /books/:id/tokens.css` and `tokens.json` without authorize —
@@ -1313,6 +1683,7 @@ interface BrandRouteCtx {
     maxUploadBytes: number;
     discussionBasePath: string;
     fetchPrivateAsset: typeof fetch;
+    previewFrameAncestors: string[];
 }
 
 /** Freeze the exact OPEN proposal fields a reviewer sees. */
@@ -1530,4 +1901,4 @@ interface CreateBrandIntegrationOptions {
  */
 declare function createBrandIntegration(options?: CreateBrandIntegrationOptions): BrandIntegrationDescriptor;
 
-export { ASSET_CONTENT_TYPES, type AcceptProposalInput, AssetAnalysis, AssetKind, type AttrType, type AudienceChildren, BRAND_AGENT_PROFILE, BRAND_DISCUSSION_REFERENCE_KINDS, BRAND_INSTRUCTIONS, BRAND_RULES, BRAND_SCHEMA, BookStatus, type BrandActor, type BrandAgentBridge, type BrandAgentProfile, type BrandApprovalReceipt, type BrandAsset, type BrandAttrs, type BrandBook, type BrandBotTriggerOpts, type BrandCapabilityAuthority, BrandConflictError, type BrandDb, type BrandDecisionBinding, type BrandDeps, type BrandDiscussionReference, type BrandDiscussionReferenceKind, type BrandDiscussionReferenceTarget, type BrandDiscussionSwatch, type BrandDispatchBody, type BrandDispatchDeps, type BrandEntityRef, type BrandFetchedBytes, type BrandFileRecord, BrandForbiddenError, BrandGoneError, type BrandHumanAuthorityConsumption, BrandInputError, type BrandIntegrationDescriptor, type BrandIntegrationProbe, type BrandLookup, BrandNotFoundError, type BrandOp, type BrandPalette, type BrandPrincipalProjection, type BrandProposal, type BrandProposalProvenance, type BrandProposalReviewSnapshot, type BrandResult, BrandReviewStateChangedError, type BrandRouteCtx, type BrandRouteOpts, type BrandRow, type BrandRule, type BrandRules, type BrandScalar, type BrandSection, type BrandSkillOpts, type BrandSkillSelf, type BrandSourceAssetSnapshot, type BrandStorage, BrandTokensSnapshot, type BrandToolCtx, type BrandTransactGuard, type BrandTransactOptions, type BrandTrigger, type BrandUploadBody, type BrandVisionCapabilities, type BrandVisionSpec, CHART_DELTA_MIN, CHAT_MESSAGE_NS, CSS_NAMED_COLORS, type ContrastKind, type CreateAssetInput, type CreateBookInput, type CreateBrandIntegrationOptions, type CreateBrandPersonaOpts, DEFAULT_BRAND_SYSTEM, type DeriveChartOptions, type DerivePaletteOptions, type Hsl, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type LightnessDirection, MAX_SWATCHES, MAX_VIEW_BYTES, type NamedColor, type NearestNamedColor, type Oklab, type Oklch, PICK_TEXT_DEFAULT_CANDIDATES, PaletteSource, PaletteStatus, ProposalKind, ProposalStatus, type ProposePaletteInput, type ProposeSectionInput, RAMP_L_MAX, RAMP_L_MIN, type RejectProposalInput, type ResolvedBrandDeps, type Rgb, SectionKind, SectionStatus, type SerializedAttr, type SerializedEntity, type SerializedLink, type SerializedLinkEnd, type SerializedSchema, Swatch, type UpsertSectionInput, acceptProposalOps, adjustLightnessUntil, analogous, assertAnalysis, assertAssetContentType, assertHex, assertSectionContent, assertSwatches, assetTools, attachedBrandAssetIds, audienceFanoutOps, base64FromBytes, beginAssetDeleteOps, bookForChannel, bookTools, brandAuthorityRef, brandBotTrigger, brandDiscussionReferenceHref, brandDiscussionReferenceId, brandInputFor, brandIntegration, brandJsonDigest, brandRules, brandSkill, canonicalBrandJson, capString, capStringArray, clamp01, clampToGamut, complementary, contrastRatio, createAssetOps, createBookOps, createBrandIntegration, createBrandPersona, createBrandRoutes, deltaEOK, deltaEOKLab, deriveChartColors, derivePalette, dispatchBrandTurn, finishAssetDeleteOps, formatBrandDiscussionReference, hexToOklch, hslToRgb, inSrgbGamut, isBoundedBrandJson, isBrandHumanAuthorityConsumption, linearToSrgb, meetsAA, meetsAAA, monochrome, nearestNamedColor, normalizeHex, oklabToOklch, oklabToRgb, oklchToHex, oklchToOklab, paletteTools, parseBrandDiscussionReference, parseBrandDispatch, parseHex, pickTextOn, proposalReviewSnapshot, proposePaletteOps, proposeSectionOps, readTools, recordAnalysisOps, rejectProposalOps, relativeLuminance, resolveDeps, rgbToHsl, rgbToOklab, rotateHue, safeFileName, sectionKey, splitComplementary, srgbToLinear, supportsBrandVision, tetradic, tintShadeRamp, toHex, triadic, updateBookOps, upsertSectionOps, verifyBrandApprovalReceipt };
+export { ASSET_CONTENT_TYPES, type AcceptProposalInput, AssetAnalysis, AssetKind, type AttrType, type AudienceChildren, BRAND_AGENT_PROFILE, BRAND_DISCUSSION_REFERENCE_KINDS, BRAND_INSTRUCTIONS, BRAND_RULES, BRAND_SCHEMA, BookStatus, type BrandActor, type BrandAgentBridge, type BrandAgentProfile, type BrandApprovalReceipt, type BrandAsset, type BrandAttrs, type BrandBook, type BrandBotTriggerOpts, type BrandCapabilityAuthority, BrandConflictError, type BrandDb, type BrandDecisionBinding, type BrandDeps, type BrandDiscussionReference, type BrandDiscussionReferenceKind, type BrandDiscussionReferenceTarget, type BrandDiscussionSwatch, type BrandDispatchBody, type BrandDispatchDeps, type BrandEntityRef, type BrandFetchedBytes, type BrandFileRecord, BrandForbiddenError, BrandGoneError, type BrandHumanAuthorityConsumption, BrandInputError, type BrandIntegrationDescriptor, type BrandIntegrationProbe, type BrandLookup, BrandNotFoundError, type BrandOp, type BrandPalette, type BrandPrincipalProjection, type BrandProposal, type BrandProposalProvenance, type BrandProposalReviewSnapshot, type BrandResult, BrandReviewStateChangedError, type BrandRouteCtx, type BrandRouteOpts, type BrandRow, type BrandRule, type BrandRules, type BrandScalar, type BrandSection, type BrandSkillOpts, type BrandSkillSelf, type BrandSourceAssetSnapshot, type BrandStorage, BrandTokensSnapshot, type BrandToolCtx, type BrandTransactGuard, type BrandTransactOptions, type BrandTrigger, type BrandUploadBody, type BrandVisionCapabilities, type BrandVisionSpec, CHART_DELTA_MIN, CHAT_MESSAGE_NS, CSS_NAMED_COLORS, type ContrastKind, type CreateAssetInput, type CreateBookInput, type CreateBrandIntegrationOptions, type CreateBrandPersonaOpts, DEFAULT_BRAND_SYSTEM, DESIGN_CONTENT_TYPES, type DeriveChartOptions, type DerivePaletteOptions, type DesignAssetGroup, type DesignBundle, type DesignBundleAsset, type DesignColorUse, type DesignDecompilation, type DesignDigest, type DesignManifestEntry, type DesignOutlineEntry, type DesignProp, type DesignTokenSets, type DesignTokenSkip, type Hsl, type IntegrationProvision, type IntegrationSecret, type IntegrationSetting, type LightnessDirection, MAX_COLORS, MAX_EXTERNALS, MAX_FONTS, MAX_HEADING_CHARS, MAX_OUTLINE_ENTRIES, MAX_PROPS, MAX_SWATCHES, MAX_THUMBNAIL_CHARS, MAX_VIEW_BYTES, type NamedColor, type NearestNamedColor, type Oklab, type Oklch, PICK_TEXT_DEFAULT_CANDIDATES, PaletteSource, PaletteStatus, ProposalKind, ProposalStatus, type ProposePaletteInput, type ProposeSectionInput, RAMP_L_MAX, RAMP_L_MIN, type RejectProposalInput, type ResolvedBrandDeps, type Rgb, type ScannedDeclaration, SectionKind, SectionStatus, type SerializedAttr, type SerializedEntity, type SerializedLink, type SerializedLinkEnd, type SerializedSchema, Swatch, SwatchRole, type UpsertSectionInput, acceptProposalOps, adjustLightnessUntil, analogous, assertAnalysis, assertAssetContentType, assertHex, assertSectionContent, assertSwatches, assetTools, attachedBrandAssetIds, audienceFanoutOps, base64ByteLength, base64FromBytes, beginAssetDeleteOps, bookForChannel, bookTools, brandAuthorityRef, brandBotTrigger, brandDiscussionReferenceHref, brandDiscussionReferenceId, brandInputFor, brandIntegration, brandJsonDigest, brandRules, brandSkill, canonicalBrandJson, capString, capStringArray, clamp01, clampToGamut, collapseWhitespace, complementary, contrastRatio, contrastReport, createAssetOps, createBookOps, createBrandIntegration, createBrandPersona, createBrandRoutes, cssColorToHex, decodeEntities, deltaEOK, deltaEOKLab, deriveChartColors, derivePalette, digestDesignBundle, digestDesignHtml, dispatchBrandTurn, extractColors, extractDesignTokens, extractFonts, extractOutline, extractProps, extractThumbnailSvg, extractTitle, finishAssetDeleteOps, formatBrandDiscussionReference, groupAssets, hexToOklch, hslToRgb, htmlToText, inSrgbGamut, isBoundedBrandJson, isBrandHumanAuthorityConsumption, isDesignBundle, linearToSrgb, meetsAA, meetsAAA, monochrome, nearestNamedColor, normalizeHex, oklabToOklch, oklabToRgb, oklchToHex, oklchToOklab, paletteTools, parseBrandDiscussionReference, parseBrandDispatch, parseDesignBundle, parseHex, pickTextOn, proposalAsWritten, proposalReviewSnapshot, proposePaletteOps, proposeSectionOps, readDesignManifest, readTools, receiptAsWritten, recordAnalysisOps, rejectProposalOps, relativeLuminance, resolveDeps, resolveVarRefs, rgbToHsl, rgbToOklab, rotateHue, rowAsWritten, safeFileName, scanCustomProperties, sectionKey, splitComplementary, srgbToLinear, stripCssComments, styleSheetText, supportsBrandVision, swatchesFromDesignTokens, tetradic, tintShadeRamp, toHex, triadic, updateBookOps, upsertSectionOps, verifyBrandApprovalReceipt };