@lesliechan721/aw 0.1.0-beta.5 → 0.1.0-beta.50

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

@@ -1,16 +1,84 @@
 import type { PlatformName, Scope } from '../types.js';
-import type { ProjectConfigStoreLayer } from '../utils/plugin-config.js';
+import type { PluginContentType } from './plugin-content.js';
 export type PortableBlockerCode = 'requiredConfigMissing' | 'portableSkillsCliMissing' | 'portableSkillsCliIncompatible' | 'portableScopeUnavailable' | 'portableValidationFailed';
-export type PluginInstallFilter = 'all' | 'uninstalled';
+export type PluginInstallFilter = 'all' | 'installed' | 'uninstalled' | 'updateAvailable' | 'attention' | 'project' | 'user';
+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' | 'array';
+    mode?: 'choices' | 'custom';
+    arrayItem?: {
+        rowId?: string;
+    };
+} | {
+    name: 'configObjectPropertyEditor';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    propertyKey?: string;
+    dynamic: boolean;
+    stage: 'key' | 'action' | 'choices' | 'custom';
+    arrayItem?: {
+        rowId?: string;
+    };
+} | {
+    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: 'portablePreparing';
+    pluginId: string;
 } | {
     name: 'portableSkillSelect';
     pluginId: string;
@@ -31,12 +99,21 @@ export type TuiRoute = {
     pluginId: string;
     code: PortableBlockerCode;
     diagnosticCode: string;
+    operationRecordId?: string;
 } | {
     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';
 } | {
     name: 'installPlacement';
     pluginId: string;
@@ -45,18 +122,34 @@ export type TuiRoute = {
     pluginId: string;
     view?: 'selection' | 'blocked';
 } | {
-    name: 'pluginDetail';
+    name: 'uninstallTargets';
     pluginId: string;
 } | {
-    name: 'platform';
+    name: 'dependencyPlacement';
     pluginId: string;
+} | {
+    name: 'dependencyPlacementEditor';
+    pluginId: string;
+    dependencyPluginId: string;
     platform: PlatformName;
 } | {
-    name: 'pluginAbout';
+    name: 'pluginDetail';
     pluginId: string;
+} | {
+    name: 'pluginContent';
+    pluginId: string;
+} | {
+    name: 'pluginMore';
+    pluginId: string;
+} | {
+    name: 'platform';
+    pluginId: string;
+    platform: PlatformName;
 } | {
     name: 'pluginTechnical';
     pluginId: string;
+    platform?: PlatformName;
+    scope?: Scope;
 } | {
     name: 'configLayer';
     pluginId: string;
@@ -68,31 +161,61 @@ export type TuiRoute = {
     pluginId: string;
     layer: {
         scope: Scope | 'effective';
-        projectLayer: ProjectConfigStoreLayer;
     };
+    view?: 'options' | 'values';
 } | {
     name: 'configFieldEditor';
     pluginId: string;
     layer: {
-        scope: Scope;
-        projectLayer: ProjectConfigStoreLayer;
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    editor: 'boolean' | 'number' | 'string' | 'object' | 'array';
+    mode?: 'choices' | 'custom';
+    arrayItem?: {
+        rowId?: string;
+    };
+} | {
+    name: 'configObjectPropertyEditor';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    fieldKey: string;
+    propertyKey?: string;
+    dynamic: boolean;
+    stage: 'key' | 'action' | 'choices' | 'custom';
+    arrayItem?: {
+        rowId?: string;
+    };
+} | {
+    name: 'configFieldAction';
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
     };
     fieldKey: string;
-    editor: 'enum' | 'boolean' | 'number' | 'string' | 'path' | 'sensitive';
 } | {
     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;
@@ -100,17 +223,45 @@ 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;
@@ -129,8 +280,19 @@ export interface TuiPageContext {
     scrollOffset?: number;
     query?: string;
     sourceTabId?: string;
+    focusedEntityId?: string;
+    focusedActionId?: string;
     installFilter?: PluginInstallFilter;
     configGroupId?: string;
+    projectSection?: 'declared' | 'extraInstalled';
+    projectStatusFilter?: 'all' | 'pending' | 'blocked' | 'unknown' | 'ready';
+    sourceTypeTab?: 'all' | 'git' | 'path';
+    contentTypeTab?: 'all' | PluginContentType;
+    platformSelectedScope?: Scope;
+    platformSelectionInitialized?: boolean;
+    entityLineOffset?: number;
+    autoPreparedRestore?: boolean;
+    autoPreparedUpdate?: boolean;
 }
 export interface TuiRouteFrame {
     route: TuiRoute;
@@ -138,15 +300,40 @@ 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;