@plumix/core 0.5.0 → 0.7.0

package/dist/plugin/fields/condition.d.ts

@@ -0,0 +1,40 @@
+/** Comparison applied between a driver field's value and the rule. */
+export type MetaFieldConditionOperator = "eq" | "neq" | "empty" | "not_empty" | "gt" | "lt" | "contains" | "not_contains" | "count_gt" | "count_lt";
+/**
+ * One comparison against a driver field, addressed by its meta key.
+ * `value` is the JSON-serializable comparand; operators that don't
+ * compare against a value omit it.
+ */
+export interface MetaFieldConditionRule {
+    readonly key: string;
+    readonly op: MetaFieldConditionOperator;
+    readonly value?: unknown;
+}
+/**
+ * OR-of-AND groups: the field is visible when any group passes, and a
+ * group passes when all of its rules do. `.visibleWhen(...rules)`
+ * authors the first group; each `.orVisibleWhen(...rules)` appends one.
+ */
+export type MetaFieldCondition = readonly (readonly MetaFieldConditionRule[])[];
+/**
+ * Evaluate a field's visibility against the sibling values of its box
+ * (form values in the admin, the incoming meta bag on the server). A
+ * field without a condition is always visible.
+ */
+export declare function isFieldVisible(field: {
+    readonly visibleWhen?: MetaFieldCondition;
+}, values: Readonly<Record<string, unknown>>): boolean;
+/**
+ * Write-side companion to `isFieldVisible`: whether a field's key
+ * should be dropped from an incoming write. Condition-hidden fields
+ * skip validation entirely, because an editor can never fix a value
+ * behind an input they cannot see. Visibility is judged from the
+ * incoming bag (the admin submits the full form state), and only when
+ * the bag carries every referenced driver: a partial patch that omits
+ * a driver is validated as if visible rather than silently dropped on
+ * unknown driver state.
+ */
+export declare function isConditionHidden(field: {
+    readonly visibleWhen?: MetaFieldCondition;
+}, input: Readonly<Record<string, unknown>>): boolean;
+//# sourceMappingURL=condition.d.ts.map

package/dist/plugin/fields/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/condition.ts"],"names":[],"mappings":"AAQA,sEAAsE;AACtE,MAAM,MAAM,0BAA0B,GAClC,IAAI,GACJ,KAAK,GACL,OAAO,GACP,WAAW,GACX,IAAI,GACJ,IAAI,GACJ,UAAU,GACV,cAAc,GACd,UAAU,GACV,UAAU,CAAC;AAEf;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,0BAA0B,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,SAAS,sBAAsB,EAAE,CAAC,EAAE,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;CAAE,EACpD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,OAAO,CAMT;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;CAAE,EACpD,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,OAAO,CAMT"}

package/dist/plugin/fields/condition.js

