@plaudit/gutenberg-api-extensions 2.43.1 → 2.44.0

package/build/blocks/MoveError.d.ts

@@ -0,0 +1,10 @@
+import type { RawPath } from "./simple-native-property-api";
+export declare class MoveError extends Error {
+    constructor(message: string, path: RawPath, { from, to }: {
+        from: number;
+        to: number;
+    } | {
+        from: string;
+        to: string;
+    });
+}

package/build/blocks/MoveError.js

@@ -0,0 +1,6 @@
+export class MoveError extends Error {
+    constructor(message, path, { from, to }) {
+        super(`${message}: ${path.join(".")}.{${from} => ${to}}`);
+    }
+}
+//# sourceMappingURL=MoveError.js.map

package/build/blocks/MoveError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoveError.js","sourceRoot":"","sources":["../../src/blocks/MoveError.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE,IAAa,EAAE,EAAC,IAAI,EAAE,EAAE,EAAwD;QAC5G,KAAK,CAAC,GAAG,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;CACD"}

package/build/blocks/PathError.d.ts

@@ -0,0 +1,12 @@
+import type { RawPath } from "./simple-native-property-api";
+export declare enum PathErrorType {
+    UNKNOWN = 0,
+    UNEXPECTED_LEAF = 1,
+    INSUFFICIENT_LENGTH = 2
+}
+export declare class PathError extends Error {
+    readonly path: RawPath;
+    readonly errorIndex: number;
+    readonly errorType: PathErrorType;
+    constructor(message: string, path: RawPath, errorIndex?: number, errorType?: PathErrorType);
+}

package/build/blocks/PathError.js

@@ -0,0 +1,18 @@
+export var PathErrorType;
+(function (PathErrorType) {
+    PathErrorType[PathErrorType["UNKNOWN"] = 0] = "UNKNOWN";
+    PathErrorType[PathErrorType["UNEXPECTED_LEAF"] = 1] = "UNEXPECTED_LEAF";
+    PathErrorType[PathErrorType["INSUFFICIENT_LENGTH"] = 2] = "INSUFFICIENT_LENGTH";
+})(PathErrorType || (PathErrorType = {}));
+export class PathError extends Error {
+    path;
+    errorIndex;
+    errorType;
+    constructor(message, path, errorIndex = path.length - 1, errorType = PathErrorType.UNKNOWN) {
+        super(`${message} Full Path: ${path.join('.')}; Error Path: ${path.slice(0, errorIndex + 1).join('.')}`);
+        this.path = path;
+        this.errorIndex = errorIndex;
+        this.errorType = errorType;
+    }
+}
+//# sourceMappingURL=PathError.js.map

package/build/blocks/PathError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathError.js","sourceRoot":"","sources":["../../src/blocks/PathError.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACxB,uDAAO,CAAA;IACP,uEAAe,CAAA;IACf,+EAAmB,CAAA;AACpB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGlB;IACA;IACA;IAJjB,YACC,OAAe,EACC,IAAa,EACb,aAAqB,IAAI,CAAC,MAAM,GAAG,CAAC,EACpC,YAAY,aAAa,CAAC,OAAO;QAEjD,KAAK,CAAC,GAAG,OAAO,eAAe,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAJzF,SAAI,GAAJ,IAAI,CAAS;QACb,eAAU,GAAV,UAAU,CAA0B;QACpC,cAAS,GAAT,SAAS,CAAwB;IAGlD,CAAC;CACD"}

package/build/blocks/{snp-group-component.d.ts → SNPGroupComponent.d.ts}

@@ -1,10 +1,9 @@
-import type { Dict } from "../controls";
 import type { GroupPropertyConfig } from "./common-native-property-constructors";
+import type { Dict } from "../controls";
 import type { CSNPControlComponentProps } from "./shared-internal-types";
