gazetta 0.5.0 → 0.7.0

package/dist/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAOrE"}

package/dist/robots.js

@@ -0,0 +1,25 @@
+/**
+ * Robots.txt generation — produces a default robots.txt or copies
+ * a user-authored one from the site directory.
+ *
+ * SRP: this module owns robots.txt content resolution. The caller
+ * checks for a user file and writes the result to storage.
+ *
+ * Strategy:
+ *   1. If the site has a `robots.txt` file, use it verbatim.
+ *   2. Otherwise, generate a permissive default with a Sitemap
+ *      reference (when siteUrl is available).
+ */
+/**
+ * Generate a default robots.txt. Permissive (allow all crawlers)
+ * with a Sitemap reference when siteUrl is available.
+ */
+export function generateRobotsTxt(opts) {
+    const lines = ['User-agent: *', 'Allow: /'];
+    if (opts.siteUrl) {
+        const base = opts.siteUrl.replace(/\/+$/, '');
+        lines.push('', `Sitemap: ${base}/sitemap.xml`);
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=robots.js.map

package/dist/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;IAC3C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,IAAI,cAAc,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAChC,CAAC"}

package/dist/schema/dimensions.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Asset override dimensions — the axes along which an asset's bytes,
+ * variants, and metadata can vary from its default.
+ *
+ * v1 ships two first-class dimensions:
+ *   - `locale` — content-level (e.g. text baked into image varies by language)
+ *   - `theme`  — presentation-level (e.g. logo with light/dark variants)
+ *
+ * Both are peer dimensions in the abstract model. Each asset can opt into
+ * any combination — a logo might have `(en, dark)`, `(fr, dark)`, `(de, dark)`
+ * variants but no light-mode variants because the default works for light.
+ *
+ * # Why a closed dimension set
+ *
+ * A user-defined dimension model (arbitrary axes per site) was rejected
+ * during foundation design. 90% of value is locale + theme; arbitrary
+ * dimensions complicate the picker UI, fallback chain semantics, and
+ * filename composition with no concrete demand. Adding a third dimension
+ * later means extending this union and `DIMENSION_ORDER` — mechanical.
+ *
+ * # Filename composition
+ *
+ * `DIMENSION_ORDER` fixes the order in which dimensions appear in
+ * filenames. `{name}.asset.{locale}.{theme}.json` (locale before theme).
+ * Changing the order would re-key every existing locale-only manifest, so
+ * it's locked: locale always first.
+ *
+ * # Selector semantics
+ *
+ * A `Selector` represents a specific combination of dimension values.
+ * `null` selector = "default-default" (no overrides; the canonical asset).
+ * Empty `Selector` Map is structurally invalid — callers must use `null`
+ * to express "no dimensions selected." Validators enforce.
+ */
+/** The set of override dimensions an asset can vary along. */
+export type DimensionName = 'locale' | 'theme';
+/**
+ * Order in which dimensions appear in composed filenames. Locked: locale
+ * before theme. Adding a new dimension extends this constant; existing
+ * filenames stay valid because they have no value for the new dimension.
+ */
+export declare const DIMENSION_ORDER: readonly DimensionName[];
+/**
+ * A specific combination of dimension values that addresses one asset
+ * variant (or the default, when null).
+ *
+ * Examples:
+ *   `null` — the default asset
+ *   `Map { 'locale' → 'fr' }` — French (default theme)
+ *   `Map { 'locale' → 'fr', 'theme' → 'dark' }` — French + dark
+ *   `Map { 'theme' → 'dark' }` — dark (default locale)
+ */
+export type Selector = ReadonlyMap<DimensionName, string>;
+/** True when `selector` has at least one dimension set. */
+export declare function isNonEmptySelector(selector: Selector | null): selector is Selector;
+/**
+ * Build a Selector from individual dimension values, omitting unset ones.
+ * Returns `null` when all dimensions are absent — semantically equivalent
+ * to "the default asset."
+ */
+export declare function buildSelector(values: Partial<Record<DimensionName, string>>): Selector | null;
+/**
+ * Compose the path-suffix portion of a filename for a selector. Walks
+ * `DIMENSION_ORDER` so the order is deterministic regardless of insertion
+ * order in the underlying Map.
+ *
+ *   null                           → ''           (no suffix)
+ *   { locale: 'fr' }               → '.fr'
+ *   { theme: 'dark' }              → '.dark'
+ *   { locale: 'fr', theme: 'dark'} → '.fr.dark'
+ */
+export declare function selectorSuffix(selector: Selector | null): string;
+/**
+ * Two selectors are equivalent when they have the same dimensions set
+ * to the same values, ignoring iteration order.
+ */
+export declare function selectorsEqual(a: Selector | null, b: Selector | null): boolean;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/schema/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/schema/dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAAwB,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;AAEzD,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,IAAI,QAAQ,CAElF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,GAAG,IAAI,CAO7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,MAAM,CAQhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAQ9E"}

package/dist/schema/dimensions.js

@@ -0,0 +1,97 @@
+/**
+ * Asset override dimensions — the axes along which an asset's bytes,
+ * variants, and metadata can vary from its default.
+ *
+ * v1 ships two first-class dimensions:
+ *   - `locale` — content-level (e.g. text baked into image varies by language)
+ *   - `theme`  — presentation-level (e.g. logo with light/dark variants)
+ *
+ * Both are peer dimensions in the abstract model. Each asset can opt into
+ * any combination — a logo might have `(en, dark)`, `(fr, dark)`, `(de, dark)`
+ * variants but no light-mode variants because the default works for light.
+ *
+ * # Why a closed dimension set
+ *
+ * A user-defined dimension model (arbitrary axes per site) was rejected
+ * during foundation design. 90% of value is locale + theme; arbitrary
+ * dimensions complicate the picker UI, fallback chain semantics, and
+ * filename composition with no concrete demand. Adding a third dimension
+ * later means extending this union and `DIMENSION_ORDER` — mechanical.
+ *
+ * # Filename composition
+ *
+ * `DIMENSION_ORDER` fixes the order in which dimensions appear in
+ * filenames. `{name}.asset.{locale}.{theme}.json` (locale before theme).
+ * Changing the order would re-key every existing locale-only manifest, so
+ * it's locked: locale always first.
+ *
+ * # Selector semantics
+ *
+ * A `Selector` represents a specific combination of dimension values.
+ * `null` selector = "default-default" (no overrides; the canonical asset).
+ * Empty `Selector` Map is structurally invalid — callers must use `null`
+ * to express "no dimensions selected." Validators enforce.
+ */
+/**
+ * Order in which dimensions appear in composed filenames. Locked: locale
+ * before theme. Adding a new dimension extends this constant; existing
+ * filenames stay valid because they have no value for the new dimension.
+ */
+export const DIMENSION_ORDER = ['locale', 'theme'];
+/** True when `selector` has at least one dimension set. */
+export function isNonEmptySelector(selector) {
+    return selector !== null && selector.size > 0;
+}
+/**
+ * Build a Selector from individual dimension values, omitting unset ones.
+ * Returns `null` when all dimensions are absent — semantically equivalent
+ * to "the default asset."
+ */
+export function buildSelector(values) {
+    const map = new Map();
+    for (const dim of DIMENSION_ORDER) {
+        const v = values[dim];
+        if (v !== undefined)
+            map.set(dim, v);
+    }
+    return map.size > 0 ? map : null;
+}
+/**
+ * Compose the path-suffix portion of a filename for a selector. Walks
+ * `DIMENSION_ORDER` so the order is deterministic regardless of insertion
+ * order in the underlying Map.
+ *
+ *   null                           → ''           (no suffix)
+ *   { locale: 'fr' }               → '.fr'
+ *   { theme: 'dark' }              → '.dark'
+ *   { locale: 'fr', theme: 'dark'} → '.fr.dark'
+ */
+export function selectorSuffix(selector) {
+    if (!selector)
+        return '';
+    const parts = [];
+    for (const dim of DIMENSION_ORDER) {
+        const v = selector.get(dim);
+        if (v !== undefined)
+            parts.push(v);
+    }
+    return parts.length > 0 ? `.${parts.join('.')}` : '';
+}
+/**
+ * Two selectors are equivalent when they have the same dimensions set
+ * to the same values, ignoring iteration order.
+ */
+export function selectorsEqual(a, b) {
+    if (a === null && b === null)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (a.size !== b.size)
+        return false;
+    for (const [k, v] of a) {
+        if (b.get(k) !== v)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/schema/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/schema/dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AAc5E,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA8C;IAC1E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC5C,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAClC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxB,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAkB,EAAE,CAAkB;IACnE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACnC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;IAClC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/schema/helpers.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Zod schema helpers for asset references.
+ *
+ * Three helpers (`embeddedAsset`, `downloadable`, `fontAsset`), each emitting
+ * a Zod object schema branded with its asset kind via `.brand()`. The brand
+ * is phantom (type-level only) — runtime consumers see a plain Zod object.
+ *
+ * Shared grammar:
+ * - `AcceptFilter` — the filter used by picker UIs to narrow the set of
+ *   assets offered for a field. Kind names (`'image'`, `'video'`, `'audio'`,
+ *   `'document'`, `'font'`, `'other'`), MIME prefixes (`'image/'`), or exact
+ *   MIMEs (`'image/svg+xml'`). Shared because all three helpers accept it.
+ *
+ * Brand values — consumed by `Content<T>` in types.ts:
+ * - `embeddedAsset()` → `.brand<'embedded'>()`
+ * - `downloadable()` → `.brand<'downloadable'>()`
+ * - `fontAsset()` → `.brand<'font'>()`
+ */
+import { z } from 'zod';
+/**
+ * Acceptance filter — passed to picker UIs to narrow which assets are offered.
+ * Shared across all three helpers.
+ */
+export type AcceptFilter = 'image' | 'video' | 'audio' | 'document' | 'font' | 'other' | `${string}/` | `${string}/${string}`;
+export interface EmbeddedAssetOptions {
+    /** Which assets the picker should offer. Default: any embedded kind (image, video, audio). */
+    accept?: AcceptFilter[];
+    /** Show per-reference alt override UI. Default: true for images, false otherwise. */
+    altOverride?: boolean;
+    /** Warn at save if alt is null on this reference. Default: false. */
+    altRequired?: boolean;
+    /** Show per-reference focal-point override UI. Default: true for images. */
+    focalPointOverride?: boolean;
+}
+/**
+ * Zod helper for an embedded asset reference — rendered inline by templates
+ * (`<img>`, `<video>`, `<audio>`). Templates receive `ResolvedEmbeddedAsset`
+ * after the resolver merges the manifest with per-reference overrides.
+ */
+export declare function embeddedAsset(options?: EmbeddedAssetOptions): z.core.$ZodBranded<z.ZodObject<{
+    _asset: z.ZodString;
+    alt: z.ZodOptional<z.ZodString>;
+    focalPoint: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, "embedded", "out">;
+export interface DownloadableOptions {
+    /** Which files the picker should offer. Default: any non-embedded kind. */
+    accept?: AcceptFilter[];
+    /** Show per-reference title override UI. Default: true. */
+    titleOverride?: boolean;
+    /** Show per-reference description field. Default: true. */
+    descriptionOverride?: boolean;
+}
+/**
+ * Zod helper for a downloadable asset reference — rendered as `<a href download>`
+ * by templates. Templates receive `ResolvedDownloadableAsset`.
+ */
+export declare function downloadable(options?: DownloadableOptions): z.core.$ZodBranded<z.ZodObject<{
+    _asset: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, "downloadable", "out">;
+export interface FontAssetOptions {
+    /** Which font formats the picker should offer. Default: all supported. */
+    accept?: ('woff2' | 'woff' | 'ttf' | 'otf')[];
+    /** Expects a variable font (single file, axis-driven weights). Default: false. */
+    variable?: boolean;
+}
+/**
+ * Zod helper for a font asset reference — templates emit `@font-face` declarations
+ * from the resolved variants. Locale manifests add variants to the union rather than
+ * overriding; the browser picks per character based on `unicode-range`.
+ */
+export declare function fontAsset(options?: FontAssetOptions): z.core.$ZodBranded<z.ZodObject<{
+    _asset: z.ZodString;
+}, z.core.$strip>, "font", "out">;
+/**
+ * Map a MIME's top-level type to its picker `AcceptFilter` kind name.
+ * `image/jpeg` → `image`, `application/pdf` → `document`, etc.
+ *
+ * The asset-kind taxonomy (`image | video | audio | document | font |
+ * other`) is defined by design-media.md; this maps the IANA top-level
+ * type into that vocabulary. Anything not in the table maps to `'other'`
+ * — the picker can still accept these via MIME prefix or exact MIME.
+ *
+ * `kind` is the asset's manifest kind (`embedded | downloadable | font`),
+ * which discriminates rendering contract — separate axis from this
+ * MIME-derived category. Both inform `matchesAccept`.
+ */
+export declare function mimeToAcceptKind(mime: string): AcceptFilter;
+/**
+ * Does this asset satisfy any one of the picker's `accept` filters?
+ *
+ * Empty `accept` matches everything — that's "no filter configured."
+ * Otherwise the asset matches if at least one filter entry holds:
+ *   - kind name (`'image'`, `'video'`, ...) matches `mimeToAcceptKind`
+ *   - MIME prefix (ends with `/`) is a prefix of the asset's MIME
+ *   - exact MIME equals the asset's MIME
+ *
+ * Pure, side-effect-free — picker UIs use it to filter the grid; the
+ * resolver could use it to validate refs at render time.
+ */
+export declare function matchesAccept(asset: {
+    mime: string;
+}, accept: readonly AcceptFilter[]): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/schema/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/schema/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAEpB,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,MAAM,GACN,OAAO,GAEP,GAAG,MAAM,GAAG,GAEZ,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAIzB,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;;;;;;;sCAkB/D;AAID,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB;;;;0CAU7D;AAID,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,CAAA;IAC7C,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB;;kCAQvD;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAkB3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAY/F"}

package/dist/schema/helpers.js

@@ -0,0 +1,133 @@
+/**
+ * Zod schema helpers for asset references.
+ *
+ * Three helpers (`embeddedAsset`, `downloadable`, `fontAsset`), each emitting
+ * a Zod object schema branded with its asset kind via `.brand()`. The brand
+ * is phantom (type-level only) — runtime consumers see a plain Zod object.
+ *
+ * Shared grammar:
+ * - `AcceptFilter` — the filter used by picker UIs to narrow the set of
+ *   assets offered for a field. Kind names (`'image'`, `'video'`, `'audio'`,
+ *   `'document'`, `'font'`, `'other'`), MIME prefixes (`'image/'`), or exact
+ *   MIMEs (`'image/svg+xml'`). Shared because all three helpers accept it.
+ *
+ * Brand values — consumed by `Content<T>` in types.ts:
+ * - `embeddedAsset()` → `.brand<'embedded'>()`
+ * - `downloadable()` → `.brand<'downloadable'>()`
+ * - `fontAsset()` → `.brand<'font'>()`
+ */
+import { z } from 'zod';
+/**
+ * Zod helper for an embedded asset reference — rendered inline by templates
+ * (`<img>`, `<video>`, `<audio>`). Templates receive `ResolvedEmbeddedAsset`
+ * after the resolver merges the manifest with per-reference overrides.
+ */
+export function embeddedAsset(options = {}) {
+    // Store options as a sibling metadata object — the picker reads them to
+    // configure the UI. The Zod schema itself only validates the runtime shape.
+    const base = z
+        .object({
+        _asset: z.string(),
+        alt: z.string().optional(),
+        focalPoint: z
+            .object({
+            x: z.number().min(0).max(1),
+            y: z.number().min(0).max(1),
+        })
+            .optional(),
+    })
+        .brand();
+    // Attach options via .meta() so custom picker UIs can read them.
+    return base.meta({ assetOptions: options });
+}
+/**
+ * Zod helper for a downloadable asset reference — rendered as `<a href download>`
+ * by templates. Templates receive `ResolvedDownloadableAsset`.
+ */
+export function downloadable(options = {}) {
+    const base = z
+        .object({
+        _asset: z.string(),
+        title: z.string().optional(),
+        description: z.string().optional(),
+    })
+        .brand();
+    return base.meta({ assetOptions: options });
+}
+/**
+ * Zod helper for a font asset reference — templates emit `@font-face` declarations
+ * from the resolved variants. Locale manifests add variants to the union rather than
+ * overriding; the browser picks per character based on `unicode-range`.
+ */
+export function fontAsset(options = {}) {
+    const base = z
+        .object({
+        _asset: z.string(),
+    })
+        .brand();
+    return base.meta({ assetOptions: options });
+}
+// ---------- accept-filter matching ----------
+/**
+ * Map a MIME's top-level type to its picker `AcceptFilter` kind name.
+ * `image/jpeg` → `image`, `application/pdf` → `document`, etc.
+ *
+ * The asset-kind taxonomy (`image | video | audio | document | font |
+ * other`) is defined by design-media.md; this maps the IANA top-level
+ * type into that vocabulary. Anything not in the table maps to `'other'`
+ * — the picker can still accept these via MIME prefix or exact MIME.
+ *
+ * `kind` is the asset's manifest kind (`embedded | downloadable | font`),
+ * which discriminates rendering contract — separate axis from this
+ * MIME-derived category. Both inform `matchesAccept`.
+ */
+export function mimeToAcceptKind(mime) {
+    const slash = mime.indexOf('/');
+    const top = slash === -1 ? mime : mime.slice(0, slash);
+    switch (top) {
+        case 'image':
+            return 'image';
+        case 'video':
+            return 'video';
+        case 'audio':
+            return 'audio';
+        case 'application':
+        case 'text':
+            return 'document';
+        case 'font':
+            return 'font';
+        default:
+            return 'other';
+    }
+}
+/**
+ * Does this asset satisfy any one of the picker's `accept` filters?
+ *
+ * Empty `accept` matches everything — that's "no filter configured."
+ * Otherwise the asset matches if at least one filter entry holds:
+ *   - kind name (`'image'`, `'video'`, ...) matches `mimeToAcceptKind`
+ *   - MIME prefix (ends with `/`) is a prefix of the asset's MIME
+ *   - exact MIME equals the asset's MIME
+ *
+ * Pure, side-effect-free — picker UIs use it to filter the grid; the
+ * resolver could use it to validate refs at render time.
+ */
+export function matchesAccept(asset, accept) {
+    if (accept.length === 0)
+        return true;
+    const assetKind = mimeToAcceptKind(asset.mime);
+    for (const filter of accept) {
+        if (filter === assetKind)
+            return true;
+        if (filter.endsWith('/')) {
+            if (asset.mime.startsWith(filter))
+                return true;
+        }
+        else if (filter.includes('/')) {
+            if (asset.mime === filter)
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/schema/helpers.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Public schema API — Zod helpers for asset references, reference/resolved
+ * types, and the `Content<T>` type mapper templates use to convert their
+ * Zod-inferred content type into what the resolver delivers at render time.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import type { TemplateFunction } from 'gazetta'
+ * import { z } from 'zod'
+ * import { embeddedAsset, type Content } from 'gazetta/schema'
+ *
+ * export const schema = z.object({
+ *   hero: embeddedAsset({ accept: ['image'] }),
+ *   title: z.string(),
+ * })
+ *
+ * const render: TemplateFunction<Content<z.infer<typeof schema>>> = ({ content }) => ({
+ *   html: `<img src="${content.hero.url}" alt="${content.hero.alt}"><h1>${content.title}</h1>`,
+ *   css: '', js: '',
+ * })
+ * ```
+ */
+export { downloadable, embeddedAsset, fontAsset, matchesAccept, mimeToAcceptKind } from './helpers.js';
+export type { AcceptFilter, DownloadableOptions, EmbeddedAssetOptions, FontAssetOptions, } from './helpers.js';
+export type { AssetKind, AssetManifest, AssetSummary, AssetVariant, Content, DownloadableAssetManifest, DownloadableAssetRef, EmbeddedAssetManifest, EmbeddedAssetRef, FontAssetManifest, FontAssetRef, FontLocaleAdditiveManifest, LocaleBytesOverrideManifest, LocaleMetadataOverrideManifest, LocaleOverrideManifest, ResolvedDownloadableAsset, ResolvedEmbeddedAsset, ResolvedFontAsset, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtG,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}

package/dist/schema/index.js

@@ -0,0 +1,25 @@
+/**
+ * Public schema API — Zod helpers for asset references, reference/resolved
+ * types, and the `Content<T>` type mapper templates use to convert their
+ * Zod-inferred content type into what the resolver delivers at render time.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import type { TemplateFunction } from 'gazetta'
+ * import { z } from 'zod'
+ * import { embeddedAsset, type Content } from 'gazetta/schema'
+ *
+ * export const schema = z.object({
+ *   hero: embeddedAsset({ accept: ['image'] }),
+ *   title: z.string(),
+ * })
+ *
+ * const render: TemplateFunction<Content<z.infer<typeof schema>>> = ({ content }) => ({
+ *   html: `<img src="${content.hero.url}" alt="${content.hero.alt}"><h1>${content.title}</h1>`,
+ *   css: '', js: '',
+ * })
+ * ```
+ */
+export { downloadable, embeddedAsset, fontAsset, matchesAccept, mimeToAcceptKind } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}