@byline/core 0.9.3

package/dist/@types/field-data-types.js

@@ -0,0 +1,38 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Type guard to check if a StoredFileValue represents a pending (not yet uploaded) file.
+ */
+export function isPendingStoredFileValue(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return v.storageProvider === 'pending';
+}
+/**
+ * Create a pending placeholder value for a file that is selected but not yet uploaded.
+ */
+export function createPendingStoredFileValue(file, previewUrl, dimensions) {
+    return {
+        fileId: `pending-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+        filename: file.name,
+        originalFilename: file.name,
+        mimeType: file.type,
+        fileSize: String(file.size),
+        storageProvider: 'pending',
+        storagePath: '',
+        storageUrl: previewUrl,
+        fileHash: null,
+        imageWidth: dimensions?.width ?? null,
+        imageHeight: dimensions?.height ?? null,
+        imageFormat: null,
+        processingStatus: 'pending',
+        thumbnailGenerated: false,
+    };
+}
+//# sourceMappingURL=field-data-types.js.map

package/dist/@types/field-data-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-data-types.js","sourceRoot":"","sources":["../../src/@types/field-data-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+MH;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,CAAC,GAAG,KAAiC,CAAA;IAC3C,OAAO,CAAC,CAAC,eAAe,KAAK,SAAS,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAU,EACV,UAAkB,EAClB,UAA8C;IAE9C,OAAO;QACL,MAAM,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACtE,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,gBAAgB,EAAE,IAAI,CAAC,IAAI;QAC3B,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI,IAAI;QACrC,WAAW,EAAE,UAAU,EAAE,MAAM,IAAI,IAAI;QACvC,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,SAAS;QAC3B,kBAAkB,EAAE,KAAK;KAC1B,CAAA;AACH,CAAC"}

package/dist/@types/field-types.d.ts

@@ -0,0 +1,579 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { UploadConfig } from './collection-types.js';
+import type { MaybePromise, NonEmptyArray } from './type-utils.js';
+/**
+ * Context passed to functions that generate default values for fields,
+ * containing the current document data, locale, and a few helper functions.
+ */
+export interface DefaultValueContext {
+    /**
+     * The current document data as it is being built/edited.  Defaults may read
+     * other field values from here.
+     */
+    data: Record<string, any>;
+    /**
+     * Current locale (when defaults are locale-aware).
+     */
+    locale?: string;
+    /**
+     * Clock access for time-based defaults.
+     */
+    now: () => Date;
+    /**
+     * UUID generator for defaults that need stable IDs.
+     */
+    uuid?: () => string;
+}
+/**
+ * A function that generates a default value for a field
+ */
+type DefaultValueFn<T> = (ctx: DefaultValueContext) => T | Promise<T>;
+/**
+ * Either an actual default value, or a function that generates one
+ */
+export type DefaultValue<T = unknown> = T | DefaultValueFn<T>;
+/**
+ * Context passed to field-level hooks. Gives the hook access to the changing
+ * value, the previous value, the full document data, and the field definition.
+ */
+export interface FieldHookContext {
+    /**
+     * The incoming value (after the user edit).
+     */
+    value: any;
+    /**
+     *  The value before this edit.
+     */
+    previousValue: any;
+    /**
+     * Current document data (full form state).
+     */
+    data: Record<string, any>;
+    /**
+     * Dot-path of the field inside the document, e.g. `"content.0.richText"`.
+     */
+    path: string;
+    /**
+     * The field definition this hook is attached to.
+     */
+    field: Field;
+    /**
+     * `'change'` — fired on every keystroke / field edit.
+     * `'submit'` — fired once during form submit, before `validateForm()`.
+     *
+     * Hooks can use this to vary behaviour, e.g. only auto-populate a
+     * derived value at submit time while showing advisory errors on change.
+     */
+    operation: 'change' | 'submit';
+}
+/**
+ * Return type of `beforeValidate` hooks.
+ */
+export interface FieldBeforeValidateResult {
+    /** If set, the change is blocked and this message is shown as a field error. */
+    error?: string;
+}
+/**
+ * A single `beforeValidate` hook function
+ */
+export type FieldBeforeValidateFn = (ctx: FieldHookContext) => MaybePromise<FieldBeforeValidateResult | void>;
+/**
+ * Return type of `beforeChange`. Allows the hook to:
+ *  - replace the value (`value`),
+ *  - reject the change with a per-field error (`error`),
+ *  - or do nothing (return `undefined` / `{}`).
+ */
+export interface FieldBeforeChangeResult {
+    /** If set, this value replaces the incoming value. */
+    value?: any;
+    /** If set, the change is blocked and this message is shown as a field error. */
+    error?: string;
+}
+/**
+ * A single beforeChange hook function.
+ */
+export type FieldBeforeChangeFn = (ctx: FieldHookContext) => MaybePromise<FieldBeforeChangeResult | void>;
+/**
+ * Hooks that can be attached to any field via the `hooks` property on the
+ * field definition. Both hooks are async-capable to support debounced
+ * remote validation or similar patterns.
+ *
+ * Each hook accepts a single function or an **array** of functions that
+ * are executed in order. Execution stops at the first function that
+ * returns `{ error }` (for blocking hooks like `beforeChange`).
+ */
+export interface FieldHooks {
+    /**
+     * Fires **before** the built-in validation rules are evaluated.
+     *
+     * This hook is **advisory**: the value is always committed to the form
+     * store regardless of the result. Returning `{ error }` displays a
+     * per-field error (useful for live validation feedback) but does **not**
+     * block the change — the user can keep typing.
+     */
+    beforeValidate?: FieldBeforeValidateFn | FieldBeforeValidateFn[];
+    /**
+     * Fires **after** `beforeValidate` but **before** the value is committed
+     * to the form store and a patch is emitted.
+     *
+     * Returning `{ value }` substitutes the committed value (e.g. trim, slug).
+     * Returning `{ error }` **blocks** the change — the value is not written.
+     *
+     * ⚠️  Value transformations will reset the cursor position in text inputs.
+     * Prefer `beforeValidate` for feedback that should not interfere with typing.
+     */
+    beforeChange?: FieldBeforeChangeFn | FieldBeforeChangeFn[];
+}
+/**
+ * Normalise a hook slot (single function or array) into a flat array.
+ */
+export declare function normalizeHooks<T>(hook: T | T[] | undefined): T[];
+export interface ValidationRule {
+    type: 'min' | 'max' | 'pattern' | 'custom' | 'email' | 'url';
+    value: any;
+    message?: string;
+}
+type FieldValidateFn = (value: any, data: Record<string, any>) => string | undefined;
+/**
+ * Base properties shared by all fields
+ */
+interface BaseField {
+    name: string;
+    label?: string;
+    helpText?: string;
+    placeholder?: string;
+    /**
+     * Is this field optional or required?  Fields are required by default; set
+     * this to `true` to make the field optional.  If the field is required, a
+     * value must be provided (possibly via a default value or hook) for the
+     * document to be considered valid.
+     */
+    optional?: boolean;
+    /**
+     * Optional field-level hooks that run on the client during editing.
+     * @see FieldHooks
+     */
+    hooks?: FieldHooks;
+    /**
+     * Optional submit-time validator. Called by `validateForm()` for every field
+     * type — including structure fields (group, array, blocks).
+     *
+     * Receives the resolved field value (lodash `get` on the full form store, so
+     * group fields arrive as their assembled value, e.g. `[{en:true},{fr:false}]`)
+     * and the complete form data snapshot.
+     *
+     * Return a non-empty string to block submission and display the message as a
+     * field-level error. Return `undefined` (or nothing) to pass.
+     */
+    validate?: FieldValidateFn;
+}
+/**
+ * Base for fields that support localization (i.e. may be configured to have
+ * separate values per locale).
+ */
+interface LocalizableField extends BaseField {
+    localized?: boolean;
+}
+/**
+ * Base for fields that do not support localization (i.e. always have a single
+ * value across all locales).
+ */
+interface NonlocalizableField extends BaseField {
+    localized?: false;
+}
+export interface GroupField extends NonlocalizableField {
+    type: 'group';
+    fields: FieldSet;
+}
+export interface ArrayField extends NonlocalizableField {
+    type: 'array';
+    fields: FieldSet;
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+    };
+}
+export interface Block {
+    blockType: string;
+    fields: FieldSet;
+    label?: string;
+    helpText?: string;
+    hooks?: FieldHooks;
+    validate?: FieldValidateFn;
+}
+export interface BlocksField extends NonlocalizableField {
+    type: 'blocks';
+    blocks: Block[];
+}
+export interface TextField extends LocalizableField {
+    type: 'text';
+    defaultValue?: DefaultValue<string>;
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        rules?: ValidationRule[];
+    };
+}
+export interface TextAreaField extends LocalizableField {
+    type: 'textArea';
+    defaultValue?: DefaultValue<string>;
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        rules?: ValidationRule[];
+    };
+}
+export interface CheckboxField extends NonlocalizableField {
+    type: 'checkbox';
+    defaultValue?: DefaultValue<boolean>;
+}
+export interface BooleanField extends NonlocalizableField {
+    type: 'boolean';
+    defaultValue?: DefaultValue<boolean>;
+}
+export interface SelectFieldOption {
+    label: string;
+    value: string;
+}
+export interface SelectField<Options extends NonEmptyArray<SelectFieldOption> = NonEmptyArray<SelectFieldOption>> extends NonlocalizableField {
+    type: 'select';
+    options: Options;
+    defaultValue?: DefaultValue<Options[number]['value']>;
+}
+export interface RichTextField extends LocalizableField {
+    type: 'richText';
+    defaultValue?: DefaultValue<unknown>;
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+    };
+    /**
+     * Editor-specific configuration. The shape is opaque to `@byline/core` —
+     * each editor adapter defines what it accepts. For `@byline/richtext-lexical`
+     * this is its `EditorConfig`. Per-field config takes precedence over any
+     * baked-in config supplied at registration via `lexicalEditor()`.
+     */
+    editorConfig?: unknown;
+    /**
+     * **Write-time strategy.** When `true`, the editor's relation-bearing
+     * nodes (internal links, inline images, …) embed a small projection of
+     * the picked target's fields directly into the persisted JSON at
+     * modal-save time. Defaults to `true`.
+     *
+     * Set to `false` only when the field will be served by read-time
+     * populate (see `populateRelationsOnRead`). Without populate, public
+     * renderers see a stripped envelope (relation primary keys only) and
+     * have no title / path / image to render.
+     *
+     * Adapter-agnostic — any future editor adapter with relation-bearing
+     * nodes inherits the same lever.
+     */
+    embedRelationsOnSave?: boolean;
+    /**
+     * **Read-time strategy.** When `true`, the framework's read pipeline
+     * walks this field's value on every read and asks the registered
+     * richtext populate function to refresh embedded relation envelopes
+     * against their source documents.
+     *
+     * Default is the inverse of `embedRelationsOnSave`:
+     *   - `embedRelationsOnSave: true`  → defaults to `false` (snapshot mode).
+     *   - `embedRelationsOnSave: false` → defaults to `true` (storage-thin).
+     *
+     * Set both to `true` for belt-and-braces: embed at write, refresh on
+     * read. Setting both to `false` is invalid — `initBylineCore()` rejects
+     * fields where neither write-time nor read-time would render.
+     *
+     * Requires a registered `ServerConfig.fields.richText.populate` adapter
+     * when effectively `true`; otherwise `initBylineCore()` throws.
+     */
+    populateRelationsOnRead?: boolean;
+}
+export interface TimeField extends NonlocalizableField {
+    type: 'time';
+    defaultValue?: DefaultValue<'00:00' | string>;
+}
+export interface DateField extends NonlocalizableField {
+    type: 'date';
+    defaultValue?: DefaultValue<Date>;
+}
+export interface DateTimeField extends NonlocalizableField {
+    type: 'datetime';
+    mode?: 'date' | 'datetime';
+    yearsInFuture?: number;
+    yearsInPast?: number;
+    defaultValue?: DefaultValue<Date>;
+}
+export interface FloatField extends NonlocalizableField {
+    type: 'float';
+    defaultValue?: DefaultValue<number>;
+    validation?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface IntegerField extends NonlocalizableField {
+    type: 'integer';
+    defaultValue?: DefaultValue<number>;
+    validation?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface DecimalField extends NonlocalizableField {
+    type: 'decimal';
+    defaultValue?: DefaultValue<string>;
+}
+export interface JsonField extends LocalizableField {
+    type: 'json';
+    defaultValue?: DefaultValue<unknown>;
+}
+export interface ObjectField extends LocalizableField {
+    type: 'object';
+    defaultValue?: DefaultValue<Record<string, any>>;
+}
+export interface RelationField extends NonlocalizableField {
+    type: 'relation';
+    /**
+     * The `path` of the target collection (e.g. `'media'` or `'authors'`). The
+     * field picker will query this collection when selecting a reference.
+     */
+    targetCollection: string;
+    /**
+     * Field name from the target collection to display in the picker and inline
+     * summary. Falls back to the first text field if omitted.
+     */
+    displayField?: string;
+}
+export interface FileField extends NonlocalizableField {
+    type: 'file';
+    /**
+     * Per-field upload configuration. When set, this field is upload-capable —
+     * the auto-mounted route at `POST /admin/api/<collection-path>/upload`
+     * accepts `field=<name>` to target it. Carries MIME / size constraints,
+     * variant definitions, storage routing, and `beforeStore` / `afterStore`
+     * hooks.
+     *
+     * @see UploadConfig
+     */
+    upload?: UploadConfig;
+}
+export interface ImageField extends NonlocalizableField {
+    type: 'image';
+    /**
+     * Per-field upload configuration. When set, this field is upload-capable —
+     * the auto-mounted route at `POST /admin/api/<collection-path>/upload`
+     * accepts `field=<name>` to target it. Carries MIME / size constraints,
+     * variant definitions, storage routing, and `beforeStore` / `afterStore`
+     * hooks.
+     *
+     * @see UploadConfig
+     */
+    upload?: UploadConfig;
+}
+export type StructureField = GroupField | ArrayField | BlocksField;
+export type ValueField = TextField | TextAreaField | CheckboxField | BooleanField | SelectField | RichTextField | TimeField | DateField | DateTimeField | FloatField | IntegerField | DecimalField | JsonField | ObjectField | RelationField | FileField | ImageField;
+export type Field = StructureField | ValueField;
+export type FieldSet = readonly Field[];
+export type ValueFieldType = ValueField['type'];
+export type StructureFieldType = StructureField['type'];
+export type FieldType = Field['type'];
+export type LocalizedField = {
+    localized: true;
+};
+export type OptionalField = {
+    optional: true;
+};
+export declare function isStructureField(field: Field): field is StructureField;
+export declare function isArrayField(field: Field): field is ArrayField;
+export declare function isBlocksField(field: Field): field is BlocksField;
+export declare function isGroupField(field: Field): field is GroupField;
+export declare function isValueField(field: Field): field is ValueField;
+/**
+ * A framework-agnostic component type. In practice will be a React
+ * `ComponentType<P>`, but defined here without importing React so that
+ * `@byline/core` stays server-safe.
+ */
+export type SlotComponent<P = Record<string, unknown>> = (props: P) => any;
+/**
+ * Base props passed to every custom slot component.
+ * Slot components also have access to form context via hooks
+ * (`useFieldValue`, `useFieldError`, `useFormContext`, etc.) since
+ * they render inside the `FormProvider`.
+ */
+export interface FieldSlotBaseProps {
+    /** The field definition this slot belongs to. */
+    field: Field;
+    /** Dot-path of the field in the document, e.g. `"content.0.richText"`. */
+    path: string;
+    /** Current field value (snapshot at render time). */
+    value: any;
+    /** Current field error message, if any. */
+    error?: string;
+    /** HTML `id` for the field element (useful for `htmlFor`). */
+    id: string;
+}
+/**
+ * Props passed to a custom **Label** slot component.
+ *
+ * @example
+ * ```tsx
+ * const MyLabel: SlotComponent<FieldLabelSlotProps> = ({ label, required }) => (
+ *   <span>{label}{required && ' *'}</span>
+ * )
+ * ```
+ */
+export interface FieldLabelSlotProps extends FieldSlotBaseProps {
+    /** The label string from the field definition. */
+    label?: string;
+    /** Whether the field is required. */
+    required?: boolean;
+}
+/**
+ * Props passed to a custom **HelpText** slot component.
+ */
+export interface FieldHelpTextSlotProps extends FieldSlotBaseProps {
+    /** The help-text string from the field definition. */
+    helpText?: string;
+}
+/**
+ * Props passed to a custom **Field** (input replacement) slot component.
+ *
+ * When a `Field` slot is provided it **completely replaces** the default
+ * input widget. The component must call `onChange` to commit value changes
+ * back to the form store.
+ */
+export interface FieldInputSlotProps extends FieldSlotBaseProps {
+    /** Call this to write a new value to the form store (runs the hook pipeline). */
+    onChange: (value: any) => void;
+    /** Default value for the field. */
+    defaultValue?: any;
+    /** Placeholder text from the field definition. */
+    placeholder?: string;
+}
+/**
+ * Props passed to **beforeField** / **afterField** adornment slot components.
+ */
+export interface FieldAdornmentSlotProps extends FieldSlotBaseProps {
+}
+/**
+ * Optional UI component overrides that can be attached to any **value field**.
+ *
+ * Each slot receives typed props (see individual `*SlotProps` interfaces) and
+ * can also use form-context hooks for reactive data.
+ *
+ * @example
+ * ```ts
+ * {
+ *   name: 'title',
+ *   type: 'text',
+ *   label: 'Title',
+ *   components: {
+ *     Label: ({ label }) => <h3>{label}</h3>,
+ *     afterField: ({ value }) => (
+ *       <p className="text-xs text-gray-400">{value?.length ?? 0} chars</p>
+ *     ),
+ *   },
+ * }
+ * ```
+ */
+export interface FieldComponentSlots {
+    /**
+     * Replaces the default label. Receives `FieldLabelSlotProps`.
+     * When provided, the built-in `<Label>` is **not** rendered.
+     */
+    Label?: SlotComponent<FieldLabelSlotProps>;
+    /**
+     * Replaces the default help text. Receives `FieldHelpTextSlotProps`.
+     * When provided, the built-in help-text string is **not** rendered.
+     */
+    HelpText?: SlotComponent<FieldHelpTextSlotProps>;
+    /**
+     * Completely replaces the default field input. Receives `FieldInputSlotProps`.
+     * When provided the default `<Input>` (or equivalent) is **not** rendered.
+     */
+    Field?: SlotComponent<FieldInputSlotProps>;
+    /**
+     * Rendered **before** the field input (between the label and the input).
+     * Receives `FieldAdornmentSlotProps`.
+     */
+    beforeField?: SlotComponent<FieldAdornmentSlotProps>;
+    /**
+     * Rendered **after** the field input (between the input and any help text).
+     * Receives `FieldAdornmentSlotProps`.
+     */
+    afterField?: SlotComponent<FieldAdornmentSlotProps>;
+}
+/**
+ * Props passed to a configured richtext editor component. Mirrors the
+ * arguments the field-renderer already supplies for `type: 'richText'`
+ * fields, so an adapter package can satisfy the contract by re-exporting
+ * a thin wrapper around its underlying editor.
+ *
+ * Editor packages (e.g. `@byline/richtext-lexical`) expose a component
+ * matching this shape, and the installation registers it as the
+ * site-wide default via `ClientConfig.fields.richText.editor`.
+ */
+export interface RichTextEditorProps {
+    /** The field definition (label / helpText / optional / hooks / validate). */
+    field: RichTextField;
+    /** Initial value to seed the editor with on first render. */
+    defaultValue?: unknown;
+    /** Commit a new value to the form store (runs the field hook pipeline). */
+    onChange: (value: unknown) => void;
+    /** Dot-path of the field in the document, e.g. `"content.0.body"`. */
+    path: string;
+    /** Stable identity for editor instances; used as a React `key`. */
+    instanceKey: string;
+    /** Active content locale; the editor may render a locale badge if set. */
+    locale?: string;
+}
+/**
+ * Component shape an editor package must export to be plugged in via
+ * `ClientConfig.fields.richText.editor`. Built on `SlotComponent` so the
+ * type stays React-agnostic at the `@byline/core` boundary.
+ */
+export type RichTextEditorComponent = SlotComponent<RichTextEditorProps>;
+/**
+ * Context passed to the richtext populate function for one rich-text field
+ * value. Mirrors the shape consumed by the relation-field populate
+ * primitive — `readContext` is the same request-scoped context, so the
+ * visited set / read budget / `afterReadFired` machinery covers rich-text
+ * fan-out automatically and any nested reads the adapter performs.
+ *
+ * The adapter mutates `value` in place — typically by walking the editor's
+ * node tree and overwriting embedded relation envelopes. The framework
+ * holds the parent reference and reads back the mutated value when
+ * shaping the response.
+ */
+export interface RichTextPopulateContext {
+    /** The richText field's value (raw editor JSON, possibly stringified). */
+    value: unknown;
+    /** Field path within the document — e.g. `'body'` or `'content.0.caption'`. */
+    fieldPath: string;
+    /** Collection path the document belongs to. */
+    collectionPath: string;
+    /**
+     * Shared request-scoped `ReadContext`. Threading is mandatory — adapter
+     * implementations must pass this back into any `client.collection(...)`
+     * read they perform via `_readContext`.
+     */
+    readContext: import('./db-types.js').ReadContext;
+}
+/**
+ * Server-side populate function contract. Editor adapters export an
+ * implementation; installations register one via
+ * `ServerConfig.fields.richText.populate`. Called once per rich-text
+ * leaf the framework discovers in a document, gated by each field's
+ * `populateRelationsOnRead` flag.
+ */
+export type RichTextPopulateFn = (ctx: RichTextPopulateContext) => Promise<void>;
+export {};
+//# sourceMappingURL=field-types.d.ts.map

package/dist/@types/field-types.d.ts.map

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

package/dist/@types/field-types.js

@@ -0,0 +1,32 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * Normalise a hook slot (single function or array) into a flat array.
+ */
+export function normalizeHooks(hook) {
+    if (!hook)
+        return [];
+    return Array.isArray(hook) ? hook : [hook];
+}
+// Type guards for field identification
+export function isStructureField(field) {
+    return ['array', 'blocks', 'group'].includes(field.type);
+}
+export function isArrayField(field) {
+    return field.type === 'array';
+}
+export function isBlocksField(field) {
+    return field.type === 'blocks';
+}
+export function isGroupField(field) {
+    return field.type === 'group';
+}
+export function isValueField(field) {
+    return !isStructureField(field);
+}
+//# sourceMappingURL=field-types.js.map

package/dist/@types/field-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.js","sourceRoot":"","sources":["../../src/@types/field-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4KH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAI,IAAyB;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC5C,CAAC;AAybD,uCAAuC;AACvC,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC"}