@wp-typia/block-types 0.3.1 → 0.3.2

package/dist/blocks/bindings-core.d.ts

@@ -1,6 +1,8 @@
 import type { BlockAttributes } from "./registration.js";
 import { type WordPressBlockApiCompatibilityDiagnostic, type WordPressBlockApiCompatibilityFeature, type WordPressBlockApiCompatibilityManifest, type WordPressCompatibilitySettings, type WordPressVersion } from "./compatibility.js";
 import { type DiagnosticLogger } from "./shared/diagnostics.js";
+import { collectBindingSourceCompatibilityFeatures, createBindingSourceCompatibilityManifest } from "./bindings-manifest.js";
+export { collectBindingSourceCompatibilityFeatures, createBindingSourceCompatibilityManifest, };
 export type BindingSourceName = `${string}/${string}`;
 export type BindingSourceArgs = Readonly<Record<string, unknown>>;
 export type BindingFieldType = "array" | "boolean" | "integer" | "number" | "object" | "string";
@@ -101,14 +103,6 @@ export interface BindingSourceRegistrationEntry {
     readonly metadata: DefinedBlockBindingSourceMetadata;
     readonly source: DefinedBindingSource;
 }
-export declare function collectBindingSourceCompatibilityFeatures(settings?: {
-    readonly editor?: boolean;
-    readonly fieldsList?: boolean;
-    readonly metadata?: boolean;
-    readonly server?: boolean;
-    readonly supportedAttributesFilter?: boolean;
-}): readonly WordPressBlockApiCompatibilityFeature[];
-export declare function createBindingSourceCompatibilityManifest(settings?: DefineBindingSourceOptions): WordPressBlockApiCompatibilityManifest;
 export declare function getDefinedBindingSourceMetadata(source: unknown): DefinedBlockBindingSourceMetadata | undefined;
 export declare function getDefinedBindingSourceCompatibilityManifest(source: unknown): WordPressBlockApiCompatibilityManifest | undefined;
 export declare function defineBindingSource<const TSource extends BindingSourceDefinition & DefineBindingSourceInlineOptions>(source: TSource, options?: DefineBindingSourceOptions): DefinedBindingSource<Extract<TSource["name"], string>, TSource extends {
@@ -120,4 +114,3 @@ export declare function defineBindableAttributes<TAttributes extends BlockAttrib
 export declare function defineBlockMetadataBindings<const TBindings extends Readonly<Record<string, BlockBinding | undefined>>>(bindings: TBindings): BlockMetadataBindings<TBindings>;
 export declare function defineTypedBlockMetadataBindings<TAttributes extends BlockAttributes, const TBindings extends BlockBindingMap<TAttributes> = BlockBindingMap<TAttributes>>(bindings: TBindings): TypedBlockMetadataBindings<TAttributes, TBindings>;
 export declare function createBindingSourceRegistrationPlan(sources: readonly DefinedBindingSource[]): readonly BindingSourceRegistrationEntry[];
-export {};

package/dist/blocks/bindings-core.js

@@ -1,295 +1,9 @@
-import { DEFAULT_WORDPRESS_COMPATIBILITY_MIN_VERSION, evaluateWordPressBlockApiCompatibility, } from "./compatibility.js";
-import { getDiagnosticSeverity, handleDiagnostics, } from "./shared/diagnostics.js";
 import { isObjectRecord } from "./shared/object-utils.js";
+import { createBindingSourceDiagnostics, handleBindingSourceDiagnostics, } from "./bindings-diagnostics.js";
+import { collectBindingSourceCompatibilityFeatures, createBindingCompatibilityManifest, createBindingSourceCompatibilityManifest, } from "./bindings-manifest.js";
+import { resolveDefineBindingSourceSettings, splitDefineBindingSourceInput, } from "./bindings-settings.js";
+export { collectBindingSourceCompatibilityFeatures, createBindingSourceCompatibilityManifest, };
 export const DEFINED_BLOCK_BINDING_SOURCE_METADATA = Symbol.for("@wp-typia/block-types/defined-binding-source");
-const DEFINE_BINDING_SOURCE_INLINE_OPTION_KEYS = new Set([
-    "allowUnknownFutureKeys",
-    "editor",
-    "fieldsList",
-    "logger",
-    "minVersion",
-    "minWordPress",
-    "minWordPressEditor",
-    "minWordPressFieldsList",
-    "minWordPressServer",
-    "minWordPressSupportedAttributesFilter",
-    "onDiagnostic",
-    "server",
-    "strict",
-    "supportedAttributesFilter",
-]);
-const SOURCE_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u;
-const FIELD_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*$/u;
-function isBindingSourceVersionGates(value) {
-    return isObjectRecord(value);
-}
-function splitDefineBindingSourceInput(source) {
-    const inlineOptions = {};
-    const normalizedSource = {};
-    for (const [key, value] of Object.entries(source)) {
-        if (DEFINE_BINDING_SOURCE_INLINE_OPTION_KEYS.has(key)) {
-            Object.assign(inlineOptions, { [key]: value });
-            continue;
-        }
-        normalizedSource[key] = value;
-    }
-    return {
-        inlineOptions,
-        source: normalizedSource,
-    };
-}
-function resolveMinWordPress(inlineOptions, options) {
-    const optionMinWordPress = options.minWordPress;
-    const inlineMinWordPress = inlineOptions.minWordPress;
-    const optionGates = isBindingSourceVersionGates(optionMinWordPress)
-        ? optionMinWordPress
-        : {};
-    const inlineGates = isBindingSourceVersionGates(inlineMinWordPress)
-        ? inlineMinWordPress
-        : {};
-    const minVersion = options.minVersion ??
-        (typeof optionMinWordPress === "string" ? optionMinWordPress : undefined) ??
-        inlineOptions.minVersion ??
-        (typeof inlineMinWordPress === "string" ? inlineMinWordPress : undefined);
-    const compatibility = {
-        strict: options.strict ?? inlineOptions.strict ?? true,
-    };
-    if (options.allowUnknownFutureKeys ?? inlineOptions.allowUnknownFutureKeys) {
-        Object.assign(compatibility, {
-            allowUnknownFutureKeys: options.allowUnknownFutureKeys ?? inlineOptions.allowUnknownFutureKeys,
-        });
-    }
-    if (minVersion !== undefined) {
-        Object.assign(compatibility, { minVersion });
-    }
-    const gates = {};
-    const editor = options.minWordPressEditor ??
-        optionGates.editor ??
-        inlineOptions.minWordPressEditor ??
-        inlineGates.editor;
-    const fieldsList = options.minWordPressFieldsList ??
-        optionGates.fieldsList ??
-        inlineOptions.minWordPressFieldsList ??
-        inlineGates.fieldsList;
-    const server = options.minWordPressServer ??
-        optionGates.server ??
-        inlineOptions.minWordPressServer ??
-        inlineGates.server;
-    const supportedAttributesFilter = options.minWordPressSupportedAttributesFilter ??
-        optionGates.supportedAttributesFilter ??
-        inlineOptions.minWordPressSupportedAttributesFilter ??
-        inlineGates.supportedAttributesFilter;
-    if (editor !== undefined) {
-        Object.assign(gates, { editor });
-    }
-    if (fieldsList !== undefined) {
-        Object.assign(gates, { fieldsList });
-    }
-    if (server !== undefined) {
-        Object.assign(gates, { server });
-    }
-    if (supportedAttributesFilter !== undefined) {
-        Object.assign(gates, { supportedAttributesFilter });
-    }
-    return {
-        compatibility,
-        gates,
-    };
-}
-function resolveDefineBindingSourceSettings(inlineOptions, options, source) {
-    const { compatibility, gates } = resolveMinWordPress(inlineOptions, options);
-    const strict = compatibility.strict ?? true;
-    const hasFields = (source.fields?.length ?? 0) > 0;
-    const hasBindableAttributes = (source.bindableAttributes?.length ?? 0) > 0;
-    return {
-        compatibility,
-        features: {
-            editor: options.editor ?? inlineOptions.editor ?? true,
-            fieldsList: options.fieldsList ?? inlineOptions.fieldsList ?? hasFields,
-            metadata: true,
-            server: options.server ?? inlineOptions.server ?? true,
-            supportedAttributesFilter: options.supportedAttributesFilter ??
-                inlineOptions.supportedAttributesFilter ??
-                hasBindableAttributes,
-        },
-        gates,
-        logger: options.logger ?? inlineOptions.logger,
-        onDiagnostic: options.onDiagnostic ?? inlineOptions.onDiagnostic,
-        strict,
-    };
-}
-function getFeatureMinVersion(feature, fallback, gates) {
-    if (feature.area !== "blockBindings") {
-        return fallback;
-    }
-    switch (feature.feature) {
-        case "metadata.bindings":
-        case "serverRegistration":
-            return gates.server ?? fallback;
-        case "editorFieldsList":
-            return gates.fieldsList ?? fallback;
-        case "editorRegistration":
-        case "editorSourceLookup":
-            return gates.editor ?? fallback;
-        case "supportedAttributesFilter":
-            return gates.supportedAttributesFilter ?? gates.fieldsList ?? fallback;
-        default:
-            return fallback;
-    }
-}
-function createBindingCompatibilityManifest(features, settings, gates) {
-    const fallback = settings.minVersion ?? DEFAULT_WORDPRESS_COMPATIBILITY_MIN_VERSION;
-    const strict = settings.strict ?? true;
-    const allowUnknownFutureKeys = settings.allowUnknownFutureKeys ?? false;
-    const evaluations = features.map((feature) => evaluateWordPressBlockApiCompatibility(feature, {
-        allowUnknownFutureKeys,
-        minVersion: getFeatureMinVersion(feature, fallback, gates),
-        strict,
-    }));
-    const diagnostics = evaluations.flatMap((evaluation) => evaluation.diagnostic ? [evaluation.diagnostic] : []);
-    return {
-        allowUnknownFutureKeys,
-        diagnostics,
-        evaluations,
-        minVersion: fallback,
-        strict,
-        supported: evaluations.filter((evaluation) => evaluation.status === "supported"),
-        unknown: evaluations.filter((evaluation) => evaluation.status === "unknown"),
-        unsupported: evaluations.filter((evaluation) => evaluation.status === "unsupported"),
-    };
-}
-export function collectBindingSourceCompatibilityFeatures(settings = {}) {
-    const features = [];
-    if (settings.metadata ?? true) {
-        features.push({
-            area: "blockBindings",
-            feature: "metadata.bindings",
-        });
-    }
-    if (settings.server ?? true) {
-        features.push({
-            area: "blockBindings",
-            feature: "serverRegistration",
-        });
-    }
-    if (settings.editor ?? true) {
-        features.push({
-            area: "blockBindings",
-            feature: "editorRegistration",
-        });
-    }
-    if (settings.fieldsList ?? false) {
-        features.push({
-            area: "blockBindings",
-            feature: "editorFieldsList",
-        });
-    }
-    if (settings.supportedAttributesFilter ?? false) {
-        features.push({
-            area: "blockBindings",
-            feature: "supportedAttributesFilter",
-        });
-    }
-    return features;
-}
-export function createBindingSourceCompatibilityManifest(settings = {}) {
-    const resolved = resolveDefineBindingSourceSettings({}, settings, {
-        name: "wp-typia/binding-source",
-    });
-    return createBindingCompatibilityManifest(collectBindingSourceCompatibilityFeatures(resolved.features), resolved.compatibility, resolved.gates);
-}
-function createBindingSourceDiagnostics(source, options) {
-    const diagnostics = [];
-    const severity = getDiagnosticSeverity(options.strict);
-    if (!SOURCE_NAME_PATTERN.test(source.name)) {
-        diagnostics.push({
-            code: "invalid-source-name",
-            message: `Block binding source "${source.name}" must be lowercase and namespaced, such as "acme/profile-data".`,
-            severity,
-            sourceName: source.name,
-        });
-    }
-    if (options.server && !source.getValueCallback) {
-        diagnostics.push({
-            code: "missing-php-callback",
-            message: `Block binding source "${source.name}" needs getValueCallback when server registration is enabled.`,
-            severity,
-            sourceName: source.name,
-        });
-    }
-    if (options.fieldsList && !options.editor) {
-        diagnostics.push({
-            code: "fields-list-requires-editor",
-            message: `Block binding source "${source.name}" enables getFieldsList() without editor registration.`,
-            severity,
-            sourceName: source.name,
-        });
-    }
-    const seenFields = new Set();
-    for (const field of source.fields ?? []) {
-        if (!FIELD_NAME_PATTERN.test(field.name)) {
-            diagnostics.push({
-                code: "invalid-field-name",
-                fieldName: field.name,
-                message: `Block binding source "${source.name}" field "${field.name}" must be a stable identifier.`,
-                severity,
-                sourceName: source.name,
-            });
-        }
-        if (seenFields.has(field.name)) {
-            diagnostics.push({
-                code: "duplicate-field-name",
-                fieldName: field.name,
-                message: `Block binding source "${source.name}" declares duplicate field "${field.name}".`,
-                severity,
-                sourceName: source.name,
-            });
-        }
-        seenFields.add(field.name);
-    }
-    for (const target of source.bindableAttributes ?? []) {
-        if (!SOURCE_NAME_PATTERN.test(target.blockName)) {
-            diagnostics.push({
-                blockName: target.blockName,
-                code: "invalid-block-name",
-                message: `Bindable attributes target "${target.blockName}" must be a lowercase namespaced block name.`,
-                severity,
-                sourceName: source.name,
-            });
-        }
-        const seenAttributes = new Set();
-        for (const attribute of target.attributes) {
-            if (!FIELD_NAME_PATTERN.test(attribute)) {
-                diagnostics.push({
-                    attribute,
-                    blockName: target.blockName,
-                    code: "invalid-bindable-attribute",
-                    message: `Bindable attribute "${attribute}" for "${target.blockName}" must be a stable identifier.`,
-                    severity,
-                    sourceName: source.name,
-                });
-            }
-            if (seenAttributes.has(attribute)) {
-                diagnostics.push({
-                    attribute,
-                    blockName: target.blockName,
-                    code: "duplicate-bindable-attribute",
-                    message: `Bindable attribute "${attribute}" for "${target.blockName}" is declared more than once.`,
-                    severity,
-                    sourceName: source.name,
-                });
-            }
-            seenAttributes.add(attribute);
-        }
-    }
-    return diagnostics;
-}
-function handleBindingSourceDiagnostics(diagnostics, onDiagnostic, logger) {
-    handleDiagnostics(diagnostics, onDiagnostic, {
-        failureHeading: "WordPress block binding source check failed:",
-        logger,
-    });
-}
 export function getDefinedBindingSourceMetadata(source) {
     return isObjectRecord(source)
         ? source[DEFINED_BLOCK_BINDING_SOURCE_METADATA]

package/dist/blocks/bindings-diagnostics.d.ts

@@ -0,0 +1,8 @@
+import type { BindingSourceAuthoringDiagnostic, BindingSourceDefinition, BindingSourceDiagnostic, DefineBindingSourceOptions } from "./bindings-core.js";
+export declare function createBindingSourceDiagnostics(source: BindingSourceDefinition, options: {
+    readonly editor: boolean;
+    readonly fieldsList: boolean;
+    readonly server: boolean;
+    readonly strict: boolean;
+}): readonly BindingSourceAuthoringDiagnostic[];
+export declare function handleBindingSourceDiagnostics(diagnostics: readonly BindingSourceDiagnostic[], onDiagnostic: DefineBindingSourceOptions["onDiagnostic"], logger: DefineBindingSourceOptions["logger"]): void;

package/dist/blocks/bindings-diagnostics.js

@@ -0,0 +1,95 @@
+import { getDiagnosticSeverity, handleDiagnostics } from "./shared/diagnostics.js";
+const SOURCE_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u;
+const FIELD_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*$/u;
+export function createBindingSourceDiagnostics(source, options) {
+    const diagnostics = [];
+    const severity = getDiagnosticSeverity(options.strict);
+    if (!SOURCE_NAME_PATTERN.test(source.name)) {
+        diagnostics.push({
+            code: "invalid-source-name",
+            message: `Block binding source "${source.name}" must be lowercase and namespaced, such as "acme/profile-data".`,
+            severity,
+            sourceName: source.name,
+        });
+    }
+    if (options.server && !source.getValueCallback) {
+        diagnostics.push({
+            code: "missing-php-callback",
+            message: `Block binding source "${source.name}" needs getValueCallback when server registration is enabled.`,
+            severity,
+            sourceName: source.name,
+        });
+    }
+    if (options.fieldsList && !options.editor) {
+        diagnostics.push({
+            code: "fields-list-requires-editor",
+            message: `Block binding source "${source.name}" enables getFieldsList() without editor registration.`,
+            severity,
+            sourceName: source.name,
+        });
+    }
+    const seenFields = new Set();
+    for (const field of source.fields ?? []) {
+        if (!FIELD_NAME_PATTERN.test(field.name)) {
+            diagnostics.push({
+                code: "invalid-field-name",
+                fieldName: field.name,
+                message: `Block binding source "${source.name}" field "${field.name}" must be a stable identifier.`,
+                severity,
+                sourceName: source.name,
+            });
+        }
+        if (seenFields.has(field.name)) {
+            diagnostics.push({
+                code: "duplicate-field-name",
+                fieldName: field.name,
+                message: `Block binding source "${source.name}" declares duplicate field "${field.name}".`,
+                severity,
+                sourceName: source.name,
+            });
+        }
+        seenFields.add(field.name);
+    }
+    for (const target of source.bindableAttributes ?? []) {
+        if (!SOURCE_NAME_PATTERN.test(target.blockName)) {
+            diagnostics.push({
+                blockName: target.blockName,
+                code: "invalid-block-name",
+                message: `Bindable attributes target "${target.blockName}" must be a lowercase namespaced block name.`,
+                severity,
+                sourceName: source.name,
+            });
+        }
+        const seenAttributes = new Set();
+        for (const attribute of target.attributes) {
+            if (!FIELD_NAME_PATTERN.test(attribute)) {
+                diagnostics.push({
+                    attribute,
+                    blockName: target.blockName,
+                    code: "invalid-bindable-attribute",
+                    message: `Bindable attribute "${attribute}" for "${target.blockName}" must be a stable identifier.`,
+                    severity,
+                    sourceName: source.name,
+                });
+            }
+            if (seenAttributes.has(attribute)) {
+                diagnostics.push({
+                    attribute,
+                    blockName: target.blockName,
+                    code: "duplicate-bindable-attribute",
+                    message: `Bindable attribute "${attribute}" for "${target.blockName}" is declared more than once.`,
+                    severity,
+                    sourceName: source.name,
+                });
+            }
+            seenAttributes.add(attribute);
+        }
+    }
+    return diagnostics;
+}
+export function handleBindingSourceDiagnostics(diagnostics, onDiagnostic, logger) {
+    handleDiagnostics(diagnostics, onDiagnostic, {
+        failureHeading: "WordPress block binding source check failed:",
+        logger,
+    });
+}

package/dist/blocks/bindings-manifest.d.ts

@@ -0,0 +1,12 @@
+import { type WordPressBlockApiCompatibilityFeature, type WordPressBlockApiCompatibilityManifest, type WordPressCompatibilitySettings } from "./compatibility.js";
+import type { BindingSourceVersionGates, DefineBindingSourceOptions } from "./bindings-core.js";
+export interface BindingSourceCompatibilityFeatureSettings {
+    readonly editor?: boolean;
+    readonly fieldsList?: boolean;
+    readonly metadata?: boolean;
+    readonly server?: boolean;
+    readonly supportedAttributesFilter?: boolean;
+}
+export declare function createBindingCompatibilityManifest(features: readonly WordPressBlockApiCompatibilityFeature[], settings: WordPressCompatibilitySettings, gates: BindingSourceVersionGates): WordPressBlockApiCompatibilityManifest;
+export declare function collectBindingSourceCompatibilityFeatures(settings?: BindingSourceCompatibilityFeatureSettings): readonly WordPressBlockApiCompatibilityFeature[];
+export declare function createBindingSourceCompatibilityManifest(settings?: DefineBindingSourceOptions): WordPressBlockApiCompatibilityManifest;

package/dist/blocks/bindings-manifest.js

@@ -0,0 +1,82 @@
+import { DEFAULT_WORDPRESS_COMPATIBILITY_MIN_VERSION, evaluateWordPressBlockApiCompatibility, } from "./compatibility.js";
+import { resolveDefineBindingSourceSettings } from "./bindings-settings.js";
+function getFeatureMinVersion(feature, fallback, gates) {
+    if (feature.area !== "blockBindings") {
+        return fallback;
+    }
+    switch (feature.feature) {
+        case "metadata.bindings":
+        case "serverRegistration":
+            return gates.server ?? fallback;
+        case "editorFieldsList":
+            return gates.fieldsList ?? fallback;
+        case "editorRegistration":
+        case "editorSourceLookup":
+            return gates.editor ?? fallback;
+        case "supportedAttributesFilter":
+            return gates.supportedAttributesFilter ?? gates.fieldsList ?? fallback;
+        default:
+            return fallback;
+    }
+}
+export function createBindingCompatibilityManifest(features, settings, gates) {
+    const fallback = settings.minVersion ?? DEFAULT_WORDPRESS_COMPATIBILITY_MIN_VERSION;
+    const strict = settings.strict ?? true;
+    const allowUnknownFutureKeys = settings.allowUnknownFutureKeys ?? false;
+    const evaluations = features.map((feature) => evaluateWordPressBlockApiCompatibility(feature, {
+        allowUnknownFutureKeys,
+        minVersion: getFeatureMinVersion(feature, fallback, gates),
+        strict,
+    }));
+    const diagnostics = evaluations.flatMap((evaluation) => evaluation.diagnostic ? [evaluation.diagnostic] : []);
+    return {
+        allowUnknownFutureKeys,
+        diagnostics,
+        evaluations,
+        minVersion: fallback,
+        strict,
+        supported: evaluations.filter((evaluation) => evaluation.status === "supported"),
+        unknown: evaluations.filter((evaluation) => evaluation.status === "unknown"),
+        unsupported: evaluations.filter((evaluation) => evaluation.status === "unsupported"),
+    };
+}
+export function collectBindingSourceCompatibilityFeatures(settings = {}) {
+    const features = [];
+    if (settings.metadata ?? true) {
+        features.push({
+            area: "blockBindings",
+            feature: "metadata.bindings",
+        });
+    }
+    if (settings.server ?? true) {
+        features.push({
+            area: "blockBindings",
+            feature: "serverRegistration",
+        });
+    }
+    if (settings.editor ?? true) {
+        features.push({
+            area: "blockBindings",
+            feature: "editorRegistration",
+        });
+    }
+    if (settings.fieldsList ?? false) {
+        features.push({
+            area: "blockBindings",
+            feature: "editorFieldsList",
+        });
+    }
+    if (settings.supportedAttributesFilter ?? false) {
+        features.push({
+            area: "blockBindings",
+            feature: "supportedAttributesFilter",
+        });
+    }
+    return features;
+}
+export function createBindingSourceCompatibilityManifest(settings = {}) {
+    const resolved = resolveDefineBindingSourceSettings({}, settings, {
+        name: "wp-typia/binding-source",
+    });
+    return createBindingCompatibilityManifest(collectBindingSourceCompatibilityFeatures(resolved.features), resolved.compatibility, resolved.gates);
+}

package/dist/blocks/bindings-settings.d.ts

@@ -0,0 +1,27 @@
+import type { WordPressCompatibilitySettings, WordPressVersion } from "./compatibility.js";
+import type { BindingSourceDefinition, BindingSourceVersionGates, DefineBindingSourceInlineOptions, DefineBindingSourceOptions, StripDefineBindingSourceOptions } from "./bindings-core.js";
+export declare const DEFINE_BINDING_SOURCE_INLINE_OPTION_KEYS: Set<string>;
+export interface ResolvedDefineBindingSourceSettings {
+    readonly compatibility: WordPressCompatibilitySettings;
+    readonly features: {
+        readonly editor: boolean;
+        readonly fieldsList: boolean;
+        readonly metadata: boolean;
+        readonly server: boolean;
+        readonly supportedAttributesFilter: boolean;
+    };
+    readonly gates: BindingSourceVersionGates;
+    readonly logger: DefineBindingSourceOptions["logger"];
+    readonly onDiagnostic: DefineBindingSourceOptions["onDiagnostic"];
+    readonly strict: boolean;
+}
+export declare function isBindingSourceVersionGates(value: WordPressVersion | BindingSourceVersionGates | undefined): value is BindingSourceVersionGates;
+export declare function splitDefineBindingSourceInput<TSource extends BindingSourceDefinition & DefineBindingSourceInlineOptions>(source: TSource): {
+    inlineOptions: DefineBindingSourceInlineOptions;
+    source: StripDefineBindingSourceOptions<TSource> & BindingSourceDefinition;
+};
+export declare function resolveMinWordPress(inlineOptions: DefineBindingSourceInlineOptions, options: DefineBindingSourceOptions): {
+    compatibility: WordPressCompatibilitySettings;
+    gates: BindingSourceVersionGates;
+};
+export declare function resolveDefineBindingSourceSettings(inlineOptions: DefineBindingSourceInlineOptions, options: DefineBindingSourceOptions, source: BindingSourceDefinition): ResolvedDefineBindingSourceSettings;

package/dist/blocks/bindings-settings.js

@@ -0,0 +1,115 @@
+import { isObjectRecord } from "./shared/object-utils.js";
+export const DEFINE_BINDING_SOURCE_INLINE_OPTION_KEYS = new Set([
+    "allowUnknownFutureKeys",
+    "editor",
+    "fieldsList",
+    "logger",
+    "minVersion",
+    "minWordPress",
+    "minWordPressEditor",
+    "minWordPressFieldsList",
+    "minWordPressServer",
+    "minWordPressSupportedAttributesFilter",
+    "onDiagnostic",
+    "server",
+    "strict",
+    "supportedAttributesFilter",
+]);
+export function isBindingSourceVersionGates(value) {
+    return isObjectRecord(value);
+}
+export function splitDefineBindingSourceInput(source) {
+    const inlineOptions = {};
+    const normalizedSource = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (DEFINE_BINDING_SOURCE_INLINE_OPTION_KEYS.has(key)) {
+            Object.assign(inlineOptions, { [key]: value });
+            continue;
+        }
+        normalizedSource[key] = value;
+    }
+    return {
+        inlineOptions,
+        source: normalizedSource,
+    };
+}
+export function resolveMinWordPress(inlineOptions, options) {
+    const optionMinWordPress = options.minWordPress;
+    const inlineMinWordPress = inlineOptions.minWordPress;
+    const optionGates = isBindingSourceVersionGates(optionMinWordPress)
+        ? optionMinWordPress
+        : {};
+    const inlineGates = isBindingSourceVersionGates(inlineMinWordPress)
+        ? inlineMinWordPress
+        : {};
+    const minVersion = options.minVersion ??
+        (typeof optionMinWordPress === "string" ? optionMinWordPress : undefined) ??
+        inlineOptions.minVersion ??
+        (typeof inlineMinWordPress === "string" ? inlineMinWordPress : undefined);
+    const compatibility = {
+        strict: options.strict ?? inlineOptions.strict ?? true,
+    };
+    if (options.allowUnknownFutureKeys ?? inlineOptions.allowUnknownFutureKeys) {
+        Object.assign(compatibility, {
+            allowUnknownFutureKeys: options.allowUnknownFutureKeys ?? inlineOptions.allowUnknownFutureKeys,
+        });
+    }
+    if (minVersion !== undefined) {
+        Object.assign(compatibility, { minVersion });
+    }
+    const gates = {};
+    const editor = options.minWordPressEditor ??
+        optionGates.editor ??
+        inlineOptions.minWordPressEditor ??
+        inlineGates.editor;
+    const fieldsList = options.minWordPressFieldsList ??
+        optionGates.fieldsList ??
+        inlineOptions.minWordPressFieldsList ??
+        inlineGates.fieldsList;
+    const server = options.minWordPressServer ??
+        optionGates.server ??
+        inlineOptions.minWordPressServer ??
+        inlineGates.server;
+    const supportedAttributesFilter = options.minWordPressSupportedAttributesFilter ??
+        optionGates.supportedAttributesFilter ??
+        inlineOptions.minWordPressSupportedAttributesFilter ??
+        inlineGates.supportedAttributesFilter;
+    if (editor !== undefined) {
+        Object.assign(gates, { editor });
+    }
+    if (fieldsList !== undefined) {
+        Object.assign(gates, { fieldsList });
+    }
+    if (server !== undefined) {
+        Object.assign(gates, { server });
+    }
+    if (supportedAttributesFilter !== undefined) {
+        Object.assign(gates, { supportedAttributesFilter });
+    }
+    return {
+        compatibility,
+        gates,
+    };
+}
+export function resolveDefineBindingSourceSettings(inlineOptions, options, source) {
+    const { compatibility, gates } = resolveMinWordPress(inlineOptions, options);
+    const strict = compatibility.strict ?? true;
+    const hasFields = (source.fields?.length ?? 0) > 0;
+    const hasBindableAttributes = (source.bindableAttributes?.length ?? 0) > 0;
+    return {
+        compatibility,
+        features: {
+            editor: options.editor ?? inlineOptions.editor ?? true,
+            fieldsList: options.fieldsList ?? inlineOptions.fieldsList ?? hasFields,
+            metadata: true,
+            server: options.server ?? inlineOptions.server ?? true,
+            supportedAttributesFilter: options.supportedAttributesFilter ??
+                inlineOptions.supportedAttributesFilter ??
+                hasBindableAttributes,
+        },
+        gates,
+        logger: options.logger ?? inlineOptions.logger,
+        onDiagnostic: options.onDiagnostic ?? inlineOptions.onDiagnostic,
+        strict,
+    };
+}

package/dist/blocks/supports-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { WordPressBlockApiCompatibilityDiagnostic } from "./compatibility.js";
+import type { DefineSupportsOptions } from "./supports.js";
+export declare function handleDefineSupportsDiagnostics(diagnostics: readonly WordPressBlockApiCompatibilityDiagnostic[], onDiagnostic: DefineSupportsOptions["onDiagnostic"], logger: DefineSupportsOptions["logger"]): void;