-import type { DataStore, SimpleNativeProperty } from "./simple-native-property-api";
-import React from "react";
+import type { SNPControlSlots } from "./simple-native-property-api";
+import type { HydratedLaidOutProperties } from "./simple-native-property-internal-shared";
 export type SNPGroupComponentProps = CSNPControlComponentProps<GroupPropertyConfig, Dict<any>, {
-    hydratedProperties: SimpleNativeProperty[];
-    parentDataStore: DataStore;
-}>;
-export declare function SNPGroupComponent({ config, hydratedProperties, onChange, parentDataStore, value }: SNPGroupComponentProps): React.JSX.Element;
+    hydratedProperties: HydratedLaidOutProperties;
+}> & SNPControlSlots;
+export declare function SNPGroupComponent({ config, hydratedProperties, Label, Messages }: SNPGroupComponentProps): import("react/jsx-runtime").JSX.Element;

package/build/blocks/SNPGroupComponent.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { LaidOutPropertyRow } from "./layout/LaidOutPropertyRow";
+export function SNPGroupComponent({ config, hydratedProperties, Label, Messages }) {
+    return _jsxs("fieldset", { ...config.component, className: config.component?.className ? `plaudit-snp-group-component ${config.component.className}` : "plaudit-snp-group-component", children: [_jsx("legend", { children: _jsx(Label, {}) }), ...hydratedProperties.map(property => _jsx(LaidOutPropertyRow, { property: property })), _jsx(Messages, {})] });
+}
+//# sourceMappingURL=SNPGroupComponent.js.map

package/build/blocks/SNPGroupComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SNPGroupComponent.js","sourceRoot":"","sources":["../../src/blocks/SNPGroupComponent.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAU/D,MAAM,UAAU,iBAAiB,CAAC,EAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAyB;IACtG,OAAO,uBAAc,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,+BAA+B,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,6BAA6B,aAC1K,2BAAQ,KAAC,KAAK,KAAG,GAAS,KACtB,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAC,kBAAkB,IAAC,QAAQ,EAAE,QAAQ,GAAI,CAAC,EAClF,KAAC,QAAQ,KAAG,IACF,CAAC;AACb,CAAC"}

package/build/blocks/SNPListComponent.d.ts

@@ -0,0 +1,8 @@
+import type { ObjectListPropertyConfig } from "./common-native-property-constructors";
+import { type Dict } from "../controls";
+import type { CSNPControlComponentProps } from "./shared-internal-types";
+import type { HydratedSimpleNativeProperty, SNPControlSlots } from "./simple-native-property-api";
+export type SNPListComponentProps = CSNPControlComponentProps<ObjectListPropertyConfig, Dict<any>[], {
+    hydratedProperties: (HydratedSimpleNativeProperty | HydratedSimpleNativeProperty[])[];
+}> & SNPControlSlots;
+export declare function SNPListComponent({ config, hydratedProperties, value, Label, Messages }: SNPListComponentProps): import("react/jsx-runtime").JSX.Element;

package/build/blocks/SNPListComponent.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from "@wordpress/element";
+import { SortableItemsControl } from "../controls";
+import { LaidOutPropertyRow } from "./layout/LaidOutPropertyRow";
+import { NodeContextWrapper, useNodeContext } from "./layout/NodeContext";
+export function SNPListComponent({ config, hydratedProperties, value, Label, Messages }) {
+    const context = useNodeContext("build a SNP List");
+    const onReorder = useCallback((oldIndex, newIndex) => context.moveNode({ from: oldIndex, to: newIndex }), [context]);
+    const emptyValue = useMemo(() => config.emptyValue ?? {}, [config.emptyValue]);
+    const childRenderer = useCallback((datum, onDatumChange, index) => {
+        return _jsx(NodeContextWrapper, { nodeName: index, children: hydratedProperties.map(property => _jsx(LaidOutPropertyRow, { property: property })) });
+    }, [hydratedProperties]);
+    return _jsx(SortableItemsControl, { value: value, min: config.min, max: config.max, Label: Label, Messages: Messages, help: config.help, emptyValue: emptyValue, ...config.component, onAdd: context.addNode, onRemove: context.removeNode, onReorder: onReorder, children: childRenderer });
+}
+//# sourceMappingURL=SNPListComponent.js.map

