ngx-dynamic-entity-builder 1.8.1 → 1.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dynamic-entity-builder",
-  "version": "1.8.1",
+  "version": "1.9.1",
   "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.0.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.8.1",
-    "ngx-dynamic-entity": "^1.8.1",
+    "@dynamic-entity/core": "^1.9.1",
+    "ngx-dynamic-entity": "^1.9.1",
     "rxjs": "^7.0.0"
   },
   "keywords": [

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

@@ -1,8 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { OnChanges, EventEmitter, SimpleChanges } from '@angular/core';
+import { InjectionToken, OnChanges, EventEmitter, SimpleChanges } from '@angular/core';
 import { NestedTabConfig, NestedFieldConfig, EntityFormConfig, FormRule, EntityPermissions, RichFieldType, FlagValidator, ParamValidator, DropdownOption, EntityReferenceConfig, AutoPatchMapping, PatchOnTrueMapping, CommonModuleEntry, FieldTypeMeta, RuleOperator } from '@dynamic-entity/core';
 export { AutoPatchConfig, AutoPatchMapping, DropdownOption, EntityFormConfig, EntityPermissions, EntityReferenceConfig, FIELD_TYPE_CATALOG, FieldTypeMeta, FlagValidator, FormRule, NestedFieldConfig, NestedTabConfig, ParamValidator, PatchOnTrueMapping, RichFieldType, RuleAction, RuleCondition, RuleOperator, createFieldConfig, getFieldTypeMeta, humanizeId } from '@dynamic-entity/core';
 import * as ngx_dynamic_entity from 'ngx-dynamic-entity';
+import { UiTextOverridesFor, UiTextParams } from 'ngx-dynamic-entity';
 export { SYSTEM_DEFAULT_CAN_EDIT } from 'ngx-dynamic-entity';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 
@@ -362,10 +363,211 @@ declare class BuilderStore {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<BuilderStore>;
 }
 
+/**
+ * Every word the builder puts on screen that is not part of the config being authored.
+ *
+ * The renderer has its own list (`DEFAULT_UI_TEXT`) and the two are deliberately separate:
+ * an application that ships only the renderer should not see a hundred and fifty builder
+ * keys in completion, and the two vocabularies share no strings worth deduplicating. What
+ * they do share is the resolution rule, which comes from `resolveUiText`.
+ *
+ * Keys are grouped by panel, because a translator works screen by screen.
+ */
+declare const DEFAULT_BUILDER_TEXT: {
+    builderTitle: string;
+    undo: string;
+    undoTooltip: string;
+    redo: string;
+    redoTooltip: string;
+    issuesTooltip: string;
+    copyJson: string;
+    save: string;
+    entityName: string;
+    entityNamePlaceholder: string;
+    editingLanguage: string;
+    maskEntity: string;
+    permissions: string;
+    actionRoles: string;
+    actionRolesPlaceholder: string;
+    permissionsHint: string;
+    addField: string;
+    fieldProperties: string;
+    configJson: string;
+    fieldsHeading: string;
+    canvasEmpty: string;
+    selectField: string;
+    dragToReorder: string;
+    referencedFieldTooltip: string;
+    driftDetected: string;
+    required: string;
+    moveUp: string;
+    moveDown: string;
+    duplicate: string;
+    delete: string;
+    moveFieldUp: string;
+    moveFieldDown: string;
+    duplicateField: string;
+    inspectorEmpty: string;
+    fieldId: string;
+    fieldIdFixedHint: string;
+    fieldIdDerivedHint: string;
+    tab: string;
+    tabMoveHint: string;
+    labelInLanguage: string;
+    placeholderInLanguage: string;
+    defaultValue: string;
+    validation: string;
+    dataSource: string;
+    optionsComeFrom: string;
+    optionsSourceNone: string;
+    optionsSourceInline: string;
+    optionsSourceList: string;
+    listName: string;
+    listNameHint: string;
+    options: string;
+    option: string;
+    optionInLanguage: string;
+    removeOption: string;
+    noOptionsYet: string;
+    display: string;
+    visible: string;
+    tableColumn: string;
+    readOnly: string;
+    disabled: string;
+    maskData: string;
+    criticalField: string;
+    criticalFieldTooltip: string;
+    showInSummary: string;
+    showInSummaryTooltip: string;
+    showWhen: string;
+    condition: string;
+    watchedField: string;
+    equals: string;
+    removeCondition: string;
+    alwaysVisibleHint: string;
+    copyOnTrue: string;
+    mapping: string;
+    fromField: string;
+    toField: string;
+    removeMapping: string;
+    copyOnTrueHint: string;
+    rules: string;
+    rule: string;
+    noRulesOnField: string;
+    rulePriority: string;
+    toggleRule: string;
+    moveRuleUp: string;
+    moveRuleDown: string;
+    editRule: string;
+    deleteRule: string;
+    newRuleTitle: string;
+    editRuleTitle: string;
+    triggerField: string;
+    applyToFields: string;
+    conditions: string;
+    operator: string;
+    value: string;
+    conditionValuePlaceholder: string;
+    addCondition: string;
+    action: string;
+    actionType: string;
+    actionVisibility: string;
+    actionValidationMessage: string;
+    actionInfoBanner: string;
+    valueOrMessage: string;
+    valueOrMessagePlaceholder: string;
+    cancel: string;
+    saveRule: string;
+    tabsManager: string;
+    systemTag: string;
+    addTab: string;
+    noTabs: string;
+    flatData: string;
+    primaryTab: string;
+    maskTabData: string;
+    systemDefault: string;
+    addSubTab: string;
+    consumerModuleName: string;
+    consumerModulePlaceholder: string;
+    subTabs: string;
+    moveTabUp: string;
+    moveTabDown: string;
+    removeTab: string;
+    removeSubTab: string;
+    entityReference: string;
+    registryKey: string;
+    registryKeyHint: string;
+    displayFields: string;
+    displayFieldsHint: string;
+    staticFilters: string;
+    staticFiltersHint: string;
+    cascade: string;
+    parentField: string;
+    parentFieldNone: string;
+    cascadeHint: string;
+    lookupFilterPath: string;
+    lookupFilterPathHint: string;
+    lookupPath: string;
+    lookupPathHint: string;
+    autoPatchOnSelect: string;
+    targetTab: string;
+    sourceLinkedRecord: string;
+    targetField: string;
+    noAutoPatch: string;
+    referencedField: string;
+    link: string;
+    sourceEntityKey: string;
+    sourceEntityKeyPlaceholder: string;
+    sourceFieldId: string;
+    sourceFieldIdPlaceholder: string;
+    driftHeading: string;
+    driftBody: string;
+    syncWithSource: string;
+};
+/** The keys above, as a union — checked in templates, completed in a host's overrides. */
+type BuilderTextKey = keyof typeof DEFAULT_BUILDER_TEXT;
+/** Same contract as the renderer's `UI_TEXT`, over the builder's vocabulary. */
+type BuilderTextOverrides = UiTextOverridesFor<BuilderTextKey>;
+/**
+ * Overrides for the builder's own chrome.
+ *
+ * Accepts what `UI_TEXT` accepts: a partial map whose values are strings or `LocalizedText`
+ * (`{ en, de }`), or a resolver `(key, defaultText, language) => string` for a host with an
+ * existing i18n layer. `DEFAULT_BUILDER_TEXT` is the full key list with its English source
+ * strings; anything left out keeps its default.
+ *
+ * @example
+ * { provide: BUILDER_TEXT, useValue: { save: { en: 'Save', de: 'Speichern' } } }
+ */
+declare const BUILDER_TEXT: InjectionToken<BuilderTextOverrides>;
+/**
+ * Resolves the builder's own UI text.
+ *
+ * The language lives on the service rather than travelling through every template call,
+ * because the builder already has a *different* language on screen: `activeLanguage()`
+ * selects the `LocalizedText` entry being **authored**. Passing that one to the chrome
+ * would flip the builder's own interface every time an author switched the label language
+ * they were editing, which is the opposite of what it means.
+ *
+ * Root-provided and therefore shared: two builders mounted at once show one chrome
+ * language. `EntityBuilderComponent`'s `uiLanguage` input is what sets it.
+ */
+declare class BuilderTextService {
+    private readonly overrides;
+    /** The chrome language. Not the authoring language — see the class comment. */
+    readonly language: _angular_core.WritableSignal<string>;
+    /** One label by key. `params` fill the `{placeholder}` slots. */
+    text(key: BuilderTextKey, params?: UiTextParams): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BuilderTextService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<BuilderTextService>;
+}
+
 /**
  * EntityBuilderComponent — the top-level visual builder for an EntityFormConfig.
  */
 declare class EntityBuilderComponent implements OnChanges {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     /**
      * Optional: only apps that registered a CONFIG_SOURCE have one. Used to drop the cached
@@ -376,6 +578,14 @@ declare class EntityBuilderComponent implements OnChanges {
     config?: EntityFormConfig;
     /** Languages available for label/placeholder editing. First entry is the default. */
     languages: string[];
+    /**
+     * Language for the builder's **own** chrome, resolved through `BUILDER_TEXT`.
+     *
+     * Deliberately separate from `languages` and `store.activeLanguage()`, which choose the
+     * `LocalizedText` entry being authored: switching the label language you are editing
+     * should not translate the interface around it.
+     */
+    set uiLanguage(value: string);
     /** Optional role list — enables multi-select role pickers for RBAC instead of free text. */
     availableRoles: string[];
     /**
@@ -408,7 +618,7 @@ declare class EntityBuilderComponent implements OnChanges {
     /** Parse a comma-separated role string into a trimmed, de-duplicated array. */
     protected setRolesFromText(action: keyof EntityPermissions, 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; }; "availableRoles": { "alias": "availableRoles"; "required": false; }; "userRoles": { "alias": "userRoles"; "required": false; }; "commonModules": { "alias": "commonModules"; "required": false; }; }, { "configChange": "configChange"; "save": "save"; }, never, ["[ngxBuilderPreview]"], true, 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; }; }, { "configChange": "configChange"; "save": "save"; }, never, ["[ngxBuilderPreview]"], true, never>;
 }
 
 /**
@@ -454,6 +664,8 @@ declare function withExistingOptions(options: readonly FieldPathOption[], curren
  * FieldInspectorComponent — edits every property of the currently selected field.
  */
 declare class FieldInspectorComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     protected readonly field: _angular_core.Signal<NestedFieldConfig>;
     protected readonly meta: _angular_core.Signal<FieldTypeMeta>;
