@plumix/core 0.6.0 → 0.7.0

package/dist/plugin/fields/range.js

@@ -1,46 +1,161 @@
+var _a;
+import { humanizeFieldKey } from "./builder.js";
 import { FieldConfigError } from "./errors.js";
 /**
- * Build a typed `range` meta-box field. Renders as a slider in the
- * admin. Both `min` and `max` are required; `min <= max` is enforced
- * at registration time. The builder injects a default sanitizer that
- * rejects values outside `[min, max]` on write.
+ * Entry point of the `range()` chain — only `.bounds()` is available
+ * until the slider's `[min, max]` track is declared, so a range without
+ * bounds can't reach `build()` (registration surfaces require a `build`
+ * method). Forgetting the bounds is a compile error, not a runtime throw.
  */
-export function range(options) {
-    if (options.min > options.max) {
-        throw FieldConfigError.rangeMinGreaterThanMax({
-            fieldKey: options.key,
-            min: options.min,
-            max: options.max,
-        });
+export class RangeFieldSeed {
+    #key;
+    constructor(key) {
+        this.#key = key;
+    }
+    /**
+     * Declare the slider's inclusive `[min, max]` track — both required.
+     * `min <= max` is enforced when the chain compiles at registration.
+     */
+    bounds(min, max) {
+        return new RangeFieldBuilder(this.#key, { min, max });
     }
-    const { min, max } = options;
-    return {
-        key: options.key,
-        label: options.label,
-        type: "number",
-        inputType: "range",
-        min,
-        max,
-        step: options.step,
-        required: options.required,
-        description: options.description,
-        default: options.default,
-        span: options.span,
-        capability: options.capability,
-        sanitize: options.sanitize ?? buildBoundsSanitizer(min, max),
-    };
 }
-function buildBoundsSanitizer(min, max) {
-    return (value) => {
-        if (typeof value !== "number" || !Number.isFinite(value)) {
-            // eslint-disable-next-line no-restricted-syntax -- sanitizer flow-control sentinel; migrated in the field-sanitizer-error slice
-            throw new Error("invalid_value");
-        }
-        if (value < min || value > max) {
-            // eslint-disable-next-line no-restricted-syntax -- sanitizer flow-control sentinel; migrated in the field-sanitizer-error slice
-            throw new Error("invalid_value");
+/**
+ * Fluent chain for the `range` slider field. Its `[min, max]` track is
+ * fixed by `.bounds()` on the seed (so the bounds are always present here);
+ * `min <= max` is enforced when the chain compiles at registration.
+ * `build()` injects a default sanitizer that rejects values outside
+ * `[min, max]` on write; a custom `.sanitize()` replaces it entirely.
+ */
+export class RangeFieldBuilder {
+    #key;
+    #state;
+    constructor(key, state) {
+        this.#key = key;
+        this.#state = state;
+    }
+    #fork(patch) {
+        return new _a(this.#key, {
+            ...this.#state,
+            ...patch,
+        });
+    }
+    /** Override the derived (humanized-key) label. */
+    label(label) {
+        return this.#fork({ label });
+    }
+    /** Help text rendered under the label. */
+    description(description) {
+        return this.#fork({ description });
+    }
+    /** Default for absent keys, applied at read decode (and seeded into
+     * the admin form) — narrows the read type to `number`; the stored
+     * shape stays optional. */
+    default(value) {
+        return this.#fork({ default: value });
+    }
+    /** Mark the field required — narrows the read and stored types to `number`. */
+    required() {
+        return this.#fork({ required: true });
+    }
+    /**
+     * Column span within the box's 12-column grid — a universal layout
+     * hint; surfaces that can't honor it (the entry editor rail) ignore it.
+     */
+    span(span) {
+        return this.#fork({ span });
+    }
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability) {
+        return this.#fork({ capability });
+    }
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi() {
+        return this.#fork({ showInApi: true });
+    }
+    /** Rule factory: this field's value equals `value` — pass the rule
+     *  to a dependent field's `.visibleWhen()`. */
+    is(value) {
+        return { key: this.#key, op: "eq", value };
+    }
+    /** Rule factory: this field's value differs from `value`. */
+    isNot(value) {
+        return { key: this.#key, op: "neq", value };
+    }
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty() {
+        return { key: this.#key, op: "empty" };
+    }
+    /** Rule factory: this field has a value. */
+    isNotEmpty() {
+        return { key: this.#key, op: "not_empty" };
+    }
+    /** Rule factory: this field's value is greater than `value`. */
+    gt(value) {
+        return { key: this.#key, op: "gt", value };
+    }
+    /** Rule factory: this field's value is less than `value`. */
+    lt(value) {
+        return { key: this.#key, op: "lt", value };
+    }
+    /**
+     * Show this field only when every rule passes (one AND group) —
+     * rules come from sibling fields' condition factories. Replaces any
+     * previously declared condition; `.orVisibleWhen()` adds
+     * alternatives.
+     */
+    visibleWhen(...rules) {
+        return this.#fork({ visibleWhen: [rules] });
+    }
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules) {
+        return this.#fork({
+            visibleWhen: [...(this.#state.visibleWhen ?? []), rules],
+        });
+    }
+    step(step) {
+        return this.#fork({ step });
+    }
+    /** Normalising transform, applied after coercion and before persistence. */
+    sanitize(sanitize) {
+        return this.#fork({ sanitize: sanitize });
+    }
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate) {
+        return this.#fork({ validate: validate });
+    }
+    /** Compile the chain into the wire/manifest field definition. */
+    build() {
+        const { min, max } = this.#state;
+        if (min > max) {
+            throw FieldConfigError.rangeMinGreaterThanMax({
+                fieldKey: this.#key,
+                min,
+                max,
+            });
         }
-        return value;
-    };
+        return {
+            ...this.#state,
+            key: this.#key,
+            label: this.#state.label ?? humanizeFieldKey(this.#key),
+            type: "number",
+            inputType: "range",
+        };
+    }
+}
+_a = RangeFieldBuilder;
+/**
+ * Bounded numeric slider — `range("opacity").bounds(0, 100)`. The
+ * `[min, max]` track is required: only `.bounds()` is available on the
+ * bare constructor, so omitting it is a compile error. `min <= max` is
+ * enforced at registration; bounds are enforced server-side by the
+ * constraint walker.
+ */
+export function range(key) {
+    return new RangeFieldSeed(key);
 }
 //# sourceMappingURL=range.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"range.js","sourceRoot":"","sources":["../../../src/plugin/fields/range.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqB/C;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,OAA0B;IAC9C,IAAI,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,gBAAgB,CAAC,sBAAsB,CAAC;YAC5C,QAAQ,EAAE,OAAO,CAAC,GAAG;YACrB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAC7B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,OAAO;QAClB,GAAG;QACH,GAAG;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,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;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAAW,EACX,GAAW;IAEX,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,gIAAgI;YAChI,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAC/B,gIAAgI;YAChI,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../../src/plugin/fields/range.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,171 @@
+import type { EntryStatus } from "../../db/schema/entries.js";
+import type { UserRole } from "../../db/schema/users.js";
+import type { Label } from "../../i18n/label.js";
+import type { ReferenceHydrationShapes } from "../lookup.js";
+import type { EntryListMetaBoxField, EntryReferenceMetaBoxField, FieldBuilder, MetaBoxFieldSpan, MetaBoxFieldValidate, ReferenceReadProjection, TermListMetaBoxField, TermReferenceMetaBoxField, UserListMetaBoxField, UserMetaBoxField } from "../manifest.js";
+import type { MetaFieldCondition, MetaFieldConditionRule } from "./condition.js";
+/**
+ * The hydrated read shape for a reference `kind`, sourced from the
+ * shared {@link ReferenceHydrationShapes} registry so the builder's
+ * default read type tracks whatever the adapter actually resolves.
+ * Plugin-registered kinds augment that registry; an unregistered kind
+ * folds to `never`.
+ */
+type ReferenceSummaryOf<Kind extends string> = Kind extends keyof ReferenceHydrationShapes ? ReferenceHydrationShapes[Kind] : never;
+/** One read element: the hydrated summary by default, the bare id after `.returns("id")`. */
+type ReferenceReadItem<Summary, Returns extends "id" | "hydrated"> = Returns extends "id" ? string : Summary;
+/**
+ * The phantom read type. Single references are *always* optional — a
+ * live target can be deleted after the id is written, so even a
+ * `.required()` field reads `undefined` for an orphan. Multi references
+ * read a dense array (orphans drop out); the array itself is present
+ * once `.required()` guarantees a write, optional otherwise.
+ */
+type ReferenceReadValue<Summary, Multiple extends boolean, Required extends boolean, Returns extends "id" | "hydrated"> = Multiple extends true ? Required extends true ? readonly ReferenceReadItem<Summary, Returns>[] : readonly ReferenceReadItem<Summary, Returns>[] | undefined : ReferenceReadItem<Summary, Returns> | undefined;
+/**
+ * The phantom stored shape — bare ids, what `whereMeta` addresses.
+ * `.required()` narrows away `undefined` (write-enforced); the read
+ * projection (`.returns()`) never touches it.
+ */
+type ReferenceStoredValue<Multiple extends boolean, Required extends boolean> = Multiple extends true ? Required extends true ? readonly string[] : readonly string[] | undefined : Required extends true ? string : string | undefined;
+/** The compiled field variant a `(kind, cardinality)` pair builds to. */
+type ReferenceFieldOf<Kind extends string, Multiple extends boolean> = Kind extends "entry" ? Multiple extends true ? EntryListMetaBoxField : EntryReferenceMetaBoxField : Kind extends "term" ? Multiple extends true ? TermListMetaBoxField : TermReferenceMetaBoxField : Kind extends "user" ? Multiple extends true ? UserListMetaBoxField : UserMetaBoxField : never;
+interface ReferenceFieldState {
+    readonly visibleWhen?: MetaFieldCondition;
+    readonly label?: Label;
+    readonly description?: Label;
+    readonly default?: string | readonly string[];
+    readonly required?: true;
+    readonly multiple?: true;
+    readonly returns?: ReferenceReadProjection;
+    readonly max?: number;
+    readonly span?: MetaBoxFieldSpan;
+    readonly capability?: string;
+    readonly showInApi?: true;
+    readonly sanitize?: (value: unknown) => unknown;
+    readonly validate?: MetaBoxFieldValidate;
+}
+/**
+ * Fluent chain shared by the core reference fields (`entry`, `term`,
+ * `user`). Immutable — every call returns a fresh instance. The type
+ * parameters are the declaration's compile-time state:
+ *
+ * - `Kind` selects the adapter and, through {@link ReferenceSummaryOf},
+ *   the hydrated read shape; it also gates the kind-specific scope
+ *   chains (`.roles()` on `user`, `.status()` / `.includeTrashed()` on
+ *   `entry`);
+ * - `K` is the literal field key;
+ * - `Multiple` flips storage + read type to arrays (`.multiple()`);
+ * - `Required` narrows the stored shape and, for multi fields, the read
+ *   type (`.required()`);
+ * - `Returns` swaps the hydrated read for the bare id (`.returns("id")`).
+ *
+ * All phantom — nothing at runtime carries them. Reads default to the
+ * hydrated summary so the typed value never lies about what the read
+ * pipeline resolves. The scope object lives on the runtime instance,
+ * seeded by the factory and refined by the scope chains.
+ */
+export declare class ReferenceFieldBuilder<Kind extends string, K extends string = string, Multiple extends boolean = false, Required extends boolean = false, Returns extends "id" | "hydrated" = "hydrated"> implements FieldBuilder {
+    #private;
+    /** Phantom literal key of the field — type-level only, never assigned. */
+    readonly _key: K;
+    /** Phantom read type — hydrated summary by default, id after `.returns("id")`. */
+    readonly _value: ReferenceReadValue<ReferenceSummaryOf<Kind>, Multiple, Required, Returns>;
+    /** Phantom stored shape — bare ids; `.required()` narrows optionality. */
+    readonly _stored: ReferenceStoredValue<Multiple, Required>;
+    /** Phantom cardinality marker backing the compile-time gate on `.multiple()` / `.max()`. */
+    readonly _multiple: Multiple;
+    constructor(kind: Kind, key: string, scope: Record<string, unknown>, state?: ReferenceFieldState);
+    /**
+     * Store an array of ids instead of a single one (`type` flips to
+     * `json`, reads become a dense array). Declare cardinality before
+     * `.required()` narrows the shapes — the `this`-type gate keeps a
+     * post-narrowing `.multiple()` from compiling.
+     */
+    multiple(this: ReferenceFieldBuilder<Kind, K, false, false, Returns>): ReferenceFieldBuilder<Kind, K, true, false, Returns>;
+    /**
+     * Cap the array length — multi-value fields only. Carried on the
+     * definition and the wire; the constraint walker enforces it server-side.
+     */
+    max(this: ReferenceFieldBuilder<Kind, K, true, Required, Returns>, max: number): ReferenceFieldBuilder<Kind, K, true, Required, Returns>;
+    /**
+     * Read the bare stored id(s) instead of the hydrated summary — opts
+     * this field out of the read-time hydration join. Storage and the
+     * write contract are unaffected.
+     */
+    returns(shape: "id"): ReferenceFieldBuilder<Kind, K, Multiple, Required, "id">;
+    /**
+     * Mark the field required — enforced at write time by the constraint
+     * walker. Narrows the stored shape; a single reference's read stays
+     * optional (targets can orphan after the write).
+     */
+    required(): ReferenceFieldBuilder<Kind, K, Multiple, true, Returns>;
+    /**
+     * Restrict an `entry` reference to a lifecycle status (supersedes the
+     * `includeTrashed` default). Public-render consumers pass `"published"`
+     * so drafts never surface.
+     */
+    status(this: ReferenceFieldBuilder<"entry", K, Multiple, Required, Returns>, status: EntryStatus): ReferenceFieldBuilder<"entry", K, Multiple, Required, Returns>;
+    /** Surface trashed entries in an `entry` reference (default: hidden). */
+    includeTrashed(this: ReferenceFieldBuilder<"entry", K, Multiple, Required, Returns>): ReferenceFieldBuilder<"entry", K, Multiple, Required, Returns>;
+    /** Restrict a `user` reference to these roles (absent → any role). */
+    roles(this: ReferenceFieldBuilder<"user", K, Multiple, Required, Returns>, roles: readonly UserRole[]): ReferenceFieldBuilder<"user", K, Multiple, Required, Returns>;
+    /** Surface disabled accounts in a `user` reference (default: hidden). */
+    includeDisabled(this: ReferenceFieldBuilder<"user", K, Multiple, Required, Returns>): ReferenceFieldBuilder<"user", K, Multiple, Required, Returns>;
+    /** Override the derived (humanized-key) label. */
+    label(label: Label): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Help text rendered under the label. */
+    description(description: Label): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /**
+     * Prefill for absent keys — a stored id (or id array for multi
+     * fields), seeded into the admin form. Purely a form/decode seed:
+     * a reference read stays optional regardless (the default id can
+     * itself orphan).
+     */
+    default(value: Multiple extends true ? readonly string[] : string): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /**
+     * Column span within the box's 12-column grid — a universal layout
+     * hint; surfaces that can't honor it (the entry editor rail) ignore it.
+     */
+    span(span: MetaBoxFieldSpan): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability: string): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi(): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Rule factory: this field's stored id equals `value`. */
+    is(value: string): MetaFieldConditionRule;
+    /** Rule factory: this field's stored id differs from `value`. */
+    isNot(value: string): MetaFieldConditionRule;
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field has a value. */
+    isNotEmpty(): MetaFieldConditionRule;
+    /** Rule factory: the selection includes `id` — multi-value only. */
+    contains(this: ReferenceFieldBuilder<Kind, K, true, Required, Returns>, id: string): MetaFieldConditionRule;
+    /** Rule factory: the selection does not include `id` — multi-value only. */
+    notContains(this: ReferenceFieldBuilder<Kind, K, true, Required, Returns>, id: string): MetaFieldConditionRule;
+    /**
+     * Show this field only when every rule passes (one AND group) — rules
+     * come from sibling fields' condition factories. Replaces any
+     * previously declared condition; `.orVisibleWhen()` adds alternatives.
+     */
+    visibleWhen(...rules: MetaFieldConditionRule[]): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules: MetaFieldConditionRule[]): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /**
+     * Normalising transform, applied after coercion and before
+     * persistence. Receives the stored id(s) — the read-time hydration is
+     * a separate, later step.
+     */
+    sanitize(sanitize: (value: unknown) => unknown): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate: MetaBoxFieldValidate): ReferenceFieldBuilder<Kind, K, Multiple, Required, Returns>;
+    /** Compile the chain into the wire/manifest field definition. */
+    build(): ReferenceFieldOf<Kind, Multiple>;
+}
+export {};
+//# sourceMappingURL=reference.d.ts.map

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

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

package/dist/plugin/fields/reference.js

@@ -0,0 +1,193 @@
+var _a;
+import { humanizeFieldKey } from "./builder.js";
+/**
+ * Fluent chain shared by the core reference fields (`entry`, `term`,
+ * `user`). Immutable — every call returns a fresh instance. The type
+ * parameters are the declaration's compile-time state:
+ *
+ * - `Kind` selects the adapter and, through {@link ReferenceSummaryOf},
+ *   the hydrated read shape; it also gates the kind-specific scope
+ *   chains (`.roles()` on `user`, `.status()` / `.includeTrashed()` on
+ *   `entry`);
+ * - `K` is the literal field key;
+ * - `Multiple` flips storage + read type to arrays (`.multiple()`);
+ * - `Required` narrows the stored shape and, for multi fields, the read
+ *   type (`.required()`);
+ * - `Returns` swaps the hydrated read for the bare id (`.returns("id")`).
+ *
+ * All phantom — nothing at runtime carries them. Reads default to the
+ * hydrated summary so the typed value never lies about what the read
+ * pipeline resolves. The scope object lives on the runtime instance,
+ * seeded by the factory and refined by the scope chains.
+ */
+export class ReferenceFieldBuilder {
+    #kind;
+    #key;
+    #scope;
+    #state;
+    constructor(kind, key, scope, state = {}) {
+        this.#kind = kind;
+        this.#key = key;
+        this.#scope = scope;
+        this.#state = state;
+    }
+    #fork(patch, scopePatch) {
+        return new _a(this.#kind, this.#key, scopePatch ? { ...this.#scope, ...scopePatch } : this.#scope, { ...this.#state, ...patch });
+    }
+    /**
+     * Store an array of ids instead of a single one (`type` flips to
+     * `json`, reads become a dense array). Declare cardinality before
+     * `.required()` narrows the shapes — the `this`-type gate keeps a
+     * post-narrowing `.multiple()` from compiling.
+     */
+    multiple() {
+        return this.#fork({ multiple: true });
+    }
+    /**
+     * Cap the array length — multi-value fields only. Carried on the
+     * definition and the wire; the constraint walker enforces it server-side.
+     */
+    max(max) {
+        return this.#fork({ max });
+    }
+    /**
+     * Read the bare stored id(s) instead of the hydrated summary — opts
+     * this field out of the read-time hydration join. Storage and the
+     * write contract are unaffected.
+     */
+    returns(shape) {
+        return this.#fork({ returns: shape });
+    }
+    /**
+     * Mark the field required — enforced at write time by the constraint
+     * walker. Narrows the stored shape; a single reference's read stays
+     * optional (targets can orphan after the write).
+     */
+    required() {
+        return this.#fork({ required: true });
+    }
+    /**
+     * Restrict an `entry` reference to a lifecycle status (supersedes the
+     * `includeTrashed` default). Public-render consumers pass `"published"`
+     * so drafts never surface.
+     */
+    status(status) {
+        return this.#fork({}, { status });
+    }
+    /** Surface trashed entries in an `entry` reference (default: hidden). */
+    includeTrashed() {
+        return this.#fork({}, { includeTrashed: true });
+    }
+    /** Restrict a `user` reference to these roles (absent → any role). */
+    roles(roles) {
+        return this.#fork({}, { roles });
+    }
+    /** Surface disabled accounts in a `user` reference (default: hidden). */
+    includeDisabled() {
+        return this.#fork({}, { includeDisabled: true });
+    }
+    /** Override the derived (humanized-key) label. */
+    label(label) {
+        return this.#fork({ label });
+    }
+    /** Help text rendered under the label. */
+    description(description) {
+        return this.#fork({ description });
+    }
+    /**
+     * Prefill for absent keys — a stored id (or id array for multi
+     * fields), seeded into the admin form. Purely a form/decode seed:
+     * a reference read stays optional regardless (the default id can
+     * itself orphan).
+     */
+    default(value) {
+        return this.#fork({ default: value });
+    }
+    /**
+     * Column span within the box's 12-column grid — a universal layout
+     * hint; surfaces that can't honor it (the entry editor rail) ignore it.
+     */
+    span(span) {
+        return this.#fork({ span });
+    }
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability) {
+        return this.#fork({ capability });
+    }
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi() {
+        return this.#fork({ showInApi: true });
+    }
+    /** Rule factory: this field's stored id equals `value`. */
+    is(value) {
+        return { key: this.#key, op: "eq", value };
+    }
+    /** Rule factory: this field's stored id differs from `value`. */
+    isNot(value) {
+        return { key: this.#key, op: "neq", value };
+    }
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty() {
+        return { key: this.#key, op: "empty" };
+    }
+    /** Rule factory: this field has a value. */
+    isNotEmpty() {
+        return { key: this.#key, op: "not_empty" };
+    }
+    /** Rule factory: the selection includes `id` — multi-value only. */
+    contains(id) {
+        return { key: this.#key, op: "contains", value: id };
+    }
+    /** Rule factory: the selection does not include `id` — multi-value only. */
+    notContains(id) {
+        return { key: this.#key, op: "not_contains", value: id };
+    }
+    /**
+     * Show this field only when every rule passes (one AND group) — rules
+     * come from sibling fields' condition factories. Replaces any
+     * previously declared condition; `.orVisibleWhen()` adds alternatives.
+     */
+    visibleWhen(...rules) {
+        return this.#fork({ visibleWhen: [rules] });
+    }
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules) {
+        return this.#fork({
+            visibleWhen: [...(this.#state.visibleWhen ?? []), rules],
+        });
+    }
+    /**
+     * Normalising transform, applied after coercion and before
+     * persistence. Receives the stored id(s) — the read-time hydration is
+     * a separate, later step.
+     */
+    sanitize(sanitize) {
+        return this.#fork({ sanitize });
+    }
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate) {
+        return this.#fork({ validate });
+    }
+    /** Compile the chain into the wire/manifest field definition. */
+    build() {
+        const { multiple, ...state } = this.#state;
+        const target = multiple
+            ? { kind: this.#kind, scope: this.#scope, multiple: true }
+            : { kind: this.#kind, scope: this.#scope };
+        const field = {
+            ...state,
+            key: this.#key,
+            label: state.label ?? humanizeFieldKey(this.#key),
+            type: multiple ? "json" : "string",
+            inputType: multiple ? `${this.#kind}List` : this.#kind,
+            referenceTarget: target,
+        };
+        return field;
+    }
+}
+_a = ReferenceFieldBuilder;
+//# sourceMappingURL=reference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../../src/plugin/fields/reference.ts"],"names":[],"mappings":";AAqBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAwFhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,qBAAqB;IAqBvB,KAAK,CAAO;IACZ,IAAI,CAAS;IACb,MAAM,CAA0B;IAChC,MAAM,CAAsB;IAErC,YACE,IAAU,EACV,GAAW,EACX,KAA8B,EAC9B,QAA6B,EAAE;QAE/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAKH,KAAmC,EACnC,UAAoC;QAEpC,OAAO,IAAI,EAAqB,CAC9B,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAC5D,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,CAC7B,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QAGN,OAAO,IAAI,CAAC,KAAK,CAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,GAAG,CAED,GAAW;QAEX,OAAO,IAAI,CAAC,KAAK,CAA0B,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,OAAO,CACL,KAAW;QAEX,OAAO,IAAI,CAAC,KAAK,CAA2B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAEJ,MAAmB;QAEnB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,yEAAyE;IACzE,cAAc;QAGZ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,sEAAsE;IACtE,KAAK,CAEH,KAA0B;QAE1B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,yEAAyE;IACzE,eAAe;QAGb,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,kDAAkD;IAClD,KAAK,CACH,KAAY;QAEZ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,0CAA0C;IAC1C,WAAW,CACT,WAAkB;QAElB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,KAAyD;QAEzD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,IAAsB;QAEtB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,UAAU,CACR,UAAkB;QAElB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,wEAAwE;IACxE,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,2DAA2D;IAC3D,EAAE,CAAC,KAAa;QACd,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,KAAa;QACjB,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,gEAAgE;IAChE,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,UAAU;QACR,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAEN,EAAU;QAEV,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,4EAA4E;IAC5E,WAAW,CAET,EAAU;QAEV,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,WAAW,CACT,GAAG,KAA+B;QAElC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,2DAA2D;IAC3D,aAAa,CACX,GAAG,KAA+B;QAElC,OAAO,IAAI,CAAC,KAAK,CAAC;YAChB,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,QAAqC;QAErC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,QAA8B;QAE9B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,iEAAiE;IACjE,KAAK;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,MAAM,MAAM,GAAoB,QAAQ;YACtC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1D,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG;YACZ,GAAG,KAAK;YACR,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YACjD,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAClC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACtD,eAAe,EAAE,MAAM;SACxB,CAAC;QACF,OAAO,KAAyC,CAAC;IACnD,CAAC;CACF"}