@plumix/core 0.6.0 → 0.7.0

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

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

package/dist/plugin/fields/link.js

@@ -0,0 +1,160 @@
+var _a;
+import { humanizeFieldKey } from "./builder.js";
+import { SAFE_HREF_RE } from "./richtext-validate.js";
+/**
+ * Fluent chain for the `link` field — see `StringFieldBuilder` for the
+ * chassis conventions (immutability, phantom `K`/`V`/`S`, `build()`
+ * seam). `V` is `LinkValue | undefined` unadorned, narrowed to
+ * `LinkValue` by `.required()` / `.default()`; `S` is the stored shape,
+ * narrowed by `.required()` only (defaults apply at decode time).
+ */
+export class LinkFieldBuilder {
+    #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 });
+    }
+    /** Placeholder for the control's URL input. */
+    placeholder(placeholder) {
+        return this.#fork({ placeholder });
+    }
+    /** Static adornment rendered before the input. */
+    prepend(prepend) {
+        return this.#fork({ prepend });
+    }
+    /** Static adornment rendered after the input. */
+    append(append) {
+        return this.#fork({ append });
+    }
+    /** Default for absent keys, applied at read decode (and seeded into
+     * the admin form) — narrows the read type to `LinkValue`; the stored
+     * shape stays optional. */
+    default(value) {
+        return this.#fork({ default: value });
+    }
+    /** Mark the field required — narrows the read and stored types to `LinkValue`. */
+    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" };
+    }
+    /**
+     * 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 the built-in shape/URL
+     * validation 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() {
+        return {
+            ...this.#state,
+            key: this.#key,
+            label: this.#state.label ?? humanizeFieldKey(this.#key),
+            type: "json",
+            inputType: "link",
+        };
+    }
+}
+_a = LinkFieldBuilder;
+/** CTA-style link field — internal entry URL or external URL, optional
+ *  label + new-tab. Shape and URL are enforced server-side by the
+ *  constraint walker. */
+export function link(key) {
+    return new LinkFieldBuilder(key);
+}
+/**
+ * Parse an incoming link value into its canonical `LinkValue` shape, or
+ * `null` when malformed. Rebuilds from the known keys so unrecognized
+ * properties never persist. The URL gate is `SAFE_HREF_RE` (shared with
+ * richtext link marks): relative forms (`/pricing` — what the admin's
+ * entry picker stores — plus `#`, `?`, `./`) and `https?` / `mailto:` /
+ * `tel:` absolutes. Script-bearing schemes (`javascript:`, `data:`)
+ * hard-fail — the value is destined for rendered anchor hrefs.
+ */
+export function parseLinkValue(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return null;
+    }
+    const { url, label, newTab } = value;
+    if (typeof url !== "string" || !SAFE_HREF_RE.test(url))
+        return null;
+    if (label !== undefined && typeof label !== "string")
+        return null;
+    if (newTab !== undefined && typeof newTab !== "boolean")
+        return null;
+    return {
+        url,
+        ...(label !== undefined ? { label } : {}),
+        ...(newTab !== undefined ? { newTab } : {}),
+    };
+}
+//# sourceMappingURL=link.js.map

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

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

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

@@ -1,23 +1,96 @@
 import type { Label } from "../../i18n/label.js";