@@ -519,6 +731,8 @@ declare class FieldInspectorComponent {
  * TabManagerComponent — add / rename / reorder / remove tabs & sub-tabs with systemDefault protection.
  */
 declare class TabManagerComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     private readonly canEditSystemDefaultsFn;
     protected lang(): string;
@@ -534,6 +748,8 @@ declare class TabManagerComponent {
  * RuleFormComponent — dialog/panel form for creating or editing a FormRule.
  */
 declare class RuleFormComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     private readonly store;
     rule: FormRule;
     save: EventEmitter<FormRule>;
@@ -575,6 +791,8 @@ declare class RuleFormComponent {
  * enable/disable, edit, delete. `RuleFormComponent` authors one rule; this owns the set.
  */
 declare class FieldRulesListComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     /** The rule currently open in the editor — a new draft or a copy of an existing rule. */
     protected readonly editing: _angular_core.WritableSignal<FormRule>;
@@ -595,6 +813,8 @@ declare class FieldRulesListComponent {
  * selected reference returns.
  */
 declare class EntityReferenceConfigComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     protected readonly field: _angular_core.Signal<NestedFieldConfig>;
     /** Sibling fields that can drive a cascade — anything but this field itself. */
@@ -626,6 +846,8 @@ declare class EntityReferenceConfigComponent {
 }
 
 declare class EntityBuilderCanvasComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     /**
      * Headings only earn their space once the fields are actually split across tabs. A
@@ -639,6 +861,8 @@ declare class EntityBuilderCanvasComponent {
 }
 
 declare class EntityBuilderTreeNodeComponent {
+    /** Builder chrome, overridable via BUILDER_TEXT. */
+    protected readonly ui: BuilderTextService;
     protected readonly store: BuilderStore;
     field: NestedFieldConfig;
     index: number;
@@ -653,5 +877,5 @@ declare class EntityBuilderTreeNodeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityBuilderTreeNodeComponent, "ngx-entity-builder-tree-node", never, { "field": { "alias": "field"; "required": true; }; "index": { "alias": "index"; "required": true; }; "totalCount": { "alias": "totalCount"; "required": true; }; }, {}, never, never, true, never>;
 }
 
-export { BuilderStore, EntityBuilderCanvasComponent, EntityBuilderComponent, EntityBuilderTreeNodeComponent, EntityReferenceConfigComponent, FieldInspectorComponent, FieldPaletteComponent, FieldRulesListComponent, RuleFormComponent, TabManagerComponent, fieldPathOptions, withExistingOptions };
-export type { BuilderFieldGroup, BuilderProblem, FieldPathOption };
+export { BUILDER_TEXT, BuilderStore, BuilderTextService, DEFAULT_BUILDER_TEXT, EntityBuilderCanvasComponent, EntityBuilderComponent, EntityBuilderTreeNodeComponent, EntityReferenceConfigComponent, FieldInspectorComponent, FieldPaletteComponent, FieldRulesListComponent, RuleFormComponent, TabManagerComponent, fieldPathOptions, withExistingOptions };
+export type { BuilderFieldGroup, BuilderProblem, BuilderTextKey, BuilderTextOverrides, FieldPathOption };