@ai-ecoverse/slicc-spectrum 1.41.0 → 1.43.0

package/dist/types/app/notices.d.ts

@@ -0,0 +1,33 @@
+import '@adobe/spectrum-wc/components/button/swc-button.js';
+import '@adobe/spectrum-wc/components/close-button/swc-close-button.js';
+import '@adobe/spectrum-wc-icons/swc-icon-alert-triangle.js';
+import '@adobe/spectrum-wc-icons/swc-icon-info-circle.js';
+import { nothing, type TemplateResult } from 'lit';
+import type { SliccModel } from '../model/types.js';
+import { ModelElement } from './base.js';
+export declare class SliccNotices extends ModelElement {
+    #private;
+    static properties: {
+        model: {
+            attribute: boolean;
+        };
+        dismissed: {
+            state: boolean;
+        };
+        pending: {
+            state: boolean;
+        };
+        failures: {
+            state: boolean;
+        };
+    };
+    dismissed: ReadonlySet<string>;
+    pending: ReadonlyMap<string, string>;
+    failures: ReadonlyMap<string, string>;
+    constructor();
+    static styles: import("lit").CSSResult;
+    protected subscribe(model: SliccModel): Array<() => void>;
+    dismiss(id: string): void;
+    act(id: string, action: string): Promise<void>;
+    render(): TemplateResult | typeof nothing;
+}

package/dist/types/app/updates.d.ts

@@ -4,8 +4,10 @@ import '@adobe/spectrum-wc/components/progress-bar/swc-progress-bar.js';
 import '@adobe/spectrum-wc/components/status-light/swc-status-light.js';
 import '@adobe/spectrum-wc-icons/swc-icon-alert-triangle.js';
 import { type TemplateResult } from 'lit';
-import type { SliccModel, UpdateAction, UpdateItem, UpdatesPort } from '../model/types.js';
+import type { PackageAction, PackageItem, SliccModel, UpdateAction, UpdateItem, UpdatesPort } from '../model/types.js';
 import { ModelElement } from './base.js';
+export declare function requiresText(item: PackageItem, all: readonly PackageItem[]): string | null;
+type Failures = ReadonlyMap<string, string>;
 export declare function updatesStatus(items: readonly UpdateItem[]): string | null;
 export declare class UpdateVisibility {
     #private;
@@ -24,13 +26,23 @@ export declare class SliccUpdates extends ModelElement {
         failures: {
             state: boolean;
         };
+        busy: {
+            state: boolean;
+        };
+        problems: {
+            state: boolean;
+        };
     };
     pending: ReadonlySet<string>;
-    failures: ReadonlyMap<string, string>;
+    failures: Failures;
+    busy: ReadonlyMap<string, PackageAction>;
+    problems: Failures;
     constructor();
     static styles: import("lit").CSSResult[];
     protected subscribe(model: SliccModel): Array<() => void>;
     focus(): void;
     act(id: string, action: UpdateAction): Promise<void>;
+    actPackage(id: string, action: PackageAction): Promise<void>;
     render(): TemplateResult;
 }
+export {};

package/dist/types/dummy/index.d.ts

@@ -2,18 +2,23 @@ import type { SliccModel } from '../model/types.js';
 import { type ChangesScenario } from './changes.js';
 import { type MountScenario } from './files.js';
 import { DummyNetwork, type NetworkScenario, type TailnetScenario } from './network.js';
-import { DummyUpdates, type UpdateScenario } from './updates.js';
+import { DummyNotices, type NoticeScenario } from './notices.js';
+import { DummyUpdates, type PackageConfirm, type PackageScenario, type UpdateScenario } from './updates.js';
 export interface DummyOptions {
     delay?: number;
     storage?: Storage | null;
     updates?: UpdateScenario;
+    packages?: PackageScenario | 'off';
+    confirm?: PackageConfirm;
     mounts?: MountScenario | 'off';
     network?: NetworkScenario | 'off';
     tailnet?: TailnetScenario;
     changes?: ChangesScenario;
+    notices?: NoticeScenario | 'off';
 }
 export interface DummyModel extends SliccModel {
     updates: DummyUpdates;
     network?: DummyNetwork;
+    notices?: DummyNotices;
 }
-export declare function createDummyModel({ delay, storage, updates, mounts, network, tailnet, changes, }?: DummyOptions): DummyModel;
+export declare function createDummyModel({ delay, storage, updates, packages, confirm, mounts, network, tailnet, changes, notices, }?: DummyOptions): DummyModel;

package/dist/types/dummy/notices.d.ts

@@ -0,0 +1,14 @@
+import { Emitter } from '../model/emitter.js';
+import type { Notice, NoticesPort } from '../model/types.js';
+import type { Clock } from './clock.js';
+export type NoticeScenario = 'storage' | 'mixed' | 'fail';
+export declare const noticeFixtures: Record<'storage' | 'welcome', Notice>;
+export declare class DummyNotices extends Emitter<{
+    notices: readonly Notice[];
+}> implements NoticesPort {
+    #private;
+    constructor(scenario: NoticeScenario, time: Clock);
+    list(): readonly Notice[];
+    act(id: string, action: string): Promise<void>;
+    dismiss(id: string): void;
+}

package/dist/types/dummy/updates.d.ts

@@ -1,13 +1,25 @@
 import { Emitter } from '../model/emitter.js';
-import type { UpdateAction, UpdateItem, UpdatesPort } from '../model/types.js';
+import type { PackageAction, PackageItem, UpdateAction, UpdateItem, UpdatesEvents, UpdatesPort } from '../model/types.js';
 import type { Clock } from './clock.js';
 export type UpdateScenario = 'current' | 'boot' | 'starting' | 'available' | 'restart' | 'failure';