-import type { MetaBoxFieldSpan, NumberMetaBoxField } from "../manifest.js";
-export interface NumberFieldOptions {
-    readonly key: string;
-    readonly label: Label;
-    readonly placeholder?: Label;
-    readonly min?: number;
-    readonly max?: number;
-    readonly step?: number;
-    readonly required?: boolean;
+import type { FieldBuilder, MetaBoxFieldSpan, MetaBoxFieldValidate, NumberMetaBoxField } from "../manifest.js";
+import type { MetaFieldCondition, MetaFieldConditionRule } from "./condition.js";
+interface NumberFieldState {
+    readonly visibleWhen?: MetaFieldCondition;
+    readonly label?: Label;
     readonly description?: Label;
+    readonly placeholder?: Label;
     readonly default?: number;
+    readonly required?: true;
     readonly span?: MetaBoxFieldSpan;
     readonly capability?: string;
+    readonly showInApi?: true;
+    readonly min?: number;
+    readonly max?: number;
+    readonly step?: number;
     readonly sanitize?: (value: unknown) => unknown;
+    readonly validate?: MetaBoxFieldValidate;
 }
 /**
- * Build a typed `number` meta-box field. `step` defaults to `1` (integer
- * input) when omitted at the renderer; the registration shape leaves it
- * `undefined` so the manifest stays minimal.
+ * Fluent chain for the `number` field. Mirrors `StringFieldBuilder` —
+ * immutable, phantom-typed (`K` literal key, `V` read type, `S`
+ * stored shape). `step` defaults to `1` (integer input) at the
+ * renderer when omitted; the definition stays minimal.
  */
-export declare function number(options: NumberFieldOptions): NumberMetaBoxField;
+export declare class NumberFieldBuilder<K extends string = string, V extends number | undefined = number | undefined, S extends number | undefined = number | undefined> implements FieldBuilder<NumberMetaBoxField> {
+    #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?: NumberFieldState);
+    /** Override the derived (humanized-key) label. */
+    label(label: Label): NumberFieldBuilder<K, V, S>;
+    /** Help text rendered under the label. */
+    description(description: Label): NumberFieldBuilder<K, V, S>;
+    placeholder(placeholder: Label): NumberFieldBuilder<K, V, S>;
+    /** 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: number): NumberFieldBuilder<K, number, S>;
+    /** Mark the field required — narrows the read and stored types to `number`. */
+    required(): NumberFieldBuilder<K, number, number>;
+    /**
+     * 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): NumberFieldBuilder<K, V, S>;
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability: string): NumberFieldBuilder<K, V, S>;
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi(): NumberFieldBuilder<K, V, S>;
+    /** Rule factory: this field's value equals `value` — pass the rule
+     *  to a dependent field's `.visibleWhen()`. */
+    is(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field's value differs from `value`. */
+    isNot(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field has a value. */
+    isNotEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field's value is greater than `value`. */
+    gt(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field's value is less than `value`. */
+    lt(value: number): 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[]): NumberFieldBuilder<K, V, S>;
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules: MetaFieldConditionRule[]): NumberFieldBuilder<K, V, S>;
+    /** Lower bound, enforced client-side by the native number input. */
+    min(min: number): NumberFieldBuilder<K, V, S>;
+    /** Upper bound, enforced client-side by the native number input. */
+    max(max: number): NumberFieldBuilder<K, V, S>;
+    step(step: number): NumberFieldBuilder<K, V, S>;
+    /** Normalising transform, applied after coercion and before persistence. */
+    sanitize(sanitize: (value: NonNullable<V>) => NonNullable<V>): NumberFieldBuilder<K, V, S>;
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate: (value: NonNullable<V>) => true | Label | Promise<true | Label>): NumberFieldBuilder<K, V, S>;
+    /** Compile the chain into the wire/manifest field definition. */
+    build(): NumberMetaBoxField;
+}
+/** Numeric input with optional `.min()` / `.max()` / `.step()` bounds. */
+export declare function number<K extends string>(key: K): NumberFieldBuilder<K>;
+export {};
 //# sourceMappingURL=number.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,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,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAiBtE"}
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/number.ts"],"names":[],"mappings":"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"}

package/dist/plugin/fields/number.js

@@ -1,24 +1,137 @@
+var _a;
+import { humanizeFieldKey } from "./builder.js";
 /**
- * Build a typed `number` meta-box field. `step` defaults to `1` (integer
- * input) when omitted at the renderer; the registration shape leaves it
- * `undefined` so the manifest stays minimal.
+ * Fluent chain for the `number` field. Mirrors `StringFieldBuilder` —
+ * immutable, phantom-typed (`K` literal key, `V` read type, `S`
+ * stored shape). `step` defaults to `1` (integer input) at the
+ * renderer when omitted; the definition stays minimal.
  */
-export function number(options) {
-    return {
-        key: options.key,
-        label: options.label,
-        type: "number",
-        inputType: "number",
-        placeholder: options.placeholder,
-        min: options.min,
-        max: options.max,
-        step: options.step,
-        required: options.required,
-        description: options.description,
-        default: options.default,
-        span: options.span,
-        capability: options.capability,
-        sanitize: options.sanitize,
-    };
+export class NumberFieldBuilder {
+    #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 });
+    }
+    placeholder(placeholder) {
+        return this.#fork({ placeholder });
+    }
+    /** 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],
+        });
+    }
+    /** Lower bound, enforced client-side by the native number input. */
+    min(min) {
+        return this.#fork({ min });
+    }
+    /** Upper bound, enforced client-side by the native number input. */
+    max(max) {
+        return this.#fork({ max });
+    }
+    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() {
+        return {
+            ...this.#state,
+            key: this.#key,
+            label: this.#state.label ?? humanizeFieldKey(this.#key),
+            type: "number",
+            inputType: "number",
+        };
+    }
+}
+_a = NumberFieldBuilder;
+/** Numeric input with optional `.min()` / `.max()` / `.step()` bounds. */
+export function number(key) {
+    return new NumberFieldBuilder(key);
 }
 //# sourceMappingURL=number.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../src/plugin/fields/number.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAA2B;IAChD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,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;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../src/plugin/fields/number.ts"],"names":[],"mappings":"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"}

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

@@ -1,28 +1,112 @@
 import type { Label } from "../../i18n/label.js";
-import type { MetaBoxFieldSpan, RangeMetaBoxField } from "../manifest.js";
-export interface RangeFieldOptions {
-    readonly key: string;
-    readonly label: Label;
-    readonly min: number;
-    readonly max: number;
-    readonly step?: number;
-    readonly required?: boolean;
+import type { FieldBuilder, MetaBoxFieldSpan, MetaBoxFieldValidate, RangeMetaBoxField } from "../manifest.js";
+import type { MetaFieldCondition, MetaFieldConditionRule } from "./condition.js";
+interface RangeFieldState {
+    readonly visibleWhen?: MetaFieldCondition;
+    readonly label?: Label;
     readonly description?: Label;
     readonly default?: number;
+    readonly required?: true;
     readonly span?: MetaBoxFieldSpan;
     readonly capability?: string;
+    readonly showInApi?: true;
+    readonly min: number;
+    readonly max: number;
+    readonly step?: number;
+    readonly sanitize?: (value: unknown) => unknown;
+    readonly validate?: MetaBoxFieldValidate;
+}
+/**
+ * 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 declare class RangeFieldSeed<K extends string = string> {
+    #private;
+    constructor(key: K);
     /**
-     * Optional override. The builder ships a default sanitizer that
-     * enforces the declared `min`/`max` bounds on write; passing a
-     * custom one replaces it entirely.
+     * Declare the slider's inclusive `[min, max]` track — both required.
+     * `min <= max` is enforced when the chain compiles at registration.
      */
-    readonly sanitize?: (value: unknown) => unknown;
+    bounds(min: number, max: number): RangeFieldBuilder<K>;
+}
+/**
+ * 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 declare class RangeFieldBuilder<K extends string = string, V extends number | undefined = number | undefined, S extends number | undefined = number | undefined> implements FieldBuilder<RangeMetaBoxField> {
+    #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: RangeFieldState);
+    /** Override the derived (humanized-key) label. */
+    label(label: Label): RangeFieldBuilder<K, V, S>;
+    /** Help text rendered under the label. */
+    description(description: Label): RangeFieldBuilder<K, V, S>;
+    /** 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: number): RangeFieldBuilder<K, number, S>;
+    /** Mark the field required — narrows the read and stored types to `number`. */
+    required(): RangeFieldBuilder<K, number, number>;
+    /**
+     * 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): RangeFieldBuilder<K, V, S>;
+    /** Capability gate for this field — see `MetaBoxFieldBase.capability`. */
+    capability(capability: string): RangeFieldBuilder<K, V, S>;
+    /** Opt this field's value into public REST responses (default-deny). */
+    showInApi(): RangeFieldBuilder<K, V, S>;
+    /** Rule factory: this field's value equals `value` — pass the rule
+     *  to a dependent field's `.visibleWhen()`. */
+    is(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field's value differs from `value`. */
+    isNot(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field has no value (unset or cleared). */
+    isEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field has a value. */
+    isNotEmpty(): MetaFieldConditionRule;
+    /** Rule factory: this field's value is greater than `value`. */
+    gt(value: number): MetaFieldConditionRule;
+    /** Rule factory: this field's value is less than `value`. */
+    lt(value: number): 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[]): RangeFieldBuilder<K, V, S>;
+    /** Add an OR alternative — one more AND group of rules. */
+    orVisibleWhen(...rules: MetaFieldConditionRule[]): RangeFieldBuilder<K, V, S>;
+    step(step: number): RangeFieldBuilder<K, V, S>;
+    /** Normalising transform, applied after coercion and before persistence. */
+    sanitize(sanitize: (value: NonNullable<V>) => NonNullable<V>): RangeFieldBuilder<K, V, S>;
+    /**
+     * Custom validation — `true` for valid, or an i18n-able failure
+     * message (sync or async). Runs after `.sanitize()` and the
+     * declarative constraints.
+     */
+    validate(validate: (value: NonNullable<V>) => true | Label | Promise<true | Label>): RangeFieldBuilder<K, V, S>;
+    /** Compile the chain into the wire/manifest field definition. */
+    build(): RangeMetaBoxField;
 }
 /**
- * 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.
+ * 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 declare function range(options: RangeFieldOptions): RangeMetaBoxField;
+export declare function range<K extends string>(key: K): RangeFieldSeed<K>;
+export {};
 //# sourceMappingURL=range.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,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;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAwBnE"}
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/plugin/fields/range.ts"],"names":[],"mappings":"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"}