@lesliechan721/aw 0.1.0-beta.10

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

@@ -0,0 +1,424 @@
+import type { PlatformName, PluginConfigFieldType, PluginConfigPreset, PluginConfigSchemaField, PluginConfigSchema, PluginConfigValue, Scope } from '../types.js';
+import type { StatusActivationProjection, StatusExtensionProjection, StatusIntentProjection, StatusSharedNativeProjection, StatusV7Payload, StatusV7PluginSummary, StatusV7Target, StatusV7Component, StatusTargetRevision, TargetRevisionState } from '../commands/status-v6.js';
+import type { DependencyAssignmentSource } from '../commands/dependency-operation-plan.js';
+import type { ReconcileOperationPlan } from '../commands/reconcile-operation-plan.js';
+import type { DependencyScopeOverride } from '../types.js';
+import type { ResolvedConfigRead } from '../utils/plugin-config.js';
+import { type DiagnosticSummaryViewModel } from './diagnostics.js';
+import type { CatalogSourceFreshnessViewModel } from './catalog-freshness.js';
+import type { CatalogSourceGenerationViewModel } from './catalog-generation.js';
+export type SourceHealthState = 'ready' | 'unavailable';
+export interface SourceHealthViewModel {
+    sourceId: string;
+    state: SourceHealthState;
+    issueId?: string;
+    message?: string;
+}
+export type PlatformPlacementSummary = {
+    platform: PlatformName;
+    state: 'notInstalled';
+    supportedScopes: Scope[];
+} | {
+    platform: PlatformName;
+    state: 'blocked';
+    supportedScopes: Scope[];
+    reason: 'artifactCollision';
+} | {
+    platform: PlatformName;
+    state: 'installed';
+    scope: Scope;
+    health: 'ready' | 'incomplete' | 'error';
+    revision: TargetRevisionState;
+    desiredScopes?: Scope[];
+    relation?: StatusIntentProjection['relation'];
+    actualState?: StatusV7Target['state'];
+    activation?: StatusActivationProjection;
+    sharedNative?: StatusSharedNativeProjection;
+    extensions?: StatusExtensionProjection;
+    recovery?: StatusV7Target['recoveryActions'];
+    blockingReason?: 'artifactCollision';
+} | {
+    platform: PlatformName;
+    state: 'scopeConflict';
+    placements: Array<{
+        scope: Scope;
+        health: 'ready' | 'incomplete' | 'error';
+        revision: TargetRevisionState;
+    }>;
+};
+export type PluginMenuAction = {
+    id: 'add' | 'manage' | 'repair' | 'sync' | 'portableSkills' | 'dependencies' | 'settings' | 'source' | 'sourceProblem' | 'about' | 'refreshSource' | 'technical' | 'back' | 'outputCollision' | 'upgradeAwCli' | 'capabilityTechnical';
+} | {
+    id: 'addScope';
+    platform: PlatformName;
+    scope: Scope;
+} | {
+    id: 'resolveScopeConflict';
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+    keepScope: Scope;
+    description: string;
+} | {
+    id: 'platform' | 'scopeConflict';
+    platform: PlatformName;
+} | {
+    id: 'refreshAndSync';
+    platform: PlatformName;
+    scope: Scope;
+    availableVersion: string;
+} | {
+    id: 'reinstall' | 'remove' | 'cleanup';
+    platform: PlatformName;
+    scope: Scope;
+};
+export interface PluginListItemViewModel {
+    pluginId: string;
+    sourceId: string;
+    displayName: string;
+    description: string;
+    version?: string;
+    configFieldCount: number;
+    sourceLabel: string;
+    supportedPlatforms: PlatformName[];
+    supportedScopes?: Partial<Record<PlatformName, Scope[]>>;
+    installedPlacements: PlatformPlacementSummary[];
+    aggregateStatus: 'available' | 'installed' | 'needsAttention' | 'unavailable';
+    primaryAttention?: {
+        severity: 'warning' | 'error';
+        code: string;
+        message: string;
+    };
+    portableSkills: boolean;
+    missingCapabilities?: string[];
+    capabilityUnsupported?: boolean;
+    capabilityRecovery?: string;
+    sourceUnavailable?: boolean;
+    dependencySummary?: PluginDependencySummaryViewModel;
+    technicalComponents: Array<{
+        platform: PlatformName;
+        scope: Scope;
+        key: string;
+        state: StatusV7Component['state'];
+        errorCode?: string;
+    }>;
+}
+export interface PluginDependencySummaryViewModel {
+    directCount: number;
+    transitiveCount: number;
+    totalCount: number;
+    readyCount: number;
+    missingCount: number;
+    issueCount: number;
+}
+export interface DependencyPlacementDescriptorViewModel {
+    platform: PlatformName;
+    scope: Scope;
+    project: 'current' | 'other' | null;
+}
+export interface DependencyPlacementReferenceViewModel {
+    consumer: DependencyPlacementDescriptorViewModel & {
+        pluginId: string;
+    };
+    dependency: DependencyPlacementDescriptorViewModel & {
+        pluginId: string;
+    };
+}
+export interface PluginDependencyItemViewModel {
+    pluginId: string;
+    displayName: string;
+    relation: 'direct' | 'transitive' | 'dependent';
+    depth: number;
+    requiredBy: Array<{
+        pluginId: string;
+        displayName: string;
+    }>;
+    placements: PlatformPlacementSummary[];
+    aggregateStatus: 'ready' | 'notInstalled' | 'needsAttention' | 'unavailable';
+    placementReferences?: DependencyPlacementReferenceViewModel[];
+}
+export interface PluginDependencyBlockerViewModel {
+    code: string;
+    title: string;
+    explanation: string;
+}
+export interface PluginDependencyOverviewViewModel {
+    pluginId: string;
+    summary: PluginDependencySummaryViewModel;
+    dependencies: PluginDependencyItemViewModel[];
+    dependents: PluginDependencyItemViewModel[];
+    blockers: PluginDependencyBlockerViewModel[];
+}
+export interface DependencyPlacementTargetViewModel {
+    key: string;
+    pluginId: string;
+    displayName: string;
+    platform: PlatformName;
+    relation: 'direct' | 'transitive';
+    scope: Scope;
+    minimumScope: Scope;
+    allowedScopes: Scope[];
+    locked: boolean;
+    requiredBy: string[];
+    assignmentSource: DependencyAssignmentSource;
+    explanation: string;
+    affectsOtherProjects: boolean;
+    action: ReconcileOperationPlan['targets'][number]['action'];
+}
+export interface InstallPlacementDraftViewModel {
+    pluginId: string;
+    rootScope: Scope;
+    platforms: PlatformName[];
+    dependencyScopeOverrides: DependencyScopeOverride[];
+    state: 'selecting' | 'loading' | 'ready' | 'blocked';
+    targets: DependencyPlacementTargetViewModel[];
+    canContinue: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface SourceTabViewModel {
+    id: string;
+    label: string;
+    count?: number;
+    primary: boolean;
+    state: 'ready' | 'checking' | 'update' | 'recovery' | 'error';
+}
+export interface SourceDetailViewModel {
+    id: string;
+    type: 'git' | 'path';
+    primary: boolean;
+    autoCheck: boolean;
+    locationSummary: string;
+    refPolicy?: 'cliChannel' | 'explicit';
+    explicitRef?: string;
+    subdir?: string;
+    pluginCount: number;
+    sourceIdentity: string;
+    requestedRef: string;
+    resolvedCommit?: string;
+    catalogVersion?: string;
+    channel?: string;
+    freshness?: 'active';
+    errorCode?: string;
+    configDigest: string;
+}
+export interface HomeSummaryViewModel {
+    availablePlugins: number;
+    installedPlugins: number;
+    issueCount: number;
+    sourceCount: number;
+    unavailableSourceCount: number;
+    catalogUpdateCount: number;
+    catalogRecoveryCount: number;
+    catalogCheckingCount: number;
+}
+export interface ConfigFieldViewModel {
+    key: string;
+    title: string;
+    description?: string;
+    type: PluginConfigFieldType;
+    definition: PluginConfigSchemaField;
+    displayValue: string;
+    required: boolean;
+    sensitive: boolean;
+    writable: boolean;
+    dirty: boolean;
+    inherited: boolean;
+    configured: boolean;
+    sourceLabel: string;
+    effectiveDisplayValue: string;
+    effectiveSourceLabel: string;
+    fallbackDisplayValue?: string;
+    fallbackSourceLabel?: string;
+    invalidOverrideIssue?: string;
+    invalidOverrideOwnedByLayer?: boolean;
+    fallbackObjectChanges?: Array<{
+        property: string;
+        before: string;
+        after: string;
+        private?: boolean;
+    }>;
+    value?: PluginConfigValue;
+    effectiveValue?: PluginConfigValue;
+    draftValue?: PluginConfigValue;
+    defaultValue?: PluginConfigValue;
+    choices?: PluginConfigPreset[];
+    allowCustom: boolean;
+    matchedPresetId?: string;
+    placeholder?: string;
+    unit?: string;
+    min?: number;
+    max?: number;
+    advanced: boolean;
+    sharedNativeRender?: boolean;
+}
+export interface ConfigGroupViewModel {
+    id: string;
+    title: string;
+    description?: string;
+    advanced: boolean;
+    fields: ConfigFieldViewModel[];
+}
+export interface ConfigPresetViewModel {
+    id: string;
+    title: string;
+    description?: string;
+    values: Record<string, PluginConfigValue>;
+    privateFieldTitles?: string[];
+}
+export interface ConfigPageViewModel {
+    pluginId: string;
+    layer: {
+        scope: Scope | 'effective';
+    };
+    groups: ConfigGroupViewModel[];
+    presets: ConfigPresetViewModel[];
+    storedCount: number;
+}
+export declare function configObjectHasSensitiveChild(field: PluginConfigSchemaField): boolean;
+export type UserIssueCategory = 'incompleteInstallation' | 'artifactCollision' | 'sourceUnavailable' | 'sourceMissing' | 'sourceIdentityChanged' | 'requiredConfigMissing' | 'scopeConflict' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'legacyState' | 'diagnostic';
+export type UserIssueGroup = 'sourceRemoved' | 'artifactCollision' | 'sourceUnavailable' | 'dependency' | 'scope' | 'config' | 'installation' | 'diagnostic';
+export type UserIssueActionId = 'install' | 'sync' | 'refreshAndSync' | 'reinstall' | 'cleanup' | 'remove' | 'refreshSource' | 'editSource' | 'retryLater' | 'reAddSource' | 'viewSourceChange' | 'openConfig' | 'keepUserScope' | 'keepProjectScope' | 'viewTechnical' | 'manualMigration' | 'installDependency' | 'reinstallDependency' | 'viewDependencyIssue' | 'viewDependencies';
+export interface UserIssueActionViewModel {
+    id: UserIssueActionId;
+    label: string;
+    description?: string;
+    pluginId?: string;
+    platform?: PlatformName;
+    scope?: Scope;
+    project?: 'current' | 'other' | null;
+    writeAction?: 'install' | 'refreshAndSync' | 'reinstall' | 'uninstall' | 'cleanup' | 'sync';
+}
+export type TargetIssueRootCode = 'partial' | 'artifactCollision' | 'sourceMissing' | 'sourceChanged' | 'catalogSourceUnavailable' | 'bundleUnavailable' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'targetDiagnostic';
+export interface TargetIssueEntityViewModel {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+}
+export interface AffectedTargetViewModel extends TargetIssueEntityViewModel {
+    relationship: 'direct' | 'consumer';
+}
+export interface UserIssueViewModel {
+    issueId: string;
+    category: UserIssueCategory;
+    group: UserIssueGroup;
+    title: string;
+    explanation: string;
+    impact: string[];
+    entity: {
+        kind: 'plugin' | 'source';
+        id: string;
+    };
+    pluginId?: string;
+    dependencyPluginId?: string;
+    dependencyPlatform?: PlatformName;
+    dependencyScope?: Scope;
+    dependencyProject?: 'current' | 'other' | null;
+    platform?: PlatformName;
+    scope?: Scope;
+    sourceId?: string;
+    sourceIdentity?: string;
+    rootCode?: TargetIssueRootCode;
+    mergeEligible?: boolean;
+    relationship?: 'direct' | 'consumer';
+    rootEntity?: TargetIssueEntityViewModel;
+    affectedTargets?: AffectedTargetViewModel[];
+    placements?: Scope[];
+    requiredFields?: Array<{
+        key: string;
+        title: string;
+        type: 'missing-required' | 'invalid-config' | 'sharedCompositeContainsLocalPath';
+        source: 'default' | 'user' | 'project' | 'missing';
+        scope: Scope;
+    }>;
+    configLayer?: {
+        scope: Scope;
+    };
+    actions: UserIssueActionViewModel[];
+    technicalDetails: Array<{
+        code: string;
+        message: string;
+    }>;
+    diagnostic: DiagnosticSummaryViewModel;
+}
+export interface TuiViewModel {
+    plugins: PluginListItemViewModel[];
+    sourceTabs: SourceTabViewModel[];
+    sourceDetails: SourceDetailViewModel[];
+    issues: UserIssueViewModel[];
+    home: HomeSummaryViewModel;
+    dependencyOverviews: PluginDependencyOverviewViewModel[];
+}
+export interface PortableSkillCandidateViewModel {
+    name: string;
+    description: string;
+    selected: boolean;
+    providerPluginId: string;
+    providerDisplayName: string;
+    relation: 'requested' | 'direct' | 'transitive';
+    dynamic: boolean;
+    availableScopes: Scope[];
+    scopeDetails: Partial<Record<Scope, {
+        description: string;
+        providerPluginId: string;
+        providerDisplayName: string;
+        relation: 'requested' | 'direct' | 'transitive';
+        dynamic: boolean;
+        filesDigest: string;
+    }>>;
+}
+export interface PortableSkillSelectionViewModel {
+    pluginId: string;
+    candidates: PortableSkillCandidateViewModel[];
+    selectedCount: number;
+    totalCount: number;
+    dependencySummary?: {
+        directCount: number;
+        transitiveCount: number;
+        contributingSkillCount: number;
+    };
+    canContinue: boolean;
+}
+export declare function isPureNativeCodexTarget(target: StatusV7Target): boolean;
+export declare function dependencyPlacementTargets(plan: ReconcileOperationPlan): DependencyPlacementTargetViewModel[];
+export declare function projectPlatformPlacement(platform: PlatformName, targets: StatusV7Target[], revisions?: StatusTargetRevision[]): PlatformPlacementSummary;
+export declare function buildPluginPreviewActions(plugin: PluginListItemViewModel): PluginMenuAction[];
+export declare function buildPluginDetailActions(plugin: PluginListItemViewModel): PluginMenuAction[];
+export declare function buildPlatformActions(plugin: PluginListItemViewModel, platform: PlatformName): PluginMenuAction[];
+export declare function hasInstalledPlacement(plugin: PluginListItemViewModel): boolean;
+export declare function buildTuiViewModel(options: {
+    status: StatusV7Payload;
+    pluginSummaries: StatusV7PluginSummary[];
+    targetRevisions?: StatusTargetRevision[];
+    sourceHealth?: ReadonlyMap<string, SourceHealthViewModel>;
+    sourceDetails?: SourceDetailViewModel[];
+    catalogFreshness?: ReadonlyMap<string, CatalogSourceFreshnessViewModel>;
+    catalogGenerations?: ReadonlyMap<string, CatalogSourceGenerationViewModel>;
+    dependencyOverviews?: PluginDependencyOverviewViewModel[];
+    portablePluginIds?: string[];
+}): TuiViewModel;
+export declare function buildConfigGroups(options: {
+    schema: PluginConfigSchema;
+    read: ResolvedConfigRead;
+    effectiveRead?: ResolvedConfigRead;
+    layerReads?: Partial<Record<Scope, ResolvedConfigRead>>;
+    dirtyKeys?: ReadonlySet<string>;
+    rawValues?: Record<string, PluginConfigValue>;
+    rawLayerValues?: Partial<Record<Scope, Record<string, PluginConfigValue>>>;
+    effectiveRawValues?: Record<string, PluginConfigValue>;
+    sharedNativeRefreshKeys?: ReadonlySet<string>;
+}): ConfigGroupViewModel[];
+export declare function buildConfigPage(options: {
+    pluginId: string;
+    schema: PluginConfigSchema;
+    read: ResolvedConfigRead;
+    effectiveRead?: ResolvedConfigRead;
+    layerReads?: Partial<Record<Scope, ResolvedConfigRead>>;
+    rawValues?: Record<string, PluginConfigValue>;
+    rawLayerValues?: Partial<Record<Scope, Record<string, PluginConfigValue>>>;
+    effectiveRawValues?: Record<string, PluginConfigValue>;
+    sharedNativeRefreshKeys?: ReadonlySet<string>;
+}): ConfigPageViewModel;
+export declare function configValuesEqual(left: PluginConfigValue | undefined, right: PluginConfigValue | undefined): boolean;