@plumix/core 0.5.0 → 0.7.0

package/dist/plugin/fields/errors.js

@@ -4,7 +4,8 @@ export class FieldConfigError extends Error {
     }
     code;
     fieldKey;
-    repeaterKey;
+    container;
+    containerKey;
     subFieldKey;
     min;
     max;
@@ -13,7 +14,8 @@ export class FieldConfigError extends Error {
         super(message);
         this.code = code;
         this.fieldKey = fields.fieldKey;
-        this.repeaterKey = fields.repeaterKey;
+        this.container = fields.container;
+        this.containerKey = fields.containerKey;
         this.subFieldKey = fields.subFieldKey;
         this.min = fields.min;
         this.max = fields.max;
@@ -22,20 +24,25 @@ export class FieldConfigError extends Error {
     static rangeMinGreaterThanMax(ctx) {
         return new FieldConfigError("range_min_greater_than_max", `range field "${ctx.fieldKey}": min (${String(ctx.min)}) must be <= max (${String(ctx.max)})`, ctx);
     }
-    static repeaterNestedNotSupported(ctx) {
-        return new FieldConfigError("repeater_nested_not_supported", `repeater("${ctx.repeaterKey}") subFields contains a nested repeater ` +
-            `("${ctx.subFieldKey}"); nested repeaters are not supported in v0.1.`, ctx);
+    static subFieldKeyForbidden(ctx) {
+        return new FieldConfigError("sub_field_key_forbidden", `${ctx.container}("${ctx.containerKey}") field key "${ctx.subFieldKey}" is ` +
+            `forbidden (prototype-pollution risk).`, ctx);
     }
-    static repeaterSubFieldKeyForbidden(ctx) {
-        return new FieldConfigError("repeater_sub_field_key_forbidden", `repeater("${ctx.repeaterKey}") subField key "${ctx.subFieldKey}" is forbidden ` +
-            `(prototype-pollution risk).`, ctx);
+    static subFieldKeyInvalid(ctx) {
+        return new FieldConfigError("sub_field_key_invalid", `${ctx.container}("${ctx.containerKey}") field key "${ctx.subFieldKey}" ` +
+            `must match /${ctx.pattern}/.`, ctx);
     }
-    static repeaterSubFieldKeyInvalid(ctx) {
-        return new FieldConfigError("repeater_sub_field_key_invalid", `repeater("${ctx.repeaterKey}") subField key "${ctx.subFieldKey}" must match ` +
-            `/${ctx.pattern}/.`, ctx);
+    static subFieldDuplicate(ctx) {
+        return new FieldConfigError("sub_field_duplicate", `${ctx.container}("${ctx.containerKey}") declares field "${ctx.subFieldKey}" ` +
+            `more than once.`, ctx);
     }
-    static repeaterSubFieldDuplicate(ctx) {
-        return new FieldConfigError("repeater_sub_field_duplicate", `repeater("${ctx.repeaterKey}") declares subField "${ctx.subFieldKey}" more than once.`, ctx);
+    static subFieldCondition(ctx) {
+        return new FieldConfigError("sub_field_condition_not_supported", `${ctx.container}("${ctx.containerKey}") field "${ctx.subFieldKey}" does not ` +
+            `support visibleWhen — nested conditions are not implemented.`, ctx);
+    }
+    static temporalBoundInvalid(ctx) {
+        return new FieldConfigError("temporal_bound_invalid", `field "${ctx.fieldKey}": .${ctx.bound}("${ctx.value}") is not a valid ` +
+            `temporal bound — use the field's stored ISO shape.`, { fieldKey: ctx.fieldKey });
     }
 }
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/plugin/fields/errors.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,gBAAgB,CAAC,SAAS,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACvD,CAAC;IAEQ,IAAI,CAAuB;IAC3B,QAAQ,CAAqB;IAC7B,WAAW,CAAqB;IAChC,WAAW,CAAqB;IAChC,GAAG,CAAqB;IACxB,GAAG,CAAqB;IACxB,OAAO,CAAqB;IAErC,YACE,IAA0B,EAC1B,OAAe,EACf,MAA8B;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,sBAAsB,CAAC,GAI7B;QACC,OAAO,IAAI,gBAAgB,CACzB,4BAA4B,EAC5B,gBAAgB,GAAG,CAAC,QAAQ,WAAW,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAC7F,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,0BAA0B,CAAC,GAGjC;QACC,OAAO,IAAI,gBAAgB,CACzB,+BAA+B,EAC/B,aAAa,GAAG,CAAC,WAAW,0CAA0C;YACpE,KAAK,GAAG,CAAC,WAAW,iDAAiD,EACvE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,4BAA4B,CAAC,GAGnC;QACC,OAAO,IAAI,gBAAgB,CACzB,kCAAkC,EAClC,aAAa,GAAG,CAAC,WAAW,oBAAoB,GAAG,CAAC,WAAW,iBAAiB;YAC9E,6BAA6B,EAC/B,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,0BAA0B,CAAC,GAIjC;QACC,OAAO,IAAI,gBAAgB,CACzB,gCAAgC,EAChC,aAAa,GAAG,CAAC,WAAW,oBAAoB,GAAG,CAAC,WAAW,eAAe;YAC5E,IAAI,GAAG,CAAC,OAAO,IAAI,EACrB,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,yBAAyB,CAAC,GAGhC;QACC,OAAO,IAAI,gBAAgB,CACzB,8BAA8B,EAC9B,aAAa,GAAG,CAAC,WAAW,yBAAyB,GAAG,CAAC,WAAW,mBAAmB,EACvF,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/plugin/fields/errors.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,gBAAgB,CAAC,SAAS,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACvD,CAAC;IAEQ,IAAI,CAAuB;IAC3B,QAAQ,CAAqB;IAC7B,SAAS,CAAgC;IACzC,YAAY,CAAqB;IACjC,WAAW,CAAqB;IAChC,GAAG,CAAqB;IACxB,GAAG,CAAqB;IACxB,OAAO,CAAqB;IAErC,YACE,IAA0B,EAC1B,OAAe,EACf,MAA8B;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,sBAAsB,CAAC,GAI7B;QACC,OAAO,IAAI,gBAAgB,CACzB,4BAA4B,EAC5B,gBAAgB,GAAG,CAAC,QAAQ,WAAW,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAC7F,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,GAI3B;QACC,OAAO,IAAI,gBAAgB,CACzB,yBAAyB,EACzB,GAAG,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,iBAAiB,GAAG,CAAC,WAAW,OAAO;YAC1E,uCAAuC,EACzC,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,GAKzB;QACC,OAAO,IAAI,gBAAgB,CACzB,uBAAuB,EACvB,GAAG,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,iBAAiB,GAAG,CAAC,WAAW,IAAI;YACvE,eAAe,GAAG,CAAC,OAAO,IAAI,EAChC,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,GAIxB;QACC,OAAO,IAAI,gBAAgB,CACzB,qBAAqB,EACrB,GAAG,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,sBAAsB,GAAG,CAAC,WAAW,IAAI;YAC5E,iBAAiB,EACnB,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,GAIxB;QACC,OAAO,IAAI,gBAAgB,CACzB,mCAAmC,EACnC,GAAG,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,aAAa,GAAG,CAAC,WAAW,aAAa;YAC5E,8DAA8D,EAChE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,GAI3B;QACC,OAAO,IAAI,gBAAgB,CACzB,wBAAwB,EACxB,UAAU,GAAG,CAAC,QAAQ,OAAO,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,oBAAoB;YACtE,oDAAoD,EACtD,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAC3B,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,90 @@
+import type { Label } from "../../i18n/label.js";
+import type { FieldBuilder, GroupMetaBoxField, MetaBoxField, MetaBoxFieldInput, MetaBoxFieldSpan } from "../manifest.js";
+import type { MetaFieldCondition, MetaFieldConditionRule } from "./condition.js";
+import type { InferFields, InferStoredFields } from "./contributions.js";
+interface GroupFieldState {
+    readonly fields: readonly MetaBoxField[];
+    readonly visibleWhen?: MetaFieldCondition;
+    readonly label?: Label;
+    readonly description?: Label;
+    readonly required?: true;
+    readonly span?: MetaBoxFieldSpan;
+    readonly capability?: string;
+    readonly showInApi?: true;
+}
+/**
+ * Entry point of the `group()` chain — only `.fields()` is available
+ * until the members are declared, so a group without members can't
+ * reach `build()` (registration surfaces require a `build` method).
+ */
+export declare class GroupFieldSeed<K extends string = string> {
+    #private;
+    constructor(key: K);
+    /**
+     * Declare the group's member fields — infers the typed nested record.
+     * Members may be any registered field type, including nested
+     * repeaters and further groups; types recurse. Validated eagerly (key
+     * shape, uniqueness, prototype-pollution guard).
+     */
+    fields<const F extends readonly MetaBoxFieldInput[]>(fields: F): GroupFieldBuilder<F, K>;
+}
+/**
+ * Fluent chain for group fields — namespaces its members into a typed
+ * nested object stored under the group's own key (no key-flattening).
+ * Immutable — every call returns a fresh instance.
+ *
+ * `F` is the declared member tuple (drives the recursive record type);
+ * `K` is the literal field key; `V` is the phantom read type —
+ * `InferFields<F> | undefined`, narrowed by `.required()`; `S` is the
+ * phantom stored shape (`InferStoredFields<F>`). All purely type-level.
+ */
+export declare class GroupFieldBuilder<F extends readonly MetaBoxFieldInput[], K extends string = string, V = InferFields<F> | undefined, S = InferStoredFields<F> | undefined> implements FieldBuilder<GroupMetaBoxField> {
+    #private;
+    /** Phantom literal key of the field — type-level only, never assigned. */
+    readonly _key: K;
+    /** Phantom read type of the field — type-level only, never assigned. */
+    readonly _value: V;
+    /** Phantom stored shape of the field — type-level only, never assigned. */
+    readonly _stored: S;
+    constructor(key: string, state: GroupFieldState);
+    /** Override the derived (humanized-key) label. */
+    label(label: Label): GroupFieldBuilder<F, K, V, S>;
+    /** Help text rendered under the label. */
+    description(description: Label): GroupFieldBuilder<F, K, V, S>;
+    /** Mark the group required — narrows the read/stored types to the
+     *  non-optional nested record. */
+    required(): GroupFieldBuilder<F, K, InferFields<F>, InferStoredFields<F>>;
+    /**
+     * 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): GroupFieldBuilder<F, K, V, S>;
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability: string): GroupFieldBuilder<F, K, V, S>;
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi(): GroupFieldBuilder<F, K, V, S>;
+    /** Rule factory: this group has no stored value. */
+    isEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this group has a stored value. */
+    isNotEmpty(): 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[]): GroupFieldBuilder<F, K, V, S>;
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules: MetaFieldConditionRule[]): GroupFieldBuilder<F, K, V, S>;
+    /** Compile the chain into the wire/manifest field definition. */
+    build(): GroupMetaBoxField;
+}
+/**
+ * Named group of fields stored as a nested object under the group's own
+ * key — `group("seo").fields([text("title"), textarea("description")])`
+ * reads as `meta.seo.title` / `meta.seo.description`. Only `.fields()`
+ * is available on the bare constructor.
+ */
+export declare function group<K extends string>(key: K): GroupFieldSeed<K>;
+export {};
+//# sourceMappingURL=group.d.ts.map

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

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

package/dist/plugin/fields/group.js

@@ -0,0 +1,124 @@
+var _a;
+import { compileMetaBoxFields } from "../manifest.js";
+import { humanizeFieldKey } from "./builder.js";
+import { assertSubFields } from "./sub-fields.js";
+/**
+ * Entry point of the `group()` chain — only `.fields()` is available
+ * until the members are declared, so a group without members can't
+ * reach `build()` (registration surfaces require a `build` method).
+ */
+export class GroupFieldSeed {
+    #key;
+    constructor(key) {
+        this.#key = key;
+    }
+    /**
+     * Declare the group's member fields — infers the typed nested record.
+     * Members may be any registered field type, including nested
+     * repeaters and further groups; types recurse. Validated eagerly (key
+     * shape, uniqueness, prototype-pollution guard).
+     */
+    fields(fields) {
+        const compiled = compileMetaBoxFields(fields);
+        assertSubFields("group", this.#key, compiled);
+        return new GroupFieldBuilder(this.#key, { fields: compiled });
+    }
+}
+/**
+ * Fluent chain for group fields — namespaces its members into a typed
+ * nested object stored under the group's own key (no key-flattening).
+ * Immutable — every call returns a fresh instance.
+ *
+ * `F` is the declared member tuple (drives the recursive record type);
+ * `K` is the literal field key; `V` is the phantom read type —
+ * `InferFields<F> | undefined`, narrowed by `.required()`; `S` is the
+ * phantom stored shape (`InferStoredFields<F>`). All purely type-level.
+ */
+export class GroupFieldBuilder {
+    #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 });
+    }
+    /** Mark the group required — narrows the read/stored types to the
+     *  non-optional nested record. */
+    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 group has no stored value. */
+    isEmpty() {
+        return { key: this.#key, op: "empty" };
+    }
+    /** Rule factory: this group has a stored value. */
+    isNotEmpty() {
+        return { key: this.#key, op: "not_empty" };
+    }
+    /**
+     * 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],
+        });
+    }
+    /** Compile the chain into the wire/manifest field definition. */
+    build() {
+        const { fields, ...state } = this.#state;
+        return {
+            ...state,
+            key: this.#key,
+            label: state.label ?? humanizeFieldKey(this.#key),
+            type: "json",
+            inputType: "group",
+            fields,
+        };
+    }
+}
+_a = GroupFieldBuilder;
+/**
+ * Named group of fields stored as a nested object under the group's own
+ * key — `group("seo").fields([text("title"), textarea("description")])`
+ * reads as `meta.seo.title` / `meta.seo.description`. Only `.fields()`
+ * is available on the bare constructor.
+ */
+export function group(key) {
+    return new GroupFieldSeed(key);
+}
+//# sourceMappingURL=group.js.map

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

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

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

@@ -1,50 +1,27 @@
-export { text } from "./text.js";
-export type { TextFieldOptions } from "./text.js";
-export { textarea } from "./textarea.js";
-export type { TextareaFieldOptions } from "./textarea.js";
-export { number } from "./number.js";
-export type { NumberFieldOptions } from "./number.js";
-export { email } from "./email.js";
-export type { EmailFieldOptions } from "./email.js";
-export { url } from "./url.js";
-export type { UrlFieldOptions } from "./url.js";
-export { password } from "./password.js";
-export type { PasswordFieldOptions } from "./password.js";
-export { date } from "./date.js";
-export type { DateFieldOptions } from "./date.js";
-export { datetime } from "./datetime.js";
-export type { DateTimeFieldOptions } from "./datetime.js";
-export { time } from "./time.js";
-export type { TimeFieldOptions } from "./time.js";
+export { isFieldVisible } from "./condition.js";
+export type { MetaFieldCondition, MetaFieldConditionOperator, MetaFieldConditionRule, } from "./condition.js";
+export { email, password, StringFieldBuilder, text, textarea, url, } from "./builder.js";
+export type { StringInputType } from "./builder.js";
+export { link, LinkFieldBuilder } from "./link.js";
+export type { LinkValue } from "./link.js";
+export { number, NumberFieldBuilder } from "./number.js";
+export { date, datetime, TemporalFieldBuilder, time } from "./temporal.js";
+export type { TemporalInputType } from "./temporal.js";
 export { parseMetaDate } from "./parse-date.js";
-export { color } from "./color.js";
-export type { ColorFieldOptions } from "./color.js";
-export { range } from "./range.js";
-export type { RangeFieldOptions } from "./range.js";
-export { multiselect } from "./multiselect.js";
-export type { MultiselectFieldOptions } from "./multiselect.js";
-export { json } from "./json.js";
-export type { JsonFieldOptions } from "./json.js";
-export { richtext } from "./richtext.js";
-export type { RichtextFieldOptions } from "./richtext.js";
-export { repeater } from "./repeater.js";
-export type { RepeaterFieldOptions } from "./repeater.js";
-export { select } from "./select.js";
-export type { SelectFieldOptions } from "./select.js";
-export { radio } from "./radio.js";
-export type { RadioFieldOptions } from "./radio.js";
-export { checkbox } from "./checkbox.js";
-export type { CheckboxFieldOptions } from "./checkbox.js";
+export { color, ColorFieldBuilder } from "./color.js";
+export { range, RangeFieldBuilder, RangeFieldSeed } from "./range.js";
+export { json, JsonFieldBuilder } from "./json.js";
+export { richtext, RichtextFieldBuilder } from "./richtext.js";
+export { repeater, RepeaterFieldBuilder, RepeaterFieldSeed, } from "./repeater.js";
+export { group, GroupFieldBuilder, GroupFieldSeed } from "./group.js";
+export { select, SelectFieldBuilder, SelectFieldSeed } from "./select.js";
+export type { SelectOptionInput } from "./select.js";
+export { toggle, ToggleFieldBuilder } from "./toggle.js";
+export { ReferenceFieldBuilder } from "./reference.js";
 export { user } from "./user.js";
-export type { UserFieldOptions, UserFieldScope } from "./user.js";
-export { userList } from "./user-list.js";
-export type { UserListFieldOptions } from "./user-list.js";
+export type { UserFieldScope } from "./user.js";
 export { entry } from "./entry.js";
-export type { EntryFieldOptions, EntryFieldScope } from "./entry.js";
-export { entryList } from "./entry-list.js";
-export type { EntryListFieldOptions } from "./entry-list.js";
+export type { EntryFieldScope } from "./entry.js";
 export { term } from "./term.js";
-export type { TermFieldOptions, TermFieldScope } from "./term.js";
-export { termList } from "./term-list.js";
-export type { TermListFieldOptions } from "./term-list.js";
+export type { TermFieldScope } from "./term.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,GAAG,GACJ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/plugin/fields/index.js

@@ -1,37 +1,32 @@
-// Typed builder helpers for meta-box field registration. Each builder
-// returns the narrowed variant of `MetaBoxField` matching its input
-// type (e.g. `text()` → `TextMetaBoxField`), so the rest of the field
-// schema is type-checked against options that actually apply to the
-// renderer — `text({ min: 5 })` is a compile error.
-//
-// Builders are the recommended path for plugin authors going forward;
-// existing object-literal registrations continue to compile against
-// the broad `LegacyMetaBoxField` shape during the migration window.
+// Typed builder helpers for meta-box field registration. The scalar
+// fields (string, numeric, temporal, color, richtext, json), `link`,
+// the choice field (`select` — `.multiple()` for arrays,
+// `.appearance()` for the control), the boolean switch (`toggle`), and
+// the reference fields (`entry` / `term` / `user` — `.multiple()` for
+// id arrays, `.returns("id")` to opt out of read-time hydration) are
+// fluent builders: the constructor takes the key (plus a required
+// scope for `entry` / `term`) and every option is a chained call
+// (`text("subtitle").maxLength(120)`, `entry("hero", ["post"]).required()`),
+// each returning a fresh immutable instance that compiles to the
+// narrowed `MetaBoxField` variant at registration.
 //
 // Re-exported as a public surface from `plumix/fields`.
-export { text } from "./text.js";
-export { textarea } from "./textarea.js";
-export { number } from "./number.js";
-export { email } from "./email.js";
-export { url } from "./url.js";
-export { password } from "./password.js";
-export { date } from "./date.js";
-export { datetime } from "./datetime.js";
-export { time } from "./time.js";
+export { isFieldVisible } from "./condition.js";
+export { email, password, StringFieldBuilder, text, textarea, url, } from "./builder.js";
+export { link, LinkFieldBuilder } from "./link.js";
+export { number, NumberFieldBuilder } from "./number.js";
+export { date, datetime, TemporalFieldBuilder, time } from "./temporal.js";
 export { parseMetaDate } from "./parse-date.js";
-export { color } from "./color.js";
-export { range } from "./range.js";
-export { multiselect } from "./multiselect.js";
-export { json } from "./json.js";
-export { richtext } from "./richtext.js";
-export { repeater } from "./repeater.js";
-export { select } from "./select.js";
-export { radio } from "./radio.js";
-export { checkbox } from "./checkbox.js";
+export { color, ColorFieldBuilder } from "./color.js";
+export { range, RangeFieldBuilder, RangeFieldSeed } from "./range.js";
+export { json, JsonFieldBuilder } from "./json.js";
+export { richtext, RichtextFieldBuilder } from "./richtext.js";
+export { repeater, RepeaterFieldBuilder, RepeaterFieldSeed, } from "./repeater.js";
+export { group, GroupFieldBuilder, GroupFieldSeed } from "./group.js";
+export { select, SelectFieldBuilder, SelectFieldSeed } from "./select.js";
+export { toggle, ToggleFieldBuilder } from "./toggle.js";
+export { ReferenceFieldBuilder } from "./reference.js";
 export { user } from "./user.js";
-export { userList } from "./user-list.js";
 export { entry } from "./entry.js";
-export { entryList } from "./entry-list.js";
 export { term } from "./term.js";
-export { termList } from "./term-list.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/fields/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oEAAoE;AACpE,sEAAsE;AACtE,oEAAoE;AACpE,oDAAoD;AACpD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,oEAAoE;AACpE,EAAE;AACF,wDAAwD;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/fields/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,qEAAqE;AACrE,yDAAyD;AACzD,uEAAuE;AACvE,sEAAsE;AACtE,qEAAqE;AACrE,kEAAkE;AAClE,iEAAiE;AACjE,6EAA6E;AAC7E,iEAAiE;AACjE,mDAAmD;AACnD,EAAE;AACF,wDAAwD;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhD,OAAO,EACL,KAAK,EACL,QAAQ,EACR,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,GAAG,GACJ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

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

@@ -1,19 +1,81 @@
 import type { Label } from "../../i18n/label.js";
-import type { JsonMetaBoxField, MetaBoxFieldSpan } from "../manifest.js";
-export interface JsonFieldOptions {
-    readonly key: string;
-    readonly label: Label;
-    readonly required?: boolean;
+import type { FieldBuilder, JsonMetaBoxField, MetaBoxFieldSpan, MetaBoxFieldValidate } from "../manifest.js";
+import type { MetaFieldCondition, MetaFieldConditionRule } from "./condition.js";
+interface JsonFieldState {
+    readonly visibleWhen?: MetaFieldCondition;
+    readonly label?: Label;
     readonly description?: Label;
     readonly default?: unknown;
+    readonly required?: true;
     readonly span?: MetaBoxFieldSpan;
     readonly capability?: string;
+    readonly showInApi?: true;
     readonly sanitize?: (value: unknown) => unknown;
+    readonly validate?: MetaBoxFieldValidate;
 }
 /**
- * Build a typed `json` meta-box field. Storage round-trips through
- * `JSON.stringify` so any value that survives serialisation survives
- * the wire.
+ * Fluent chain for the free-form `json` field. Storage round-trips
+ * through `JSON.stringify` so any value that survives serialisation
+ * survives the wire. Values read and store as `unknown` — the field
+ * carries no schema for the type layer to narrow.
  */
-export declare function json(options: JsonFieldOptions): JsonMetaBoxField;
+export declare class JsonFieldBuilder<K extends string = string> implements FieldBuilder<JsonMetaBoxField> {
+    #private;
+    /** Phantom literal key of the field — type-level only, never assigned. */
+    readonly _key: K;
+    /** Phantom read type of the field — type-level only, never assigned. */
+    readonly _value: unknown;
+    /** Phantom stored shape of the field — type-level only, never assigned. */
+    readonly _stored: unknown;
+    constructor(key: string, state?: JsonFieldState);
+    /** Override the derived (humanized-key) label. */
+    label(label: Label): JsonFieldBuilder<K>;
+    /** Help text rendered under the label. */
+    description(description: Label): JsonFieldBuilder<K>;
+    /** Default for absent keys — any JSON-serialisable value, applied at
+     * read decode (and seeded into the admin form). */
+    default(value: unknown): JsonFieldBuilder<K>;
+    /** Mark the field required. */
+    required(): JsonFieldBuilder<K>;
+    /**
+     * 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): JsonFieldBuilder<K>;
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability: string): JsonFieldBuilder<K>;
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi(): JsonFieldBuilder<K>;
+    /** Rule factory: this field's value equals `value` — pass the rule
+     *  to a dependent field's `.visibleWhen()`. */
+    is(value: unknown): MetaFieldConditionRule;
+    /** Rule factory: this field's value differs from `value`. */
+    isNot(value: unknown): MetaFieldConditionRule;
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field has a value. */
+    isNotEmpty(): 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[]): JsonFieldBuilder<K>;
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules: MetaFieldConditionRule[]): JsonFieldBuilder<K>;
+    /** Normalising transform, applied after coercion and before persistence. */
+    sanitize(sanitize: (value: unknown) => unknown): JsonFieldBuilder<K>;
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate: (value: unknown) => true | Label | Promise<true | Label>): JsonFieldBuilder<K>;
+    /** Compile the chain into the wire/manifest field definition. */
+    build(): JsonMetaBoxField;
+}
+/** Free-form JSON value round-tripping through the JSON serializer. */
+export declare function json<K extends string>(key: K): JsonFieldBuilder<K>;
+export {};
 //# sourceMappingURL=json.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,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,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAahE"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/json.ts"],"names":[],"mappings":"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"}