@@ -0,0 +1,115 @@
+// Conditional-visibility rule model for meta-box fields. Rules are
+// plain wire objects addressing driver fields by key — authored via
+// the typed condition factories on each fluent builder, serialized
+// into the manifest untouched, and evaluated by the same
+// `isFieldVisible` on both sides: the admin form (live show/hide as
+// driver values change) and the server write pipeline (hidden fields
+// skip validation).
+/**
+ * Evaluate a field's visibility against the sibling values of its box
+ * (form values in the admin, the incoming meta bag on the server). A
+ * field without a condition is always visible.
+ */
+export function isFieldVisible(field, values) {
+    const groups = field.visibleWhen;
+    if (groups === undefined || groups.length === 0)
+        return true;
+    return groups.some((group) => group.every((rule) => evaluateRule(rule, values[rule.key])));
+}
+/**
+ * Write-side companion to `isFieldVisible`: whether a field's key
+ * should be dropped from an incoming write. Condition-hidden fields
+ * skip validation entirely, because an editor can never fix a value
+ * behind an input they cannot see. Visibility is judged from the
+ * incoming bag (the admin submits the full form state), and only when
+ * the bag carries every referenced driver: a partial patch that omits
+ * a driver is validated as if visible rather than silently dropped on
+ * unknown driver state.
+ */
+export function isConditionHidden(field, input) {
+    const groups = field.visibleWhen ?? [];
+    const driversPresent = groups.every((group) => group.every((rule) => rule.key in input));
+    return driversPresent && !isFieldVisible(field, input);
+}
+function evaluateRule(rule, value) {
+    switch (rule.op) {
+        case "eq":
+            return structurallyEqual(value, rule.value);
+        case "neq":
+            return !structurallyEqual(value, rule.value);
+        case "empty":
+            return isEmptyValue(value);
+        case "not_empty":
+            return !isEmptyValue(value);
+        case "gt":
+            return compareNumeric(value, rule.value, (a, b) => a > b);
+        case "lt":
+            return compareNumeric(value, rule.value, (a, b) => a < b);
+        case "contains":
+            return containsItem(value, rule.value);
+        case "not_contains":
+            return !containsItem(value, rule.value);
+        case "count_gt":
+            return compareNumeric(countOf(value), rule.value, (a, b) => a > b);
+        case "count_lt":
+            return compareNumeric(countOf(value), rule.value, (a, b) => a < b);
+    }
+}
+function containsItem(value, comparand) {
+    return (Array.isArray(value) &&
+        value.some((item) => structurallyEqual(item, comparand)));
+}
+// Multi-value drivers count their selections; anything else (including
+// an absent value) counts as zero.
+function countOf(value) {
+    return Array.isArray(value) ? value.length : 0;
+}
+// JSON-structural equality — rule comparands are JSON-serializable by
+// construction (typed factories produce them from field value types),
+// so array order and own enumerable keys are the identity. Objects
+// compare key-order-insensitively.
+function structurallyEqual(a, b) {
+    if (a === b)
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return (a.length === b.length &&
+            a.every((item, i) => structurallyEqual(item, b[i])));
+    }
+    if (typeof a === "object" &&
+        typeof b === "object" &&
+        a !== null &&
+        b !== null &&
+        !Array.isArray(a) &&
+        !Array.isArray(b)) {
+        const aEntries = Object.entries(a);
+        if (aEntries.length !== Object.keys(b).length)
+            return false;
+        return aEntries.every(([key, item]) => key in b &&
+            structurallyEqual(item, b[key]));
+    }
+    return false;
+}
+// "No value yet" as an editor perceives it: unset, cleared input, or
+// an empty multi-value selection. `false` / `0` are values.
+function isEmptyValue(value) {
+    if (value === undefined || value === null || value === "")
+        return true;
+    return Array.isArray(value) && value.length === 0;
+}
+function compareNumeric(value, bound, cmp) {
+    const parsed = numericValueOf(value);
+    return (parsed !== undefined && typeof bound === "number" && cmp(parsed, bound));
+}
+// Numeric driver values may arrive as strings (an HTML number input's
+// raw form value) — accept them, but never coerce blank to 0.
+function numericValueOf(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.trim() !== "") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+//# sourceMappingURL=condition.js.map

package/dist/plugin/fields/condition.js.map

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

package/dist/plugin/fields/contributions.d.ts

