builder-settings-types 0.0.463 → 0.0.464

package/dist/base/additional-settings/additonalSettings.d.ts

@@ -8,6 +8,7 @@ export declare class AdditionalSettings<TSettings extends SettingsMap> implement
     title: string;
     private settings;
     private selectedKeys;
+    private repeatingInstances;
     private rootElement;
     private contentElement;
     private addButton;
@@ -19,10 +20,19 @@ export declare class AdditionalSettings<TSettings extends SettingsMap> implement
     setSelectedKeys(keys: (keyof TSettings)[]): void;
     removeSettingKey(key: keyof TSettings): void;
     addSettingKey(key: keyof TSettings): void;
+    /**
+     * Restore visible repeating instances for a key from serialized values.
+     * Clears existing instances for that key and re-creates from the array.
+     */
+    restoreRepeatingInstances(key: keyof TSettings, values: unknown[]): void;
     private createHeader;
     private createContentContainer;
     private getRemainingKeys;
     private selectSetting;
+    private addRepeatingInstance;
+    private removeRepeatingInstance;
+    private renderRepeatingInstance;
+    private clearRegularElements;
     private removeSetting;
     private renderSelectedSetting;
     private getSettingTitle;

package/dist/base/additional-settings/repeatingSetting.d.ts

@@ -0,0 +1,61 @@
+export type RepeatingSettingProps<T extends object> = {
+    title: string;
+    factory: () => T;
+    max?: number;
+};
+/** Sentinel wrapper written into getInstanceValues() for hidden instances. */
+export type RepeatingHiddenSentinel = {
+    __hidden: true;
+    value: unknown;
+};
+export declare function isRepeatingHiddenSentinel(v: unknown): v is RepeatingHiddenSentinel;
+export declare class RepeatingSetting<T extends object> {
+    readonly isRepeating: true;
+    readonly isAdditional: true;
+    title: string;
+    readonly factory: () => T;
+    readonly max: number;
+    private instances;
+    private onChangeCb?;
+    private restoreCallback?;
+    constructor(props: RepeatingSettingProps<T>);
+    canAddMore(): boolean;
+    createInstance(hidden?: boolean): {
+        id: string;
+        instance: T;
+    };
+    removeInstance(id: string): void;
+    /** Returns all instances (visible and hidden) in insertion order. */
+    getInstances(): {
+        id: string;
+        instance: T;
+    }[];
+    clearInstances(): void;
+    setInstanceHidden(id: string, hidden: boolean): void;
+    getInstanceHidden(id: string): boolean;
+    private extractInstanceValue;
+    private extractInstanceValueForJson;
+    /**
+     * Returns ALL instances in order, preserving hidden state.
+     * Hidden instances are wrapped: { __hidden: true, value: <instanceValue> }.
+     * This lets restoreFromValues reconstruct exact order + hidden state.
+     */
+    getInstanceValues(): unknown[];
+    /**
+     * Returns values for ALL instances.
+     * Hidden instances are wrapped: { __hidden: true, value: <instanceValue> }.
+     * This lets restoreFromValues reconstruct exact order + hidden state.
+     */
+    getInstanceValuesForJson(): unknown[];
+    setOnChange(cb: () => void): void;
+    setRestoreCallback(cb: (values: unknown[]) => void): void;
+    setValue(newValues: unknown[]): void;
+    notifyChange(): void;
+    /**
+     * Clears all instances and restores from values.
+     * Handles both plain values (visible) and sentinel-wrapped values (hidden),
+     * preserving the original order.
+     */
+    restoreFromValues(values: unknown[]): void;
+}
+export declare function isRepeatingSetting(value: unknown): value is RepeatingSetting<object>;