@msbci/form-editor 1.3.2 → 1.3.3

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode, ComponentType } from 'react';
-import { IFormDefinition, IFormPage, IFormRoster, IFormVariable, IVariableTemplate, IVariableTemplateOverrides, IFormType, IDataSourceConnector, VariableType, RosterType, IConditionRule, IRosterVariableRef } from '@msbci/form-core';
+import { IFormDefinition, IFormPage, IFormRoster, IFormVariable, IVariableTemplate, IVariableTemplateOverrides, IFormType, IScope, IDataSourceConnector, VariableType, RosterType, IConditionRule, IRosterVariableRef } from '@msbci/form-core';
 export { IDataSourceConnector, IFormDefinition, IFormPage, IFormRoster, IFormVariable, IMosobiThemeBase } from '@msbci/form-core';
 import * as zustand from 'zustand';
 import { DragEndEvent } from '@dnd-kit/core';
@@ -47,6 +47,12 @@ interface IEditorAdapter {
      * shows the {@link IEditorLabels.toolbox.noTemplates} message.
      */
     loadTemplates?: (scopeId: string) => Promise<IVariableTemplate[]>;
+    /**
+     * Optional — fetch every scope the user can attach to a form.
+     * When absent, the FormProperties scope selector shows a static
+     * empty list (the user can no longer pick from existing scopes).
+     */
+    loadScopes?: () => Promise<IScope[]>;
 }
 /** Complete editor state */
 interface EditorState {
@@ -62,15 +68,21 @@ interface EditorState {
     /**
      * Variable templates surfaced to the "Variables" toolbox tab. Populated
      * via `setAvailableTemplates` (typically by `FormEditor` after
-     * `adapter.loadTemplates(form.scopeId)`). Out of the undo/redo history —
-     * this is editor-UI state, not form state.
+     * `adapter.loadTemplates(form.scopeIds[N])` for every linked scope).
+     * Out of the undo/redo history — this is editor-UI state, not form state.
      */
     availableTemplates: IVariableTemplate[];
+    /**
+     * Scopes the user can attach to a form (FormProperties picker).
+     * Populated via `setAvailableScopes` (typically by `FormEditor` after
+     * `adapter.loadScopes()`). Out of the undo/redo history.
+     */
+    availableScopes: IScope[];
 }
 /** Editor actions */
 interface EditorActions {
     setForm: (form: IFormDefinition) => void;
-    updateFormMeta: (updates: Partial<Pick<IFormDefinition, 'name' | 'code' | 'description' | 'formTypeId' | 'version' | 'langConfig'>>) => void;
+    updateFormMeta: (updates: Partial<Pick<IFormDefinition, 'name' | 'code' | 'description' | 'formTypeId' | 'version' | 'langConfig' | 'scopeIds'>>) => void;
     addPage: (page: IFormPage) => void;
     updatePage: (pageCode: string, updates: Partial<IFormPage>) => void;
     removePage: (pageCode: string) => void;
@@ -120,6 +132,8 @@ interface EditorActions {
     removeFormType: (id: string) => void;
     /** Replace the variable-template list shown in the Variables tab. */
     setAvailableTemplates: (templates: IVariableTemplate[]) => void;
+    /** Replace the scope list shown in the FormProperties scope picker. */
+    setAvailableScopes: (scopes: IScope[]) => void;
     setAdapter: (adapter: IEditorAdapter) => void;
     save: () => Promise<void>;
     load: (formId: string) => Promise<void>;
@@ -147,6 +161,8 @@ interface IEditorLabels {
         formNamePlaceholder: string;
         unsaved: string;
         addPage: string;
+        /** Header button that opens the FormProperties panel (selection = form). */
+        formProperties: string;
         types: string;
         manageFormTypesTitle: string;
         undo: string;
@@ -294,6 +310,12 @@ interface IEditorLabels {
         readonly: string;
         hidden: string;
         expression: string;
+        scopes: string;
+        scopesHint: string;
+        noScopesAvailable: string;
+        moveScopeUp: string;
+        moveScopeDown: string;
+        removeScope: string;
         langConfigSection: string;
         langConfigAvailable: string;
         langConfigDefault: string;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode, ComponentType } from 'react';
-import { IFormDefinition, IFormPage, IFormRoster, IFormVariable, IVariableTemplate, IVariableTemplateOverrides, IFormType, IDataSourceConnector, VariableType, RosterType, IConditionRule, IRosterVariableRef } from '@msbci/form-core';
+import { IFormDefinition, IFormPage, IFormRoster, IFormVariable, IVariableTemplate, IVariableTemplateOverrides, IFormType, IScope, IDataSourceConnector, VariableType, RosterType, IConditionRule, IRosterVariableRef } from '@msbci/form-core';
 export { IDataSourceConnector, IFormDefinition, IFormPage, IFormRoster, IFormVariable, IMosobiThemeBase } from '@msbci/form-core';
 import * as zustand from 'zustand';
 import { DragEndEvent } from '@dnd-kit/core';
@@ -47,6 +47,12 @@ interface IEditorAdapter {
      * shows the {@link IEditorLabels.toolbox.noTemplates} message.
      */
     loadTemplates?: (scopeId: string) => Promise<IVariableTemplate[]>;
+    /**
+     * Optional — fetch every scope the user can attach to a form.
+     * When absent, the FormProperties scope selector shows a static
+     * empty list (the user can no longer pick from existing scopes).
+     */
+    loadScopes?: () => Promise<IScope[]>;
 }
 /** Complete editor state */
 interface EditorState {
@@ -62,15 +68,21 @@ interface EditorState {
     /**
      * Variable templates surfaced to the "Variables" toolbox tab. Populated
      * via `setAvailableTemplates` (typically by `FormEditor` after
-     * `adapter.loadTemplates(form.scopeId)`). Out of the undo/redo history —
-     * this is editor-UI state, not form state.
+     * `adapter.loadTemplates(form.scopeIds[N])` for every linked scope).
+     * Out of the undo/redo history — this is editor-UI state, not form state.
      */
     availableTemplates: IVariableTemplate[];
+    /**
+     * Scopes the user can attach to a form (FormProperties picker).
+     * Populated via `setAvailableScopes` (typically by `FormEditor` after
+     * `adapter.loadScopes()`). Out of the undo/redo history.
+     */
+    availableScopes: IScope[];
 }
 /** Editor actions */
 interface EditorActions {
     setForm: (form: IFormDefinition) => void;
-    updateFormMeta: (updates: Partial<Pick<IFormDefinition, 'name' | 'code' | 'description' | 'formTypeId' | 'version' | 'langConfig'>>) => void;
+    updateFormMeta: (updates: Partial<Pick<IFormDefinition, 'name' | 'code' | 'description' | 'formTypeId' | 'version' | 'langConfig' | 'scopeIds'>>) => void;
     addPage: (page: IFormPage) => void;
     updatePage: (pageCode: string, updates: Partial<IFormPage>) => void;
     removePage: (pageCode: string) => void;
@@ -120,6 +132,8 @@ interface EditorActions {
     removeFormType: (id: string) => void;
     /** Replace the variable-template list shown in the Variables tab. */
     setAvailableTemplates: (templates: IVariableTemplate[]) => void;
+    /** Replace the scope list shown in the FormProperties scope picker. */
+    setAvailableScopes: (scopes: IScope[]) => void;
     setAdapter: (adapter: IEditorAdapter) => void;
     save: () => Promise<void>;
     load: (formId: string) => Promise<void>;
@@ -147,6 +161,8 @@ interface IEditorLabels {
         formNamePlaceholder: string;
         unsaved: string;
         addPage: string;
+        /** Header button that opens the FormProperties panel (selection = form). */
+        formProperties: string;
         types: string;
         manageFormTypesTitle: string;
         undo: string;
@@ -294,6 +310,12 @@ interface IEditorLabels {
         readonly: string;
         hidden: string;
         expression: string;
+        scopes: string;
+        scopesHint: string;
+        noScopesAvailable: string;
+        moveScopeUp: string;
+        moveScopeDown: string;
+        removeScope: string;
         langConfigSection: string;
         langConfigAvailable: string;
         langConfigDefault: string;