@@ -0,0 +1,233 @@
+import type { EntryProjection, EntryTypeName, TermProjection, TermTaxonomyName } from "../../template-registry.js";
+import type { MetaBoxFieldInput } from "../manifest.js";
+/**
+ * The typed-meta contribution registries. A meta box (or settings
+ * group) registration is runtime-only — a `register*` call can't
+ * augment a global interface — so typed reads cost one derived
+ * declaration per box, merged from any package. The `EntryMeta` /
+ * `TermMeta` / `UserMeta` / `SettingsMeta` helpers author that
+ * declaration (see {@link EntryMeta} for the end-to-end walkthrough):
+ *
+ * ```ts
+ * const articleFields = [text("subtitle").maxLength(120)];
+ * declare module "plumix" {
+ *   interface EntryMetaContributions {
+ *     article: EntryMeta<"post", typeof articleFields>;
+ *   }
+ * }
+ * ```
+ *
+ * `MetaOf<K>` then folds every contribution whose target set includes
+ * `K` into one closed record — no open index fallback, so a mistyped
+ * field name is a compile error at the read site. A box registered
+ * without a declaration simply doesn't contribute (its fields read as
+ * absent); any downstream package can supply the missing declaration
+ * via interface merging. When a declaration exists, the matching
+ * `register*` call is typechecked against it, so declaration and
+ * runtime can't drift silently.
+ */
+/** Entry meta-box contributions, keyed by box id. `entryTypes` is a union of registered entry-type names. */
+export interface EntryMetaContributions {
+}
+/** Term meta-box contributions, keyed by box id. `termTaxonomies` is a union of registered taxonomy names. */
+export interface TermMetaContributions {
+}
+/** User meta-box contributions, keyed by box id. Users have a flat keyspace — every contribution applies. */
+export interface UserMetaContributions {
+}
+/** Settings-group contributions, keyed by group name. */
+export interface SettingsContributions {
+}
+/**
+ * The shape of one entry meta-box contribution: the target entry type(s)
+ * plus the fields array. A named alias so authors reach for a checked
+ * two-generic helper instead of hand-writing the `{ entryTypes; fields }`
+ * object — misspelling a property (`entryType`) would otherwise leave the
+ * contribution structurally valid but silently unmatched by the fold, so
+ * the fields read as *absent* with no error. `EntryTypes` is constrained
+ * to registered names, so an unknown entry type errors at the declaration
+ * itself rather than only at the `registerEntryMetaBox` call.
+ *
+ * The full path from declaring fields to typed template reads:
+ *
+ * ```ts
+ * import { text } from "plumix/fields";
+ * import type { EntryMeta } from "plumix";
+ *
+ * // 1. Author the fields as a named const so both the declaration and
+ * //    the registration reference one source of truth.
+ * const articleFields = [text("subtitle"), text("heroCredit").required()];
+ *
+ * // 2. Declare the contribution — this is what crosses package
+ * //    boundaries so a theme in another package sees the meta shape.
+ * declare module "plumix" {
+ *   interface EntryMetaContributions {
+ *     article: EntryMeta<"post", typeof articleFields>;
+ *   }
+ * }
+ *
+ * // 3. Register the box; the call is typechecked against the declaration
+ * //    above (anti-drift), so the two can't diverge silently.
+ * ctx.registerEntryMetaBox("article", {
+ *   label: "Article",
+ *   entryTypes: ["post"],
+ *   fields: articleFields,
+ * });
+ *
+ * // 4. In the theme, a targeted template reads typed meta:
+ * //    `forEntryType("post").template(({ entry }) => entry.meta.subtitle)`
+ * //    — `subtitle` is `string | undefined`, a typo is a compile error.
+ * ```
+ */
+export interface EntryMeta<EntryTypes extends EntryTypeName, Fields extends readonly MetaBoxFieldInput[]> {
+    entryTypes: EntryTypes;
+    fields: Fields;
+}
+/**
+ * The shape of one term meta-box contribution — target taxonomy(s) plus
+ * fields. The {@link EntryMeta} analogue over `termTaxonomies`; folds
+ * through {@link TermMetaOf} for `forTaxonomy(...).template(...)` reads.
+ */
+export interface TermMeta<Taxonomies extends TermTaxonomyName, Fields extends readonly MetaBoxFieldInput[]> {
+    termTaxonomies: Taxonomies;
+    fields: Fields;
+}
+/**
+ * The shape of one user meta-box contribution. Users share a flat
+ * keyspace, so there is no target set — every declared contribution folds
+ * into {@link UserMetaOf}.
+ */
+export interface UserMeta<Fields extends readonly MetaBoxFieldInput[]> {
+    fields: Fields;
+}
+/**
+ * The shape of one settings-group contribution, keyed by group name in
+ * {@link SettingsContributions}; folds through {@link SettingsOf}.
+ */
+export interface SettingsMeta<Fields extends readonly MetaBoxFieldInput[]> {
+    fields: Fields;
+}
+interface TypedField {
+    readonly _key: string;
+    readonly _value: unknown;
+    readonly _stored: unknown;
+}
+type InferShape<F extends readonly MetaBoxFieldInput[], Prop extends "_value" | "_stored"> = {
+    [P in Extract<F[number], TypedField> as P["_key"]]: P[Prop];
+};
+/**
+ * The read-shape record a fields array declares: one property per
+ * fluent field, keyed by the literal key, typed by the phantom read
+ * type (defaults applied, references hydrated).
+ */
+export type InferFields<F extends readonly MetaBoxFieldInput[]> = InferShape<F, "_value">;
+/**
+ * The stored-shape record a fields array declares — what actually sits
+ * in the meta JSON. Distinct from {@link InferFields}: `.default()`
+ * narrows only the read shape (decode-time), and reference/temporal
+ * fields store ids / ISO strings rather than hydrated values.
+ */
+export type InferStoredFields<F extends readonly MetaBoxFieldInput[]> = InferShape<F, "_stored">;
+type UnionToIntersection<U> = (U extends unknown ? (u: U) => void : never) extends (i: infer I extends Record<string, unknown>) => void ? I : never;
+type EmptyMeta = Record<never, never>;
+type FoldRecords<R> = [R] extends [never] ? EmptyMeta : UnionToIntersection<R>;
+type ScopedRecords<Contributions, K, P extends string, Prop extends "_value" | "_stored"> = {
+    [B in keyof Contributions]: Contributions[B] extends Record<P, infer T> & {
+        fields: infer F extends readonly MetaBoxFieldInput[];
+    } ? K extends T ? InferShape<F, Prop> : never : never;
+}[keyof Contributions];
+type AllRecords<Contributions, Prop extends "_value" | "_stored"> = {
+    [B in keyof Contributions]: Contributions[B] extends {
+        fields: infer F extends readonly MetaBoxFieldInput[];
+    } ? InferShape<F, Prop> : never;
+}[keyof Contributions];
+/** The folded read-shape meta record for an entry type. Types template `data.entry.meta` reads. */
+export type MetaOf<K extends EntryTypeName> = FoldRecords<ScopedRecords<EntryMetaContributions, K, "entryTypes", "_value">>;
+/** The folded stored-shape meta record for an entry type. Types `whereMeta` keys and values. */
+export type StoredMetaOf<K extends EntryTypeName> = FoldRecords<ScopedRecords<EntryMetaContributions, K, "entryTypes", "_stored">>;
+/** The folded read-shape meta record for a registered taxonomy. */
+export type TermMetaOf<K extends TermTaxonomyName> = FoldRecords<ScopedRecords<TermMetaContributions, K, "termTaxonomies", "_value">>;
+/** The folded stored-shape meta record for a taxonomy. Types term `whereMeta`. */
+export type StoredTermMetaOf<K extends TermTaxonomyName> = FoldRecords<ScopedRecords<TermMetaContributions, K, "termTaxonomies", "_stored">>;
+/** The folded read-shape user meta record — users have a flat keyspace, so every contribution applies. */
+export type UserMetaOf = FoldRecords<AllRecords<UserMetaContributions, "_value">>;
+/** The read-shape record of one settings group, by declared group name. */
+export type SettingsOf<Name extends keyof SettingsContributions> = FoldRecords<AllRecords<Pick<SettingsContributions, Name>, "_value">>;
+type FieldsMatch<A extends readonly MetaBoxFieldInput[], B extends readonly MetaBoxFieldInput[]> = [
+    InferFields<A>,
+    InferStoredFields<A>,
+    InferFields<B>,
+    InferStoredFields<B>
+] extends [
+    InferFields<B>,
+    InferStoredFields<B>,
+    InferFields<A>,
+    InferStoredFields<A>
+] ? true : false;
+type FieldsDrift<O extends {
+    fields: readonly MetaBoxFieldInput[];
+}, F extends readonly MetaBoxFieldInput[]> = FieldsMatch<O["fields"], F> extends true ? unknown : {
+    "drift — fields do not match the declared contribution": F;
+};
+/**
+ * The compile-time drift check `registerEntryMetaBox` intersects onto
+ * its options. With no declaration for `Id` it vanishes (`unknown`);
+ * with one, a mismatched target set or field set demands an impossible
+ * `"drift — …"` property, failing the call with a readable message.
+ * The comparison is over the inferred read + stored shapes, so the
+ * registration must pass literally-typed fields (the declared array
+ * itself, or an equivalent inline chain) — options widened to the base
+ * interface lose the phantoms and fail the check.
+ */
+export type EntryMetaBoxDrift<Id extends string, O extends {
+    entryTypes: readonly string[];
+    fields: readonly MetaBoxFieldInput[];
+}> = Id extends keyof EntryMetaContributions ? EntryMetaContributions[Id] extends {
+    entryTypes: infer T extends string;
+    fields: infer F extends readonly MetaBoxFieldInput[];
+} ? (O["entryTypes"][number] extends T ? unknown : {
+    "drift — entryTypes lists an undeclared entry type": Exclude<O["entryTypes"][number], T>;
+}) & ([Exclude<T, O["entryTypes"][number]>] extends [never] ? unknown : {
+    "drift — entryTypes is missing a declared entry type": Exclude<T, O["entryTypes"][number]>;
+}) & FieldsDrift<O, F> : unknown : unknown;
+/** The `registerTermMetaBox` analogue of {@link EntryMetaBoxDrift}, over `termTaxonomies`. */
+export type TermMetaBoxDrift<Id extends string, O extends {
+    termTaxonomies: readonly string[];
+    fields: readonly MetaBoxFieldInput[];
+}> = Id extends keyof TermMetaContributions ? TermMetaContributions[Id] extends {
+    termTaxonomies: infer T extends string;
+    fields: infer F extends readonly MetaBoxFieldInput[];
+} ? (O["termTaxonomies"][number] extends T ? unknown : {
+    "drift — termTaxonomies lists an undeclared taxonomy": Exclude<O["termTaxonomies"][number], T>;
+}) & ([Exclude<T, O["termTaxonomies"][number]>] extends [never] ? unknown : {
+    "drift — termTaxonomies is missing a declared taxonomy": Exclude<T, O["termTaxonomies"][number]>;
+}) & FieldsDrift<O, F> : unknown : unknown;
+type FieldsOnlyDrift<Contributions, Key, O extends {
+    fields: readonly MetaBoxFieldInput[];
+}> = Key extends keyof Contributions ? Contributions[Key] extends {
+    fields: infer F extends readonly MetaBoxFieldInput[];
+} ? FieldsDrift<O, F> : unknown : unknown;
+/** Fields-only drift for `registerUserMetaBox` — users have no target set. */
+export type UserMetaBoxDrift<Id extends string, O extends {
+    fields: readonly MetaBoxFieldInput[];
+}> = FieldsOnlyDrift<UserMetaContributions, Id, O>;
+/** Fields-only drift for `registerSettingsGroup`, keyed by group name. */
+export type SettingsGroupDrift<Name extends string, O extends {
+    fields: readonly MetaBoxFieldInput[];
+}> = FieldsOnlyDrift<SettingsContributions, Name, O>;
+/**
+ * The entry a targeted template receives: the registered projection
+ * with `meta` replaced by the folded typed record. Replacement (not
+ * intersection) is what makes a mistyped field name a compile error —
+ * intersecting would keep the base open `Record<string, unknown>`
+ * index and read typos as `unknown`.
+ */
+export type ResolvedEntryFor<K extends EntryTypeName> = Omit<EntryProjection<K>, "meta"> & {
+    readonly meta: MetaOf<K>;
+};
+/** The term a targeted template receives — projection with folded typed meta. */
+export type ResolvedTermFor<K extends TermTaxonomyName> = Omit<TermProjection<K>, "meta"> & {
+    readonly meta: TermMetaOf<K>;
+};
+export {};
+//# sourceMappingURL=contributions.d.ts.map

