@msbci/form-editor 1.3.4 → 1.3.5

package/dist/index.d.mts

@@ -53,6 +53,25 @@ interface IEditorAdapter {
      * empty list (the user can no longer pick from existing scopes).
      */
     loadScopes?: () => Promise<IScope[]>;
+    /** Optional — create a new {@link IScope}. */
+    createScope?: (data: Omit<IScope, 'id' | 'createdAt' | 'updatedAt'>) => Promise<IScope>;
+    /** Optional — update an existing {@link IScope}. */
+    updateScope?: (id: string, data: Partial<Omit<IScope, 'id' | 'code' | 'tenantId' | 'createdAt' | 'updatedAt'>>) => Promise<IScope>;
+    /** Optional — hard-delete a scope (server returns 409 if still in use). */
+    deleteScope?: (id: string) => Promise<void>;
+    /**
+     * Optional — create a {@link IVariableTemplate} within a scope.
+     * `code` and `name` are immutable identity fields enforced by the server.
+     */
+    createTemplate?: (scopeId: string, data: Omit<IVariableTemplate, 'id' | 'scopeId' | 'tenantId' | 'createdAt' | 'updatedAt'>) => Promise<IVariableTemplate>;
+    /**
+     * Optional — update a {@link IVariableTemplate}. `code` and `name` are
+     * not in the payload type because the server rejects any attempt to
+     * change them.
+     */
+    updateTemplate?: (id: string, data: Partial<Omit<IVariableTemplate, 'id' | 'code' | 'name' | 'scopeId' | 'tenantId' | 'createdAt' | 'updatedAt'>>) => Promise<IVariableTemplate>;
+    /** Optional — hard-delete a {@link IVariableTemplate}. */
+    deleteTemplate?: (id: string) => Promise<void>;
     /**
      * Optional — fetch the {@link IDataSourceConfig} list of a scope.
      * Called once per scope when `FormEditor` mounts and whenever
@@ -191,6 +210,10 @@ interface IEditorLabels {
         dataSources: string;
         /** Tooltip on the DataSources header button. */
         manageDataSourcesTitle: string;
+        /** Header button that opens the ScopeManagerDialog. */
+        scopes: string;
+        /** Tooltip on the Scopes header button. */
+        manageScopesTitle: string;
         undo: string;
         redo: string;
         save: string;
@@ -439,6 +462,65 @@ interface IEditorLabels {
         dependencyKeyPlaceholder: string;
         addDependency: string;
     };
+    scopeManager: {
+        dialogAriaLabel: string;
+        title: string;
+        closeAriaLabel: string;
+        addScope: string;
+        newScopeName: string;
+        newScopeCodePlaceholder: string;
+        manageVariables: string;
+        confirmDelete: string;
+        deleteConfirm: string;
+        deleteCancel: string;
+        noScopes: string;
+        saveButton: string;
+        cancelButton: string;
+        /** Inline error shown when the server returns 409 on delete. */
+        deleteError: string;
+        /** ARIA labels for row actions. */
+        editScopeAria: (code: string) => string;
+        removeScopeAria: (code: string) => string;
+        manageVariablesAria: (code: string) => string;
+    };
+    variableTemplateManager: {
+        dialogAriaLabel: string;
+        title: (scopeName: string) => string;
+        closeAriaLabel: string;
+        addTemplate: string;
+        code: string;
+        name: string;
+        type: string;
+        description: string;
+        placeholder: string;
+        required: string;
+        readonly: string;
+        hidden: string;
+        options: string;
+        expression: string;
+        dataSourceId: string;
+        advancedSection: string;
+        validationRules: string;
+        conditions: string;
+        style: string;
+        confirmDelete: string;
+        deleteConfirm: string;
+        deleteCancel: string;
+        noTemplates: string;
+        saveButton: string;
+        cancelButton: string;
+        /** Inline error when the new code already exists in the scope. */
+        duplicateCodeError: string;
+        /** Read-only badge label for code field. */
+        readonlyCode: string;
+        /** Read-only badge label for name field. */
+        readonlyName: string;
+        /** ARIA labels for row actions. */
+        editTemplateAria: (code: string) => string;
+        removeTemplateAria: (code: string) => string;
+        /** Back to scope list button (header). */
+        backToScopes: string;
+    };
     dataSourceManager: {
         /** ARIA label of the dialog root. */
         dialogAriaLabel: string;
@@ -750,4 +832,55 @@ interface DataSourceConfigManagerProps {
 }
 declare function DataSourceConfigManager({ open, onClose }: DataSourceConfigManagerProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ActiveDragData, Canvas, Canvas as CanvasDnd, CanvasSimple, ConditionBuilder, type ConditionBuilderProps, DataSourceConfigManager, type DataSourceConfigManagerProps, DataSourceSelector, type DataSourceSelectorProps, type DeepPartial, DndManager, type DragEndActions, type EditorActions, EditorLabelsProvider, type EditorSelection, type EditorState, type EditorStore, EditorToolbar, type EditorView, FormEditor, type FormEditorProps, type HistoryEntry, type IEditorAdapter, type IEditorLabels, type OverDropData, PropertiesPanel, Toolbox, Toolbox as ToolboxDnd, ToolboxSimple, createDragEndHandler, frLabels as defaultLabels, enLabels, frLabels, mergeLabels, useEditorStore, useLabels };
+/**
+ * ScopeManagerDialog — admin CRUD for {@link IScope} entries.
+ *
+ * Mirrors the `FormTypesDialog` visual pattern (native modal, inline
+ * edit, delete-with-confirm) but persists through the editor adapter:
+ *   - `adapter.createScope(data)`
+ *   - `adapter.updateScope(id, data)`
+ *   - `adapter.deleteScope(id)` — server returns 409 if forms, templates,
+ *     or data sources still reference the scope; the dialog surfaces the
+ *     message inline in red.
+ *
+ * Provides a "Gérer les variables →" affordance per row that opens
+ * `VariableTemplateManager` scoped to that scope.
+ */
+interface ScopeManagerDialogProps {
+    open: boolean;
+    onClose: () => void;
+}
+declare function ScopeManagerDialog({ open, onClose }: ScopeManagerDialogProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * VariableTemplateManager — admin CRUD for {@link IVariableTemplate}
+ * entries within a single scope.
+ *
+ * Flow:
+ *   1. Mount: re-fetch `adapter.loadTemplates(scopeId)` to get an
+ *      authoritative list (the store may only carry templates of scopes
+ *      attached to the current form).
+ *   2. CRUD via adapter; optimistic updates on the local list, no refetch.
+ *
+ * Identity:
+ *   - `code` and `name` are immutable after creation (server enforces).
+ *     The edit form shows them disabled, with a "(immuable)" badge.
+ *
+ * Conditional fields:
+ *   - `options` editor surfaces only for select/multiselect/radio/checkbox/listradio.
+ *   - `expression` only for `calculated`.
+ *   - `dataSourceId` only for select/multiselect.
+ *
+ * Advanced section (collapsed by default): validationRules, conditions, style.
+ * These are surfaced as JSON textareas so admins can paste configurations
+ * already produced by the visual condition builder if needed.
+ */
+interface VariableTemplateManagerProps {
+    open: boolean;
+    onClose: () => void;
+    scopeId: string;
+    scopeName: string;
+}
+declare function VariableTemplateManager({ open, onClose, scopeId, scopeName, }: VariableTemplateManagerProps): react_jsx_runtime.JSX.Element | null;
+
+export { type ActiveDragData, Canvas, Canvas as CanvasDnd, CanvasSimple, ConditionBuilder, type ConditionBuilderProps, DataSourceConfigManager, type DataSourceConfigManagerProps, DataSourceSelector, type DataSourceSelectorProps, type DeepPartial, DndManager, type DragEndActions, type EditorActions, EditorLabelsProvider, type EditorSelection, type EditorState, type EditorStore, EditorToolbar, type EditorView, FormEditor, type FormEditorProps, type HistoryEntry, type IEditorAdapter, type IEditorLabels, type OverDropData, PropertiesPanel, ScopeManagerDialog, type ScopeManagerDialogProps, Toolbox, Toolbox as ToolboxDnd, ToolboxSimple, VariableTemplateManager, type VariableTemplateManagerProps, createDragEndHandler, frLabels as defaultLabels, enLabels, frLabels, mergeLabels, useEditorStore, useLabels };

package/dist/index.d.ts

@@ -53,6 +53,25 @@ interface IEditorAdapter {
      * empty list (the user can no longer pick from existing scopes).
      */
     loadScopes?: () => Promise<IScope[]>;
+    /** Optional — create a new {@link IScope}. */
+    createScope?: (data: Omit<IScope, 'id' | 'createdAt' | 'updatedAt'>) => Promise<IScope>;
+    /** Optional — update an existing {@link IScope}. */
+    updateScope?: (id: string, data: Partial<Omit<IScope, 'id' | 'code' | 'tenantId' | 'createdAt' | 'updatedAt'>>) => Promise<IScope>;
+    /** Optional — hard-delete a scope (server returns 409 if still in use). */
+    deleteScope?: (id: string) => Promise<void>;
+    /**
+     * Optional — create a {@link IVariableTemplate} within a scope.
+     * `code` and `name` are immutable identity fields enforced by the server.
+     */
+    createTemplate?: (scopeId: string, data: Omit<IVariableTemplate, 'id' | 'scopeId' | 'tenantId' | 'createdAt' | 'updatedAt'>) => Promise<IVariableTemplate>;
+    /**
+     * Optional — update a {@link IVariableTemplate}. `code` and `name` are
+     * not in the payload type because the server rejects any attempt to
+     * change them.
+     */
+    updateTemplate?: (id: string, data: Partial<Omit<IVariableTemplate, 'id' | 'code' | 'name' | 'scopeId' | 'tenantId' | 'createdAt' | 'updatedAt'>>) => Promise<IVariableTemplate>;
+    /** Optional — hard-delete a {@link IVariableTemplate}. */
+    deleteTemplate?: (id: string) => Promise<void>;
     /**
      * Optional — fetch the {@link IDataSourceConfig} list of a scope.
      * Called once per scope when `FormEditor` mounts and whenever
@@ -191,6 +210,10 @@ interface IEditorLabels {
         dataSources: string;
         /** Tooltip on the DataSources header button. */
         manageDataSourcesTitle: string;
+        /** Header button that opens the ScopeManagerDialog. */
+        scopes: string;
+        /** Tooltip on the Scopes header button. */
+        manageScopesTitle: string;
         undo: string;
         redo: string;
         save: string;
@@ -439,6 +462,65 @@ interface IEditorLabels {
         dependencyKeyPlaceholder: string;
         addDependency: string;
     };
+    scopeManager: {
+        dialogAriaLabel: string;
+        title: string;
+        closeAriaLabel: string;
+        addScope: string;
+        newScopeName: string;
+        newScopeCodePlaceholder: string;
+        manageVariables: string;
+        confirmDelete: string;
+        deleteConfirm: string;
+        deleteCancel: string;
+        noScopes: string;
+        saveButton: string;
+        cancelButton: string;
+        /** Inline error shown when the server returns 409 on delete. */
+        deleteError: string;
+        /** ARIA labels for row actions. */
+        editScopeAria: (code: string) => string;
+        removeScopeAria: (code: string) => string;
+        manageVariablesAria: (code: string) => string;
+    };
+    variableTemplateManager: {
+        dialogAriaLabel: string;
+        title: (scopeName: string) => string;
+        closeAriaLabel: string;
+        addTemplate: string;
+        code: string;
+        name: string;
+        type: string;
+        description: string;
+        placeholder: string;
+        required: string;
+        readonly: string;
+        hidden: string;
+        options: string;
+        expression: string;
+        dataSourceId: string;
+        advancedSection: string;
+        validationRules: string;
+        conditions: string;
+        style: string;
+        confirmDelete: string;
+        deleteConfirm: string;
+        deleteCancel: string;
+        noTemplates: string;
+        saveButton: string;
+        cancelButton: string;
+        /** Inline error when the new code already exists in the scope. */
+        duplicateCodeError: string;
+        /** Read-only badge label for code field. */
+        readonlyCode: string;
+        /** Read-only badge label for name field. */
+        readonlyName: string;
+        /** ARIA labels for row actions. */
+        editTemplateAria: (code: string) => string;
+        removeTemplateAria: (code: string) => string;
+        /** Back to scope list button (header). */
+        backToScopes: string;
+    };
     dataSourceManager: {
         /** ARIA label of the dialog root. */
         dialogAriaLabel: string;
@@ -750,4 +832,55 @@ interface DataSourceConfigManagerProps {
 }
 declare function DataSourceConfigManager({ open, onClose }: DataSourceConfigManagerProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ActiveDragData, Canvas, Canvas as CanvasDnd, CanvasSimple, ConditionBuilder, type ConditionBuilderProps, DataSourceConfigManager, type DataSourceConfigManagerProps, DataSourceSelector, type DataSourceSelectorProps, type DeepPartial, DndManager, type DragEndActions, type EditorActions, EditorLabelsProvider, type EditorSelection, type EditorState, type EditorStore, EditorToolbar, type EditorView, FormEditor, type FormEditorProps, type HistoryEntry, type IEditorAdapter, type IEditorLabels, type OverDropData, PropertiesPanel, Toolbox, Toolbox as ToolboxDnd, ToolboxSimple, createDragEndHandler, frLabels as defaultLabels, enLabels, frLabels, mergeLabels, useEditorStore, useLabels };
+/**
+ * ScopeManagerDialog — admin CRUD for {@link IScope} entries.
+ *
+ * Mirrors the `FormTypesDialog` visual pattern (native modal, inline
+ * edit, delete-with-confirm) but persists through the editor adapter:
+ *   - `adapter.createScope(data)`
+ *   - `adapter.updateScope(id, data)`
+ *   - `adapter.deleteScope(id)` — server returns 409 if forms, templates,
+ *     or data sources still reference the scope; the dialog surfaces the
+ *     message inline in red.
+ *
+ * Provides a "Gérer les variables →" affordance per row that opens
+ * `VariableTemplateManager` scoped to that scope.
+ */
+interface ScopeManagerDialogProps {
+    open: boolean;
+    onClose: () => void;
+}
+declare function ScopeManagerDialog({ open, onClose }: ScopeManagerDialogProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * VariableTemplateManager — admin CRUD for {@link IVariableTemplate}
+ * entries within a single scope.
+ *
+ * Flow:
+ *   1. Mount: re-fetch `adapter.loadTemplates(scopeId)` to get an
+ *      authoritative list (the store may only carry templates of scopes
+ *      attached to the current form).
+ *   2. CRUD via adapter; optimistic updates on the local list, no refetch.
+ *
+ * Identity:
+ *   - `code` and `name` are immutable after creation (server enforces).
+ *     The edit form shows them disabled, with a "(immuable)" badge.
+ *
+ * Conditional fields:
+ *   - `options` editor surfaces only for select/multiselect/radio/checkbox/listradio.
+ *   - `expression` only for `calculated`.
+ *   - `dataSourceId` only for select/multiselect.
+ *
+ * Advanced section (collapsed by default): validationRules, conditions, style.
+ * These are surfaced as JSON textareas so admins can paste configurations
+ * already produced by the visual condition builder if needed.
+ */
+interface VariableTemplateManagerProps {
+    open: boolean;
+    onClose: () => void;
+    scopeId: string;
+    scopeName: string;
+}
+declare function VariableTemplateManager({ open, onClose, scopeId, scopeName, }: VariableTemplateManagerProps): react_jsx_runtime.JSX.Element | null;
+
+export { type ActiveDragData, Canvas, Canvas as CanvasDnd, CanvasSimple, ConditionBuilder, type ConditionBuilderProps, DataSourceConfigManager, type DataSourceConfigManagerProps, DataSourceSelector, type DataSourceSelectorProps, type DeepPartial, DndManager, type DragEndActions, type EditorActions, EditorLabelsProvider, type EditorSelection, type EditorState, type EditorStore, EditorToolbar, type EditorView, FormEditor, type FormEditorProps, type HistoryEntry, type IEditorAdapter, type IEditorLabels, type OverDropData, PropertiesPanel, ScopeManagerDialog, type ScopeManagerDialogProps, Toolbox, Toolbox as ToolboxDnd, ToolboxSimple, VariableTemplateManager, type VariableTemplateManagerProps, createDragEndHandler, frLabels as defaultLabels, enLabels, frLabels, mergeLabels, useEditorStore, useLabels };