@timeax/digital-service-engine 0.3.1 → 0.3.3

package/dist/react/index.d.cts

@@ -1042,12 +1042,6 @@ type BackendResult<T> = {
     error: BackendError;
 };
 type Result<T> = Promise<BackendResult<T>>;
-interface Actor {
-    readonly id: string;
-    readonly name?: string;
-    readonly roles?: readonly string[];
-    readonly meta?: Readonly<Record<string, unknown>>;
-}
 interface Author {
     readonly id: string;
     readonly name: string;
@@ -1072,12 +1066,26 @@ interface MergeResult {
     readonly conflicts?: number;
     readonly message?: string;
 }
+type WorkspaceLoadContext = Readonly<{
+    workspaceId: string;
+    actorId?: string;
+    branchId?: string;
+    since?: string | number;
+}>;
+type WorkspaceActorLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+}>;
+type WorkspaceBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    branchId: string;
+}>;
+type WorkspaceActorBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+    branchId: string;
+}>;
 type ServicesInput = readonly DgpServiceCapability[] | DgpServiceMap;
 interface ServicesBackend {
-    get(workspaceId: string): Result<ServicesInput>;
-    refresh(workspaceId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<ServicesInput>;
+    get(ctx: WorkspaceLoadContext): Result<ServicesInput>;
+    refresh(ctx: WorkspaceLoadContext): Result<ServicesInput>;
 }
 interface BranchParticipant {
     readonly id: string;
@@ -1094,10 +1102,8 @@ interface BranchParticipant {
     readonly updatedAt?: string;
 }
 interface BranchAccessBackend {
-    listParticipants(workspaceId: string, branchId: string): Result<readonly BranchParticipant[]>;
-    refreshParticipants(workspaceId: string, branchId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<readonly BranchParticipant[]>;
+    listParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
+    refreshParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
 }
 interface ServiceSnapshot {
     readonly schema_version: string;
@@ -1211,12 +1217,13 @@ interface FieldTemplate {
 }
 /** Narrow list/search input */
 interface TemplatesListParams {
-    readonly workspaceId: string;
-    readonly branchId?: string;
+    readonly workspaceId: WorkspaceLoadContext["workspaceId"];
+    readonly actorId?: WorkspaceLoadContext["actorId"];
+    readonly branchId?: WorkspaceLoadContext["branchId"];
     readonly q?: string;
     readonly tags?: readonly string[];
     readonly category?: string;
-    readonly since?: string | number;
+    readonly since?: WorkspaceLoadContext["since"];
 }
 interface TemplateCreateInput {
     readonly key?: string;
@@ -1264,23 +1271,23 @@ interface TemplatesBackend {
     refresh(params: Omit<TemplatesListParams, "q" | "tags" | "category">): Result<readonly FieldTemplate[]>;
 }
 interface AuthorsBackend {
-    list(workspaceId: string): Result<readonly Author[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
     get(authorId: string): Result<Author | null>;
-    refresh(workspaceId: string): Result<readonly Author[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
 }
 interface PermissionsBackend {
-    get(workspaceId: string, actor: Actor): Result<PermissionsMap>;
-    refresh(workspaceId: string, actor: Actor): Result<PermissionsMap>;
+    get(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
+    refresh(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
 }
 interface BranchesBackend {
-    list(workspaceId: string): Result<readonly Branch[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
     create(workspaceId: string, name: string, opts?: Readonly<{
         fromId?: string;
     }>): Result<Branch>;
     setMain(workspaceId: string, branchId: string): Result<Branch>;
     merge(workspaceId: string, sourceId: string, targetId: string): Result<MergeResult>;
     delete(workspaceId: string, branchId: string): Result<void>;
-    refresh(workspaceId: string): Result<readonly Branch[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
 }
 interface WorkspaceInfo {
     readonly id: string;
@@ -1295,10 +1302,7 @@ interface WorkspaceInfo {
  * This is intentionally transport-agnostic and minimal so other layers (e.g. canvas/comments)
  * can reuse it without redefining identity types.
  */
-interface BackendScope {
-    readonly workspaceId: string;
-    readonly actorId: string;
-    readonly branchId: string;
+interface BackendScope extends WorkspaceActorBranchLoadContext {
 }
 /**
  * Generic canvas comments backend contract.
@@ -1349,7 +1353,7 @@ interface CommentsBackend<ThreadDTO = unknown, MessageDTO = unknown, AnchorDTO =
  * - If branchId is provided -> branch-scoped policies
  * - If branchId is omitted  -> workspace-scoped policies
  */
-interface PolicyScope extends BackendScope {
+interface PolicyScope extends WorkspaceActorLoadContext {
 }
 interface PoliciesLoadResult {
     /** the raw JSON the host stored (authoring format) */
@@ -1476,6 +1480,7 @@ type DuplicateOptions = {
     nameStrategy?: (old?: string) => string | undefined;
     optionIdStrategy?: (old: string) => string;
 };
+type DuplicateManyOptions = Omit<DuplicateOptions, "id">;
 type EditorNodeLookup = {
     kind: "tag";
     data?: Tag;
@@ -1528,6 +1533,7 @@ declare class Editor {
     redo(): boolean;
     clearService(id: string): void;
     duplicate(ref: NodeRef, opts?: DuplicateOptions): string;
+    duplicateMany(ids: readonly string[], opts?: DuplicateManyOptions): string[];
     reLabel(id: string, nextLabel: string): void;
     setFieldName(fieldId: string, nextName: string | null | undefined): void;
     getLastPolicyDiagnostics(): PolicyDiagnostic[] | undefined;
@@ -1580,6 +1586,29 @@ declare class Editor {
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
+    removeMany(ids: readonly string[]): void;
+    clearServiceMany(ids: readonly string[]): void;
+    rebindMany(ids: readonly string[], targetTagId: string, opts?: {
+        allowTagCycles?: boolean;
+    }): void;
+    includeMany(receiverId: string, ids: readonly string[]): void;
+    excludeMany(receiverId: string, ids: readonly string[]): void;
+    clearRelationsMany(ids: readonly string[], mode?: "owned" | "incoming" | "both"): void;
+    renameLabelsMany(ids: readonly string[], input: {
+        prefix?: string;
+        suffix?: string;
+    }): void;
+    setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
+    clearFieldDefaultsMany(ids: readonly string[]): void;
+    clearFieldValidationMany(ids: readonly string[]): void;
+    autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
+        id?: string;
+        label: string;
+        value?: string | number;
+    }): void;
+    clearAllOptionsMany(ids: readonly string[]): void;
+    removeNoticesForNodes(ids: readonly string[]): void;
+    setNoticesVisibilityForNodes(ids: readonly string[], type: "public" | "private"): void;
     getNode(id: string): EditorNodeLookup;
     getFieldQuantityRule(id: string): QuantityRule | undefined;
     setFieldQuantityRule(id: string, rule: unknown): void;
@@ -1816,11 +1845,18 @@ type Adapter = {
     getInputPropsFromField?: (props: AdapterCtx) => any;
     toValue?: (value: any) => any;
 };
+type InputOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
 type InputDescriptor = {
     Component: React.ComponentType<Record<string, unknown>>;
     adapter?: Adapter;
     defaultProps?: Record<string, unknown>;
     ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
 };
 type VariantMap = Map<InputVariant, InputDescriptor>;
 type RegistryStore = Map<InputKind, VariantMap>;
@@ -1856,6 +1892,7 @@ declare function Provider({ children, initialRegistry, }: {
     initialRegistry?: Registry;
 }): react_jsx_runtime.JSX.Element;
 declare function useInputs(): InputsCtxValue;
+declare function useInputsMaybe(): InputsCtxValue | null;
 
 type InputWrapperProps = {
     field: Field;
@@ -2246,4 +2283,4 @@ type Props = {
 };
 declare function FallbackAddRegistrationDialog({ open, onClose, onSelect, }: Props): react_jsx_runtime.JSX.Element | null;
 
-export { type Adapter, type AdapterCtx, CanvasAPI, type EditorSettings, EventBus, type EventMap, FallbackAddCandidatesDialog, FallbackAddRegistrationDialog, FallbackDetailsPanel, FallbackEditor, type FallbackEditorData, FallbackEditorHeader, FallbackEditorProvider, type FallbackEditorProviderProps, FallbackRegistrationsPanel, FallbackServiceSidebar, FallbackSettingsPanel, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type InputDescriptor, type InputKind, type InputVariant, type InputWrapperProps, OrderFlowProvider, Provider, type RegistrationItem, type RegistrationScope, type Registry, type ServiceSummary, type ValidationMessage, type ValidationTone, VirtualServiceList, Wrapper, createInputRegistry, registerEntries, resolveInputDescriptor, useActiveFallbackRegistrations, useEligibleServiceList, useFallbackEditor, useFallbackEditorContext, useFormApi, useInputs, useOptionalFormApi, useOrderFlow, useOrderFlowContext, usePrimaryServiceList };
+export { type Adapter, type AdapterCtx, CanvasAPI, type EditorSettings, EventBus, type EventMap, FallbackAddCandidatesDialog, FallbackAddRegistrationDialog, FallbackDetailsPanel, FallbackEditor, type FallbackEditorData, FallbackEditorHeader, FallbackEditorProvider, type FallbackEditorProviderProps, FallbackRegistrationsPanel, FallbackServiceSidebar, FallbackSettingsPanel, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type InputDescriptor, type InputKind, type InputOptionCapability, type InputVariant, type InputWrapperProps, OrderFlowProvider, Provider, type RegistrationItem, type RegistrationScope, type Registry, type ServiceSummary, type ValidationMessage, type ValidationTone, VirtualServiceList, Wrapper, createInputRegistry, registerEntries, resolveInputDescriptor, useActiveFallbackRegistrations, useEligibleServiceList, useFallbackEditor, useFallbackEditorContext, useFormApi, useInputs, useInputsMaybe, useOptionalFormApi, useOrderFlow, useOrderFlowContext, usePrimaryServiceList };

package/dist/react/index.d.ts

@@ -1042,12 +1042,6 @@ type BackendResult<T> = {
     error: BackendError;
 };
 type Result<T> = Promise<BackendResult<T>>;
-interface Actor {
-    readonly id: string;
-    readonly name?: string;
-    readonly roles?: readonly string[];
-    readonly meta?: Readonly<Record<string, unknown>>;
-}
 interface Author {
     readonly id: string;
     readonly name: string;
@@ -1072,12 +1066,26 @@ interface MergeResult {
     readonly conflicts?: number;
     readonly message?: string;
 }
+type WorkspaceLoadContext = Readonly<{
+    workspaceId: string;
+    actorId?: string;
+    branchId?: string;
+    since?: string | number;
+}>;
+type WorkspaceActorLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+}>;
+type WorkspaceBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    branchId: string;
+}>;
+type WorkspaceActorBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+    branchId: string;
+}>;
 type ServicesInput = readonly DgpServiceCapability[] | DgpServiceMap;
 interface ServicesBackend {
-    get(workspaceId: string): Result<ServicesInput>;
-    refresh(workspaceId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<ServicesInput>;
+    get(ctx: WorkspaceLoadContext): Result<ServicesInput>;
+    refresh(ctx: WorkspaceLoadContext): Result<ServicesInput>;
 }
 interface BranchParticipant {
     readonly id: string;
@@ -1094,10 +1102,8 @@ interface BranchParticipant {
     readonly updatedAt?: string;
 }
 interface BranchAccessBackend {
-    listParticipants(workspaceId: string, branchId: string): Result<readonly BranchParticipant[]>;
-    refreshParticipants(workspaceId: string, branchId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<readonly BranchParticipant[]>;
+    listParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
+    refreshParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
 }
 interface ServiceSnapshot {
     readonly schema_version: string;
@@ -1211,12 +1217,13 @@ interface FieldTemplate {
 }
 /** Narrow list/search input */
 interface TemplatesListParams {
-    readonly workspaceId: string;
-    readonly branchId?: string;
+    readonly workspaceId: WorkspaceLoadContext["workspaceId"];
+    readonly actorId?: WorkspaceLoadContext["actorId"];
+    readonly branchId?: WorkspaceLoadContext["branchId"];
     readonly q?: string;
     readonly tags?: readonly string[];
     readonly category?: string;
-    readonly since?: string | number;
+    readonly since?: WorkspaceLoadContext["since"];
 }
 interface TemplateCreateInput {
     readonly key?: string;
@@ -1264,23 +1271,23 @@ interface TemplatesBackend {
     refresh(params: Omit<TemplatesListParams, "q" | "tags" | "category">): Result<readonly FieldTemplate[]>;
 }
 interface AuthorsBackend {
-    list(workspaceId: string): Result<readonly Author[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
     get(authorId: string): Result<Author | null>;
-    refresh(workspaceId: string): Result<readonly Author[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
 }
 interface PermissionsBackend {
-    get(workspaceId: string, actor: Actor): Result<PermissionsMap>;
-    refresh(workspaceId: string, actor: Actor): Result<PermissionsMap>;
+    get(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
+    refresh(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
 }
 interface BranchesBackend {
-    list(workspaceId: string): Result<readonly Branch[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
     create(workspaceId: string, name: string, opts?: Readonly<{
         fromId?: string;
     }>): Result<Branch>;
     setMain(workspaceId: string, branchId: string): Result<Branch>;
     merge(workspaceId: string, sourceId: string, targetId: string): Result<MergeResult>;
     delete(workspaceId: string, branchId: string): Result<void>;
-    refresh(workspaceId: string): Result<readonly Branch[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
 }
 interface WorkspaceInfo {
     readonly id: string;
@@ -1295,10 +1302,7 @@ interface WorkspaceInfo {
  * This is intentionally transport-agnostic and minimal so other layers (e.g. canvas/comments)
  * can reuse it without redefining identity types.
  */
-interface BackendScope {
-    readonly workspaceId: string;
-    readonly actorId: string;
-    readonly branchId: string;
+interface BackendScope extends WorkspaceActorBranchLoadContext {
 }
 /**
  * Generic canvas comments backend contract.
@@ -1349,7 +1353,7 @@ interface CommentsBackend<ThreadDTO = unknown, MessageDTO = unknown, AnchorDTO =
  * - If branchId is provided -> branch-scoped policies
  * - If branchId is omitted  -> workspace-scoped policies
  */
-interface PolicyScope extends BackendScope {
+interface PolicyScope extends WorkspaceActorLoadContext {
 }
 interface PoliciesLoadResult {
     /** the raw JSON the host stored (authoring format) */
@@ -1476,6 +1480,7 @@ type DuplicateOptions = {
     nameStrategy?: (old?: string) => string | undefined;
     optionIdStrategy?: (old: string) => string;
 };
+type DuplicateManyOptions = Omit<DuplicateOptions, "id">;
 type EditorNodeLookup = {
     kind: "tag";
     data?: Tag;
@@ -1528,6 +1533,7 @@ declare class Editor {
     redo(): boolean;
     clearService(id: string): void;
     duplicate(ref: NodeRef, opts?: DuplicateOptions): string;
+    duplicateMany(ids: readonly string[], opts?: DuplicateManyOptions): string[];
     reLabel(id: string, nextLabel: string): void;
     setFieldName(fieldId: string, nextName: string | null | undefined): void;
     getLastPolicyDiagnostics(): PolicyDiagnostic[] | undefined;
@@ -1580,6 +1586,29 @@ declare class Editor {
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
+    removeMany(ids: readonly string[]): void;
+    clearServiceMany(ids: readonly string[]): void;
+    rebindMany(ids: readonly string[], targetTagId: string, opts?: {
+        allowTagCycles?: boolean;
+    }): void;
+    includeMany(receiverId: string, ids: readonly string[]): void;
+    excludeMany(receiverId: string, ids: readonly string[]): void;
+    clearRelationsMany(ids: readonly string[], mode?: "owned" | "incoming" | "both"): void;
+    renameLabelsMany(ids: readonly string[], input: {
+        prefix?: string;
+        suffix?: string;
+    }): void;
+    setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
+    clearFieldDefaultsMany(ids: readonly string[]): void;
+    clearFieldValidationMany(ids: readonly string[]): void;
+    autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
+        id?: string;
+        label: string;
+        value?: string | number;
+    }): void;
+    clearAllOptionsMany(ids: readonly string[]): void;
+    removeNoticesForNodes(ids: readonly string[]): void;
+    setNoticesVisibilityForNodes(ids: readonly string[], type: "public" | "private"): void;
     getNode(id: string): EditorNodeLookup;
     getFieldQuantityRule(id: string): QuantityRule | undefined;
     setFieldQuantityRule(id: string, rule: unknown): void;
@@ -1816,11 +1845,18 @@ type Adapter = {
     getInputPropsFromField?: (props: AdapterCtx) => any;
     toValue?: (value: any) => any;
 };
+type InputOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
 type InputDescriptor = {
     Component: React.ComponentType<Record<string, unknown>>;
     adapter?: Adapter;
     defaultProps?: Record<string, unknown>;
     ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
 };
 type VariantMap = Map<InputVariant, InputDescriptor>;
 type RegistryStore = Map<InputKind, VariantMap>;
@@ -1856,6 +1892,7 @@ declare function Provider({ children, initialRegistry, }: {
     initialRegistry?: Registry;
 }): react_jsx_runtime.JSX.Element;
 declare function useInputs(): InputsCtxValue;
+declare function useInputsMaybe(): InputsCtxValue | null;
 
 type InputWrapperProps = {
     field: Field;
@@ -2246,4 +2283,4 @@ type Props = {
 };
 declare function FallbackAddRegistrationDialog({ open, onClose, onSelect, }: Props): react_jsx_runtime.JSX.Element | null;
 
-export { type Adapter, type AdapterCtx, CanvasAPI, type EditorSettings, EventBus, type EventMap, FallbackAddCandidatesDialog, FallbackAddRegistrationDialog, FallbackDetailsPanel, FallbackEditor, type FallbackEditorData, FallbackEditorHeader, FallbackEditorProvider, type FallbackEditorProviderProps, FallbackRegistrationsPanel, FallbackServiceSidebar, FallbackSettingsPanel, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type InputDescriptor, type InputKind, type InputVariant, type InputWrapperProps, OrderFlowProvider, Provider, type RegistrationItem, type RegistrationScope, type Registry, type ServiceSummary, type ValidationMessage, type ValidationTone, VirtualServiceList, Wrapper, createInputRegistry, registerEntries, resolveInputDescriptor, useActiveFallbackRegistrations, useEligibleServiceList, useFallbackEditor, useFallbackEditorContext, useFormApi, useInputs, useOptionalFormApi, useOrderFlow, useOrderFlowContext, usePrimaryServiceList };
+export { type Adapter, type AdapterCtx, CanvasAPI, type EditorSettings, EventBus, type EventMap, FallbackAddCandidatesDialog, FallbackAddRegistrationDialog, FallbackDetailsPanel, FallbackEditor, type FallbackEditorData, FallbackEditorHeader, FallbackEditorProvider, type FallbackEditorProviderProps, FallbackRegistrationsPanel, FallbackServiceSidebar, FallbackSettingsPanel, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type InputDescriptor, type InputKind, type InputOptionCapability, type InputVariant, type InputWrapperProps, OrderFlowProvider, Provider, type RegistrationItem, type RegistrationScope, type Registry, type ServiceSummary, type ValidationMessage, type ValidationTone, VirtualServiceList, Wrapper, createInputRegistry, registerEntries, resolveInputDescriptor, useActiveFallbackRegistrations, useEligibleServiceList, useFallbackEditor, useFallbackEditorContext, useFormApi, useInputs, useInputsMaybe, useOptionalFormApi, useOrderFlow, useOrderFlowContext, usePrimaryServiceList };