package/dist/plugin/fields/contributions.d.ts.map

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

package/dist/plugin/fields/contributions.js

@@ -0,0 +1 @@
+//# sourceMappingURL=contributions.js.map

package/dist/plugin/fields/contributions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.js","sourceRoot":"","sources":["../../../src/plugin/fields/contributions.ts"],"names":[],"mappings":""}

package/dist/plugin/fields/entry.d.ts

@@ -1,5 +1,5 @@
-import type { Label } from "../../i18n/label.js";
-import type { EntryReferenceMetaBoxField, MetaBoxFieldSpan } from "../manifest.js";
+import type { EntryStatus } from "../../db/schema/entries.js";
+import { ReferenceFieldBuilder } from "./reference.js";
 /**
  * Public scope shape for the `entry()` reference field. Carried on
  * the field's `referenceTarget.scope`; the entry `LookupAdapter`
@@ -10,31 +10,35 @@ export interface EntryFieldScope {
     /**
      * Restrict matches to these entry types. Required at the field
      * level — entry references without a type filter would surface
-     * the entire content table to pickers.
+     * the entire content table to pickers. Seeded from the `entry()`
+     * constructor argument.
      */
     readonly entryTypes: readonly string[];
     /**
      * Whether to surface trashed entries. Default `false` — trashed
-     * entries are usually invalid reference targets.
+     * entries are usually invalid reference targets. Set via
+     * `.includeTrashed()`.
      */
     readonly includeTrashed?: boolean;