package/build/blocks/SNPListComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SNPListComponent.js","sourceRoot":"","sources":["../../src/blocks/SNPListComponent.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,WAAW,EAAE,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAY,oBAAoB,EAAC,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,kBAAkB,EAAE,cAAc,EAAC,MAAM,sBAAsB,CAAC;AASxE,MAAM,UAAU,gBAAgB,CAAC,EAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAwB;IAC3G,MAAM,OAAO,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnI,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,KAAgB,EAAE,aAAyC,EAAE,KAAa,EAAE,EAAE;QAChH,OAAO,KAAC,kBAAkB,IAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAC,kBAAkB,IAAC,QAAQ,EAAE,QAAQ,GAAI,CAAC,GAAI,CAAA;IACzI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAEzB,OAAO,KAAC,oBAAoB,IAC3B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,KACvH,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GACxH,CAAC;AACJ,CAAC"}

package/build/blocks/SNPTreeContext.d.ts

@@ -0,0 +1,10 @@
+import type { DataController } from "./simple-native-property-api";
+import type { ReactNode } from "react";
+export type SNPTreeContextValue = {
+    dataController: DataController;
+};
+export declare const SNPTreeContext: import("react").Context<SNPTreeContextValue | undefined>;
+export declare function useSNPTreeContext(action: string): SNPTreeContextValue;
+export declare function SNPTreeContextRoot({ dataController, children }: SNPTreeContextValue & {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/build/blocks/SNPTreeContext.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "@wordpress/element";
+export const SNPTreeContext = createContext(undefined);
+export function useSNPTreeContext(action) {
+    const SNPTreeContextValue = useContext(SNPTreeContext);
+    if (SNPTreeContextValue === undefined) {
+        throw new Error(`Cannot ${action} outside of a SNPTreeContext`);
+    }
+    return SNPTreeContextValue;
+}
+export function SNPTreeContextRoot({ dataController, children }) {
+    const snpTreeContextValue = useMemo(() => ({ dataController }), [dataController]);
+    return _jsx(SNPTreeContext.Provider, { value: snpTreeContextValue, children: children });
+}
+//# sourceMappingURL=SNPTreeContext.js.map

package/build/blocks/SNPTreeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SNPTreeContext.js","sourceRoot":"","sources":["../../src/blocks/SNPTreeContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,aAAa,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAMtE,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAgC,SAAS,CAAC,CAAC;AAEtF,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,MAAM,mBAAmB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACvD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,8BAA8B,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,EAAC,cAAc,EAAE,QAAQ,EAA4C;IACvG,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAwB,EAAE,CAAC,CAAC,EAAC,cAAc,EAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IACrG,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,GAAI,CAAC;AACpF,CAAC"}

package/build/blocks/common-native-property-constructors.d.ts

@@ -9,7 +9,7 @@ import type { ToggleGroupControlProps } from "@wordpress/components/build-types/
 import { type ExtendedPostPickerProps, type ImageData, type ProperLinkControlProps, type SortableItemsControlProps, type PickableOptions } from "../controls";
 import type { NormalSwitch, SmallSwitch } from "./shared-internal-types";
 import type { IconName } from "./shared-exportable-types";
-import type { GenericSimpleNativeProperty, PotentiallyDesiccatedSimpleNativeProperty, SimpleNativeProperty, SimpleNativePropertyType } from "./simple-native-property-api";
+import type { BlockName, GenericSimpleNativeProperty, HydratedSimpleNativeProperty, PDSimpleNativeProperty, SimpleNativeProperty, SimpleNativePropertyType } from "./simple-native-property-api";
 import React, { type CSSProperties, type ReactElement } from "react";
 type ActualBEPAttrs = Record<string, any> & {
     className?: string | undefined;
@@ -18,10 +18,15 @@ type PromisablePickableOptions<V extends string | number, T extends object = {}>
 export type ActualBlockEditProps = {
     attributes: ActualBEPAttrs;
     setAttributes: (attributes: ActualBEPAttrs) => void;
-    name: string;
+    name: BlockName;
     clientId: string;
 };
-export type CommonPropertyConfig<T, C, V extends SimpleNativePropertyType> = Omit<GenericSimpleNativeProperty<T, V>, 'control' | 'enum' | 'type'> & {
+export type ActualBlockListBlockProps = {
+    attributes: ActualBEPAttrs;
+    name: BlockName;
+    clientId: string;
+};
+export type CommonPropertyConfig<T, C, V extends SimpleNativePropertyType> = Omit<GenericSimpleNativeProperty<T, V>, 'control' | 'enum' | 'type' | 'label'> & {
     label: string;
     help?: string;
     component?: Partial<C>;
@@ -29,7 +34,7 @@ export type CommonPropertyConfig<T, C, V extends SimpleNativePropertyType> = Omi
 export type CommonPropertyConfigWithEnum<T, C, V extends SimpleNativePropertyType> = CommonPropertyConfig<T, C, V> & {
     enum?: T[];
 };
-export type ShareableSNPElements<T extends SimpleNativeProperty['type']> = Pick<SimpleNativeProperty, 'name' | 'condition' | 'alwaysStore'> & {
+export type ShareableSNPElements<T extends SimpleNativeProperty['type']> = Pick<SimpleNativeProperty, 'name' | 'condition' | 'alwaysStore' | 'label' | 'required'> & {
     type: T;
 };
 export type CommonSimpleNativeProperty<N extends string, T, C, V extends SimpleNativePropertyType, A = {}> = CommonPropertyConfig<T, C, V> & A & {
@@ -113,7 +118,7 @@ export type ImagePropertyConfig = Omit<CommonPropertyConfig<ImageData, {}, 'obje
     includeFocalPointPicker?: boolean;
 };
 export type GroupPropertyConfig = CommonPropertyConfig<Record<string, unknown>, React.HTMLAttributes<HTMLFieldSetElement>, 'object'> & {
-    fields: PotentiallyDesiccatedSimpleNativeProperty[];
+    fields?: PDSimpleNativeProperty[];
 };
 type ListPropertyConfigBase<T extends string | number | object, V extends 'string' | 'number' | 'object'> = CommonPropertyConfig<T[], SortableItemsControlProps<T>, V> & {
     emptyValue?: T;
@@ -130,7 +135,7 @@ export type StringListPropertyConfig = ListPropertyConfigBase<string, 'string'>
     itemType?: 'string';
 };
 export type ObjectListPropertyConfig = ListPropertyConfigBase<object, 'object'> & {
-    itemType: PotentiallyDesiccatedSimpleNativeProperty[];
+    itemType: PDSimpleNativeProperty[];
 };
 export type ListPropertyConfig = StringListPropertyConfig | NumberListPropertyConfig | ObjectListPropertyConfig;
 type ToggleGroupPropertyConfigBase<T extends string | number, V extends 'string' | 'number'> = CommonPropertyConfig<T, ToggleGroupControlProps, V> & {
@@ -149,7 +154,7 @@ export type TogglePropertyConfig = (CommonPropertyConfig<boolean, ToggleControlP
     switch?: NormalSwitch;
 });
 export type CSNPConfig = ColorPaletteCSNPConfig | ConstantPropertyCSNPConfig | DatePropertyCSNPConfig | GroupPropertyCSNPConfig | ImagePropertyCSNPConfig | LinkPropertyCSNPConfig | ListPropertyCSNPConfig | NumberPropertyCSNPConfig | PostPropertyCSNPConfig | RadioPropertyCSNPConfig | RangePropertyCSNPConfig | SelectPropertyCSNPConfig | TextareaPropertyCSNPConfig | TextPropertyCSNPConfig | ToggleGroupPropertyCSNPConfig | TogglePropertyCSNPConfig;
-export declare function hydrateSimpleNativeProperty(config: PotentiallyDesiccatedSimpleNativeProperty): SimpleNativeProperty;
+export declare function hydrateSimpleNativeProperty(config: PDSimpleNativeProperty): HydratedSimpleNativeProperty;
 type PostPropertyTypeSingle = CommonPropertyConfig<number, ExtendedPostPickerProps, 'number'> & {
     postTypes?: string[];
     multiple?: false;
@@ -159,5 +164,6 @@ type PostPropertyTypeMultiple = CommonPropertyConfig<number[], ExtendedPostPicke
     multiple: true;
 };
 export type PostPropertyType = PostPropertyTypeSingle | PostPropertyTypeMultiple;
-export declare function hydratePostProperty(config: PostPropertyType): SimpleNativeProperty;
+export declare function hydratePostProperty(config: PostPropertyType): HydratedSimpleNativeProperty;
+export declare function registerPlainTextLabelRequiredMarker(componentType: string, labelSelectorFragment: string): void;
 export {};