ngx-dynamic-entity-builder 1.14.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dynamic-entity-builder",
-  "version": "1.14.0",
+  "version": "2.0.0",
   "description": "Angular standalone visual builder for authoring dynamic-entity EntityConfig (fields, tabs, validators, RBAC).",
   "//typings": "Local workspace resolution only: ng-packagr 21 writes types/ngx-dynamic-entity-builder.d.ts into dist/package.json. Do NOT add a 'main' field here — ng-packagr does not generate one, so it would be copied verbatim and resolve wrongly in the published package.",
   "typings": "types/ngx-dynamic-entity-builder.d.ts",
@@ -10,8 +10,8 @@
     "@angular/core": "^17.2.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
     "@angular/forms": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
     "@angular/material": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
-    "@dynamic-entity/core": "^1.14.0",
-    "ngx-dynamic-entity": "^1.14.0",
+    "@dynamic-entity/core": "^2.0.0",
+    "ngx-dynamic-entity": "^2.0.0",
     "rxjs": "^7.0.0"
   },
   "keywords": [

package/types/ngx-dynamic-entity-builder.d.ts

@@ -73,6 +73,8 @@ declare class BuilderStore {
      * removing or moving anything always earns its own step however fast it is clicked.
      */
     private record;
+    /** How many undo steps are kept. */
+    private static readonly MAX_HISTORY;
     /** Counts that distinguish a structural edit from a value edit. */
     private shapeOf;
     /** Start history again from the state just loaded. Nothing before it is undoable. */
@@ -113,7 +115,7 @@ declare class BuilderStore {
     readonly problems: _angular_core.Signal<BuilderProblem[]>;
     readonly errors: _angular_core.Signal<BuilderProblem[]>;
     readonly isValid: _angular_core.Signal<boolean>;
-    load(config: EntityFormConfig): void;
+    load(config: EntityFormConfig, rules?: readonly FormRule[]): void;
     reset(entity?: string): void;
     resetDirty(): void;
     private emptyConfig;
@@ -274,6 +276,30 @@ declare class BuilderStore {
     /** Scan all referenced fields in the config and update their hasDrift state against current source configs. */
     checkDrift(sourceConfigs: Record<string, EntityFormConfig>): void;
     addOption(fieldId: string): void;
+    /**
+     * A key for a new option: the label slugified, made unique within its own field.
+     *
+     * Unique within the field and nowhere wider, because that is the scope the key has to
+     * distinguish within — two fields may both offer "Active" and they are the same value.
+     * A label that slugifies to nothing (punctuation, a script `labelToId` strips) falls back
+     * to a positional name rather than an empty key, which `optionKeyOf` would ignore.
+     */
+    private mintOptionKey;
+    /**
+     * Give every option in the config a key, leaving the ones that already have one alone.
+     *
+     * The counterpart to `optionKeyMigration` in core: that one keys stored *records* against
+     * a keyed config, this one keys the config. Run this first, then ship the migration — the
+     * other order leaves the migration with no keys to attach.
+     *
+     * Existing keys are never rewritten, so this is safe to run again on a config that is
+     * already half-keyed, which is what happens as options are added to an older schema.
+     */
+    assignOptionKeys(): void;
+    /** Whether any option in the config is still without a key — gates the action in the UI. */
+    readonly hasUnkeyedOptions: _angular_core.Signal<boolean>;
+    /** An option's stable key, for the inspector to show read-only. */
+    optionKey(option: DropdownOption): string;
     /** Merge language keys into an option. `setOptionLabel` is the usual single-language path. */
     updateOption(fieldId: string, index: number, patch: DropdownOption): void;
     /**
@@ -306,6 +332,11 @@ declare class BuilderStore {
      * had lost its rules.
      */
     readonly rulesForSelectedField: _angular_core.Signal<FormRule[]>;
+    /**
+     * Replace the rules without touching the config — for a host whose rules changed on their
+     * own. It records a step, because from the author's side it is an edit. Loading a config
+     * passes its rules to `load` instead, so the pair arrives as one snapshot.
+     */
     loadRules(rules: FormRule[]): void;
     addRule(rule: FormRule): string;
     updateRule(id: string, patch: Partial<FormRule>): void;
@@ -481,6 +512,9 @@ declare const DEFAULT_BUILDER_TEXT: {
     optionInLanguage: string;
     removeOption: string;
     noOptionsYet: string;
+    optionKey: string;
+    optionKeyHint: string;
+    assignOptionKeys: string;
     display: string;
     visible: string;
     tableColumn: string;
@@ -631,6 +665,15 @@ declare class EntityBuilderComponent implements OnChanges {
     private readonly hostRef;
     /** Existing config to edit. When omitted, the builder starts blank. */
     config?: EntityFormConfig;
+    /**
+     * The rules that belong with `config`.
+     *
+     * Rules live beside a config rather than inside it — that is the shape the renderer takes
+     * them in, and the shape a host stores them in. Without this input, loading a config for
+     * editing silently dropped every rule already authored against it: the builder opened on
+     * the right fields with an empty rules list, and saving put that emptiness back.
+     */
+    rules?: FormRule[];
     /** Languages available for label/placeholder editing. First entry is the default. */
     languages: string[];
     /**
@@ -653,6 +696,21 @@ declare class EntityBuilderComponent implements OnChanges {
     commonModules: readonly CommonModuleEntry[];
     /** Emitted on every change to the working config. */
     configChange: EventEmitter<EntityFormConfig>;
+    /**
+     * Emitted on every change to the working rules — the mirror of `configChange`.
+     *
+     * Without it a rule authored here could not leave this component. `BuilderStore` is
+     * provided by the component, so its instance is private to this injector, and `save`
+     * carries an `EntityFormConfig` alone. The builder could author a rule and hand it to
+     * nobody: a host had no supported way to persist one, and therefore no way to pass it
+     * back to the renderer as `[rules]`.
+     *
+     * A host that persists on Save keeps the latest emission and writes it alongside the
+     * config `save` carries — the same pairing `configChange`/`save` already implies, and the
+     * pairing the undo history has always stored, because undoing a field rename without the
+     * rule that follows it would leave the rule pointing at a field that no longer exists.
+     */
+    rulesChange: EventEmitter<FormRule[]>;
     /** Emitted when the user clicks Save. Carries a clean, deep-cloned config. */
     save: EventEmitter<EntityFormConfig>;
     protected readonly rbacActions: readonly RbacAction[];
@@ -699,7 +757,7 @@ declare class EntityBuilderComponent implements OnChanges {
     /** Parse a comma-separated role string into a trimmed, de-duplicated array. */
     protected setRolesFromText(action: RbacAction, text: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EntityBuilderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityBuilderComponent, "ngx-entity-builder", never, { "config": { "alias": "config"; "required": false; }; "languages": { "alias": "languages"; "required": false; }; "uiLanguage": { "alias": "uiLanguage"; "required": false; }; "availableRoles": { "alias": "availableRoles"; "required": false; }; "userRoles": { "alias": "userRoles"; "required": false; }; "commonModules": { "alias": "commonModules"; "required": false; }; "leftSidebarOpen": { "alias": "leftSidebarOpen"; "required": false; "isSignal": true; }; "rightSidebarOpen": { "alias": "rightSidebarOpen"; "required": false; "isSignal": true; }; "fieldsOpen": { "alias": "fieldsOpen"; "required": false; "isSignal": true; }; "previewOpen": { "alias": "previewOpen"; "required": false; "isSignal": true; }; }, { "configChange": "configChange"; "save": "save"; "leftSidebarOpen": "leftSidebarOpenChange"; "rightSidebarOpen": "rightSidebarOpenChange"; "fieldsOpen": "fieldsOpenChange"; "previewOpen": "previewOpenChange"; }, never, ["[ngxBuilderPreview]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityBuilderComponent, "ngx-entity-builder", never, { "config": { "alias": "config"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "languages": { "alias": "languages"; "required": false; }; "uiLanguage": { "alias": "uiLanguage"; "required": false; }; "availableRoles": { "alias": "availableRoles"; "required": false; }; "userRoles": { "alias": "userRoles"; "required": false; }; "commonModules": { "alias": "commonModules"; "required": false; }; "leftSidebarOpen": { "alias": "leftSidebarOpen"; "required": false; "isSignal": true; }; "rightSidebarOpen": { "alias": "rightSidebarOpen"; "required": false; "isSignal": true; }; "fieldsOpen": { "alias": "fieldsOpen"; "required": false; "isSignal": true; }; "previewOpen": { "alias": "previewOpen"; "required": false; "isSignal": true; }; }, { "configChange": "configChange"; "rulesChange": "rulesChange"; "save": "save"; "leftSidebarOpen": "leftSidebarOpenChange"; "rightSidebarOpen": "rightSidebarOpenChange"; "fieldsOpen": "fieldsOpenChange"; "previewOpen": "previewOpenChange"; }, never, ["[ngxBuilderPreview]"], true, never>;
 }
 
 /**