-}
-export interface EntryFieldOptions {
-    readonly key: string;
-    readonly label: Label;
-    readonly required?: boolean;
-    readonly description?: Label;
-    readonly default?: string;
-    readonly span?: MetaBoxFieldSpan;
-    readonly capability?: string;
-    readonly entryTypes: readonly string[];
-    readonly includeTrashed?: boolean;
+    /**
+     * Restrict matches to exactly this lifecycle status; supersedes the
+     * `includeTrashed` default. Public-render consumers (e.g. menu nav)
+     * pass `"published"` via `.status()` so drafts never surface; the
+     * admin picker leaves it unset and keeps admitting drafts/scheduled.
+     */
+    readonly status?: EntryStatus;
 }
 /**
- * Build a typed `entry` reference field. Storage is the bare entry
- * id; reads return the resolved label/subtitle (or `null` for
- * orphans). The admin renders a picker that calls the lookup RPC
- * with `{ kind: "entry", scope: { entryTypes, includeTrashed } }`.
+ * Build a typed `entry` reference field —
+ * `entry("related", ["post"])`. The required entry-type scope is the
+ * constructor's second argument; `.includeTrashed()` / `.status()`
+ * refine it, `.multiple()` flips to an id array.
+ *
+ * Storage is the bare entry id (an id array under `.multiple()`).
+ * Reads hydrate to the entry summary by default (`.returns("id")`
+ * opts back to the bare id); single reads stay optional (a target can
+ * orphan). The admin renders a picker that calls the lookup RPC with
+ * `{ kind: "entry", scope }`.
  */
