@lesliechan721/aw 0.1.0-beta.3 → 0.1.0-beta.31

package/dist/src/tui/router.d.ts

@@ -1,18 +1,81 @@
 import type { PlatformName, Scope } from '../types.js';
-import type { ProjectConfigStoreLayer } from '../utils/plugin-config.js';
 export type PortableBlockerCode = 'requiredConfigMissing' | 'portableSkillsCliMissing' | 'portableSkillsCliIncompatible' | 'portableScopeUnavailable' | 'portableValidationFailed';
+export type PluginInstallFilter = 'all' | 'installed' | 'uninstalled' | 'updateAvailable' | 'attention';
+export interface ConfigInvalidStoreEvidence {
+    scope: Scope;
+    code: 'invalidJson' | 'schemaVersionUnsupported' | 'identityMismatch' | 'invalidValues';
+    pathSummary: string;
+}
+export type ConfigResumeRoute = {
+    name: 'configFields';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+} | {
+    name: 'configFieldEditor';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    editor: 'boolean' | 'number' | 'string' | 'object';
+    mode?: 'choices' | 'custom';
+} | {
+    name: 'configObjectPropertyEditor';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    propertyKey?: string;
+    dynamic: boolean;
+    stage: 'key' | 'action' | 'choices' | 'custom';
+} | {
+    name: 'configFieldAction';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+};
 export type TuiRoute = {
     name: 'home';
+} | {
+    name: 'projectStatus';
 } | {
     name: 'pluginList';
     mode: 'browse' | 'installed';
     sourceId?: string;
+} | {
+    name: 'pluginWriteTask';
+    pluginId: string;
+    goal: 'restore' | 'update';
+    targetKeys?: string[];
+    versionEvidence?: Record<string, string>;
+    recommendedPluginIds?: string[];
+    batchOrigin?: {
+        flowId: string;
+        owner: 'batch-write';
+    };
+} | {
+    name: 'batchSelection';
+} | {
+    name: 'batchInstallPlatforms';
+} | {
+    name: 'batchInstallScope';
+} | {
+    name: 'batchPlacement';
 } | {
     name: 'pluginPreview';
     pluginId: string;
 } | {
     name: 'portableSkillSelect';
     pluginId: string;
+} | {
+    name: 'portableSkillSummary';
+    pluginId: string;
+    skillName: string;
 } | {
     name: 'portableDependencies';
     pluginId: string;
@@ -34,18 +97,43 @@ export type TuiRoute = {
     name: 'pluginDependencies';
     pluginId: string;
     view?: 'relations' | 'removeBlocked';
+    direction?: 'dependencies' | 'dependents';
     platform?: PlatformName;
     scope?: Scope;
+} | {
+    name: 'pluginDependencyNode';
+    pluginId: string;
+    nodePluginId: string;
+    direction: 'dependencies' | 'dependents';
+    nodePathPluginIds?: string[];
+    view?: 'summary' | 'references' | 'details';
 } | {
     name: 'installPlacement';
     pluginId: string;
 } | {
-    name: 'installTools';
+    name: 'installTargets';
     pluginId: string;
     view?: 'selection' | 'blocked';
+} | {
+    name: 'uninstallTargets';
+    pluginId: string;
+} | {
+    name: 'dependencyPlacement';
+    pluginId: string;
+} | {
+    name: 'dependencyPlacementEditor';
+    pluginId: string;
+    dependencyPluginId: string;
+    platform: PlatformName;
 } | {
     name: 'pluginDetail';
     pluginId: string;
+} | {
+    name: 'pluginContent';
+    pluginId: string;
+} | {
+    name: 'pluginMore';
+    pluginId: string;
 } | {
     name: 'platform';
     pluginId: string;
@@ -59,42 +147,62 @@ export type TuiRoute = {
 } | {
     name: 'configLayer';
     pluginId: string;
+    fieldKey?: string;
+    groupId?: string;
+    presetId?: string;
 } | {
     name: 'configFields';
     pluginId: string;
     layer: {
         scope: Scope | 'effective';
-        projectLayer: ProjectConfigStoreLayer;
     };
-    groupId?: string;
 } | {
     name: 'configFieldEditor';
     pluginId: string;
     layer: {
-        scope: Scope;
-        projectLayer: ProjectConfigStoreLayer;
+        scope: Scope | 'effective';
     };
     fieldKey: string;
-    editor: 'enum' | 'boolean' | 'number' | 'string' | 'path' | 'sensitive';
+    editor: 'boolean' | 'number' | 'string' | 'object';
+    mode?: 'choices' | 'custom';
 } | {
-    name: 'configPresets';
+    name: 'configObjectPropertyEditor';
     pluginId: string;
     layer: {
-        scope: Scope;
-        projectLayer: ProjectConfigStoreLayer;
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    propertyKey?: string;
+    dynamic: boolean;
+    stage: 'key' | 'action' | 'choices' | 'custom';
+} | {
+    name: 'configFieldAction';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
     };
+    fieldKey: string;
 } | {
     name: 'configUnavailable';
     pluginId: string;
+    overviewFrameId?: string;
     layer?: {
         scope: Scope;
-        projectLayer: ProjectConfigStoreLayer;
     };
+    invalidStores?: ConfigInvalidStoreEvidence[];
+    diagnosticCode?: string;
+    diagnosticStage?: string;
+    resumeRoute?: ConfigResumeRoute;
+    resumeContext?: Pick<TuiPageContext, 'configGroupId' | 'focusIndex' | 'scrollOffset'>;
+    storedScopes?: Scope[];
 } | {
     name: 'sourceList';
 } | {
     name: 'sourceDetail';
     sourceId: string;
+} | {
+    name: 'sourceMore';
+    sourceId: string;
 } | {
     name: 'sourceTechnical';
     sourceId: string;
@@ -102,17 +210,48 @@ export type TuiRoute = {
     name: 'sourceAdd';
     step: 'type' | 'id' | 'location' | 'refPolicy' | 'ref' | 'subdir';
     owner: string;
+    returnToDraft?: true;
 } | {
     name: 'sourceEdit';
     sourceId: string;
+    owner?: string;
+} | {
+    name: 'sourceSave';
+    owner: string;
+    view?: 'summary' | 'changes';
+} | {
+    name: 'configSave';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    view?: 'summary' | 'changes';
+} | {
+    name: 'scriptTimeout';
+    owner: string;
 } | {
     name: 'sourceRemoveBlocked';
     sourceId: string;
+} | {
+    name: 'catalogStoreOverview';
+} | {
+    name: 'catalogStoreRules';
 } | {
     name: 'issueList';
 } | {
     name: 'issueDetail';
     issueId: string;
+} | {
+    name: 'operationHistory';
+} | {
+    name: 'operationDiagnostic';
+    recordId: string;
+} | {
+    name: 'operationReportPreview';
+    recordId: string;
+} | {
+    name: 'reviewPreparing';
+    preparationId: string;
 } | {
     name: 'review';
     operationId: string;
@@ -128,6 +267,11 @@ export interface TuiPageContext {
     scrollOffset?: number;
     query?: string;
     sourceTabId?: string;
+    focusedEntityId?: string;
+    installFilter?: PluginInstallFilter;
+    configGroupId?: string;
+    autoPreparedRestore?: boolean;
+    autoPreparedUpdate?: boolean;
 }
 export interface TuiRouteFrame {
     route: TuiRoute;
@@ -135,15 +279,43 @@ export interface TuiRouteFrame {
 }
 export interface TuiRouterSnapshot {
     current: TuiRouteFrame;
+    currentFrameId: string;
+    currentFlowId?: string;
     depth: number;
 }
+export type TuiFlowKind = 'pluginInstall' | 'pluginMaintenance' | 'configEdit' | 'sourceEdit' | 'sourceRecovery' | 'catalogStore' | 'portableInstall' | 'batchWrite' | 'pluginWriteTask';
+export interface TuiFlowScope {
+    id: string;
+    kind: TuiFlowKind;
+    parentFlowId?: string;
+    originFrameId: string;
+    returnTarget: TuiRoute;
+    returnContext?: TuiPageContext;
+}
 export declare class TuiRouter {
     #private;
     get snapshot(): TuiRouterSnapshot;
     push(route: TuiRoute, context?: TuiPageContext): TuiRouterSnapshot;
     replace(route: TuiRoute, context?: TuiPageContext): TuiRouterSnapshot;
     updateContext(update: Partial<TuiPageContext>): TuiRouterSnapshot;
+    normalizeRoutes(normalize: (route: TuiRoute) => TuiRoute): TuiRouterSnapshot;
     back(): TuiRouterSnapshot;
+    beginFlow(kind: TuiFlowKind, returnTarget?: TuiRoute, originFrameId?: string, returnContext?: TuiPageContext): TuiFlowScope;
+    beginPluginFlow(kind: Extract<TuiFlowKind, 'pluginInstall' | 'pluginMaintenance'>, pluginId: string): TuiFlowScope;
+    beginBatchFlow(): TuiFlowScope;
+    activeFlow(): TuiFlowScope | undefined;
+    finishFlow(target?: TuiRoute, terminalRoute?: TuiRoute): TuiRouterSnapshot | undefined;
+    finishFlowById(flowId: string, expectedKind: TuiFlowKind, target?: TuiRoute, terminalRoute?: TuiRoute): TuiRouterSnapshot | undefined;
+    returnToBatchSelection(flowId: string): TuiRouterSnapshot | undefined;
+    configOverviewFrameId(flowId: string | undefined, pluginId: string): string | undefined;
+    returnToConfigOverview(flowId: string | undefined, overviewFrameId: string | undefined, pluginId: string, context?: TuiPageContext): TuiRouterSnapshot | undefined;
+    abandonFlow(flowId: string): TuiRouterSnapshot | undefined;
+    resetToRoot(route?: Extract<TuiRoute, {
+        name: 'home';
+    }>): TuiRouterSnapshot;
+    beginConfigFlow(pluginId: string): TuiRoute;
+    configOrigin(pluginId: string): TuiRoute | undefined;
+    resetConfigFlow(pluginId: string, target?: TuiRoute): TuiRouterSnapshot | undefined;
     beginPortableFlow(pluginId: string): TuiRoute;
     portableOrigin(pluginId: string): TuiRoute;
     discardSourceFlow(owner: string, returnRoute: Extract<TuiRoute, {