+export type PackageScenario = 'mixed' | 'empty' | 'fail';
+export type PackageConfirm = (options: {
+    title: string;
+    body: string;
+    action: string;
+    variant: 'confirmation';
+}) => Promise<boolean>;
 export declare function updateFixtures(scenario: UpdateScenario): readonly UpdateItem[];
-export declare class DummyUpdates extends Emitter<{
-    items: readonly UpdateItem[];
-}> implements UpdatesPort {
+export declare function packageFixtures(scenario: PackageScenario): readonly PackageItem[];
+export interface DummyUpdatesOptions {
+    packages?: PackageScenario;
+    confirm?: PackageConfirm;
+}
+export declare class DummyUpdates extends Emitter<UpdatesEvents> implements UpdatesPort {
     #private;
-    constructor(scenario: UpdateScenario, clock: Clock);
+    packages?: () => readonly PackageItem[];
+    actPackage?: (id: string, action: PackageAction) => Promise<void>;
+    constructor(scenario: UpdateScenario, clock: Clock, options?: DummyUpdatesOptions);
     list(): readonly UpdateItem[];
     ready(): boolean;
     setScenario(scenario: UpdateScenario): void;

package/dist/types/dummy.d.ts

@@ -5,5 +5,7 @@ export type { DummyModel, DummyOptions } from './dummy/index.js';
 export { createDummyModel } from './dummy/index.js';
 export type { NetworkScenario, TailnetScenario } from './dummy/network.js';
 export { DummyNetwork, networkFixtures, tailnetFixtures } from './dummy/network.js';
-export type { UpdateScenario } from './dummy/updates.js';
-export { DummyUpdates, updateFixtures } from './dummy/updates.js';
+export type { NoticeScenario } from './dummy/notices.js';
+export { DummyNotices, noticeFixtures } from './dummy/notices.js';
+export type { DummyUpdatesOptions, PackageConfirm, PackageScenario, UpdateScenario, } from './dummy/updates.js';
+export { DummyUpdates, packageFixtures, updateFixtures } from './dummy/updates.js';

package/dist/types/model/types.d.ts

@@ -530,12 +530,38 @@ export interface UpdateItem {
     actions: readonly UpdateAction[];
     log?: string;
 }
-export interface UpdatesPort extends Subscribable<{
+export type PackageState = 'available' | 'queued' | 'installing' | 'installed' | 'outdated' | 'updating' | 'removing' | 'failed';
+export type PackageAction = 'install' | 'update' | 'remove' | 'retry';
+export interface PackageItem {
+    id: string;
+    package: string;
+    label: string;
+    description: string;
+    commands: readonly string[];
+    requires?: readonly string[];
+    state: PackageState;
+    version: string | null;
+    offered: string | null;
+    size?: number;
+    progress: {
+        phase: 'download' | 'link';
+        done: number;
+        total: number;
+    } | null;
+    error: string | null;
+    actions: readonly PackageAction[];
+    log?: string;
+}
+export interface UpdatesEvents {
     items: readonly UpdateItem[];
-}> {
+    packages: readonly PackageItem[];
+}
+export interface UpdatesPort extends Subscribable<UpdatesEvents> {
     list(): readonly UpdateItem[];
     ready(): boolean;
     act(id: string, action: UpdateAction): Promise<void>;
+    packages?(): readonly PackageItem[];
+    actPackage?(id: string, action: PackageAction): Promise<void>;
 }
 export type NetworkRoute = 'proxy' | 'extension' | 'tailnet' | 'page';
 export interface NetworkFailure {
@@ -587,6 +613,24 @@ export interface NetworkPort extends Subscribable<{
     submitAuthKey?(key: string): Promise<void>;
     logoutTailnet?(): Promise<void>;
 }
+export interface NoticeAction {
+    id: string;
+    label: string;
+}
+export interface Notice {
+    id: string;
+    tone: 'info' | 'warning';
+    title: string;
+    body: string;
+    actions: readonly NoticeAction[];
+}
+export interface NoticesPort extends Subscribable<{
+    notices: readonly Notice[];
+}> {
+    list(): readonly Notice[];
+    act(id: string, action: string): Promise<void>;
+    dismiss(id: string): void;
+}
 export interface SliccModel {
     agent: AgentPort;
     files: FilePort;
@@ -600,4 +644,5 @@ export interface SliccModel {
     updates?: UpdatesPort;
     network?: NetworkPort;
     changes?: ChangesPort;
+    notices?: NoticesPort;
 }

package/dist/types/ui.d.ts

@@ -8,6 +8,7 @@ import { SliccComposer } from './app/composer.js';
 import { SliccConfirm, SliccPrompt } from './app/confirm.js';
 import { SliccFiles, SliccFileView } from './app/files.js';
 import { SliccNetwork } from './app/network.js';
+import { SliccNotices } from './app/notices.js';
 import { SliccUpdates } from './app/updates.js';
 import { SliccCodeView, SliccDiffView } from './components/code-view.js';
 import { SliccDock } from './components/dock.js';
@@ -26,5 +27,5 @@ export type { GitStatusEntry } from './components/file-tree.js';
 export type { Listener, Subscribable } from './model/emitter.js';
 export { Emitter } from './model/emitter.js';
 export type * from './model/types.js';
-export { SliccAgents, SliccApp, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccNetwork, SliccPrompt, SliccUpdates, };
+export { SliccAgents, SliccApp, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccNetwork, SliccNotices, SliccPrompt, SliccUpdates, };
 export declare function define(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.41.0",
+  "version": "1.43.0",
   "description": "Web components for SLICC on Spectrum Web Components: the terminal, the app shell and its surfaces",
   "type": "module",
   "license": "Apache-2.0",