-export declare function entry(options: EntryFieldOptions): EntryReferenceMetaBoxField;
+export declare function entry<K extends string>(key: K, entryTypes: readonly string[]): ReferenceFieldBuilder<"entry", K>;
 //# sourceMappingURL=entry.d.ts.map

package/dist/plugin/fields/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,0BAA0B,CAiB5E"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,GAAG,EAAE,CAAC,EACN,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC,CAEnC"}

package/dist/plugin/fields/entry.js

@@ -1,25 +1,17 @@
+import { ReferenceFieldBuilder } from "./reference.js";
 /**
- * Build a typed `entry` reference field. Storage is the bare entry
- * id; reads return the resolved label/subtitle (or `null` for
- * orphans). The admin renders a picker that calls the lookup RPC
- * with `{ kind: "entry", scope: { entryTypes, includeTrashed } }`.
+ * Build a typed `entry` reference field —
+ * `entry("related", ["post"])`. The required entry-type scope is the
+ * constructor's second argument; `.includeTrashed()` / `.status()`
+ * refine it, `.multiple()` flips to an id array.
+ *
+ * Storage is the bare entry id (an id array under `.multiple()`).
+ * Reads hydrate to the entry summary by default (`.returns("id")`
+ * opts back to the bare id); single reads stay optional (a target can
+ * orphan). The admin renders a picker that calls the lookup RPC with
+ * `{ kind: "entry", scope }`.
  */
-export function entry(options) {
-    const scope = {
-        entryTypes: options.entryTypes,
-        includeTrashed: options.includeTrashed,
-    };
-    return {
-        key: options.key,
-        label: options.label,
-        type: "string",
-        inputType: "entry",
-        referenceTarget: { kind: "entry", scope },
-        required: options.required,
-        description: options.description,
-        default: options.default,
-        span: options.span,
-        capability: options.capability,
-    };
+export function entry(key, entryTypes) {
+    return new ReferenceFieldBuilder("entry", key, { entryTypes });
 }
 //# sourceMappingURL=entry.js.map

package/dist/plugin/fields/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/plugin/fields/entry.ts"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,OAA0B;IAC9C,MAAM,KAAK,GAAoB;QAC7B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,OAAO;QAClB,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;QACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/plugin/fields/entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AA+BvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CACnB,GAAM,EACN,UAA6B;IAE7B,OAAO,IAAI,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/plugin/fields/errors.d.ts

@@ -1,8 +1,11 @@
-type FieldConfigErrorCode = "range_min_greater_than_max" | "repeater_nested_not_supported" | "repeater_sub_field_key_forbidden" | "repeater_sub_field_key_invalid" | "repeater_sub_field_duplicate";
+type FieldConfigErrorCode = "range_min_greater_than_max" | "sub_field_key_forbidden" | "sub_field_key_invalid" | "sub_field_duplicate" | "sub_field_condition_not_supported" | "temporal_bound_invalid";
+/** The composite field types that own a list of sub-fields. */
+export type SubFieldContainer = "repeater" | "group";
 export declare class FieldConfigError extends Error {
     readonly code: FieldConfigErrorCode;
     readonly fieldKey: string | undefined;
-    readonly repeaterKey: string | undefined;
+    readonly container: SubFieldContainer | undefined;
+    readonly containerKey: string | undefined;
     readonly subFieldKey: string | undefined;
     readonly min: number | undefined;
     readonly max: number | undefined;
@@ -13,23 +16,32 @@ export declare class FieldConfigError extends Error {
         min: number;
         max: number;
     }): FieldConfigError;
-    static repeaterNestedNotSupported(ctx: {
-        repeaterKey: string;
+    static subFieldKeyForbidden(ctx: {
+        container: SubFieldContainer;
+        containerKey: string;
         subFieldKey: string;
     }): FieldConfigError;
-    static repeaterSubFieldKeyForbidden(ctx: {
-        repeaterKey: string;
+    static subFieldKeyInvalid(ctx: {
+        container: SubFieldContainer;
+        containerKey: string;
         subFieldKey: string;
+        pattern: string;
     }): FieldConfigError;
-    static repeaterSubFieldKeyInvalid(ctx: {
-        repeaterKey: string;
+    static subFieldDuplicate(ctx: {
+        container: SubFieldContainer;
+        containerKey: string;
         subFieldKey: string;
-        pattern: string;
     }): FieldConfigError;
-    static repeaterSubFieldDuplicate(ctx: {
-        repeaterKey: string;
+    static subFieldCondition(ctx: {
+        container: SubFieldContainer;
+        containerKey: string;
         subFieldKey: string;
     }): FieldConfigError;
+    static temporalBoundInvalid(ctx: {
+        fieldKey: string;
+        bound: "min" | "max";
+        value: string;
+    }): FieldConfigError;
 }
 export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/plugin/fields/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/errors.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GACrB,4BAA4B,GAC5B,+BAA+B,GAC/B,kCAAkC,GAClC,gCAAgC,GAChC,8BAA8B,CAAC;AAWnC,qBAAa,gBAAiB,SAAQ,KAAK;IAKzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,OAAO;IAeP,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,gBAAgB;IAQpB,MAAM,CAAC,0BAA0B,CAAC,GAAG,EAAE;QACrC,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IASpB,MAAM,CAAC,4BAA4B,CAAC,GAAG,EAAE;QACvC,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IASpB,MAAM,CAAC,0BAA0B,CAAC,GAAG,EAAE;QACrC,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,gBAAgB;IASpB,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;CAOrB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/errors.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GACrB,4BAA4B,GAC5B,yBAAyB,GACzB,uBAAuB,GACvB,qBAAqB,GACrB,mCAAmC,GACnC,wBAAwB,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,CAAC;AAYrD,qBAAa,gBAAiB,SAAQ,KAAK;IAKzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,OAAO;IAgBP,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,gBAAgB;IAQpB,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE;QAC/B,SAAS,EAAE,iBAAiB,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IASpB,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE;QAC7B,SAAS,EAAE,iBAAiB,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,gBAAgB;IASpB,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE;QAC5B,SAAS,EAAE,iBAAiB,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IASpB,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE;QAC5B,SAAS,EAAE,iBAAiB,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IASpB,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,gBAAgB;CAQrB"}