@ai-ecoverse/slicc-spectrum 1.3.0 → 1.5.0

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

@@ -2,7 +2,7 @@ import { type TemplateResult } from 'lit';
 import type { SliccDock } from '../components/dock.js';
 import type { SliccModel } from '../model/types.js';
 import { ThemedElement } from './base.js';
-import { type DocumentKind, type ScreenClass } from './panels.js';
+import { type DocumentKind, type ScreenClass, type Surface } from './panels.js';
 export declare class SliccApp extends ThemedElement {
     #private;
     static properties: {
@@ -12,8 +12,12 @@ export declare class SliccApp extends ThemedElement {
         screen: {
             reflect: boolean;
         };
+        surfaces: {
+            attribute: boolean;
+        };
     };
     screen: ScreenClass;
+    surfaces: readonly Surface[];
     storage: Storage | null;
     layoutKey: string;
     constructor();

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

@@ -45,12 +45,23 @@ export declare class SliccFileView extends ThemedElement {
         missing: {
             state: boolean;
         };
+        draft: {
+            state: boolean;
+        };
+        saving: {
+            state: boolean;
+        };
     };
     path: string;
     text: string | null;
     missing: boolean;
+    draft: string | null;
+    saving: boolean;
     constructor();
     static styles: import("lit").CSSResult[];
+    edit(): void;
+    cancel(): void;
+    save(): Promise<void>;
     protected subscribe(model: SliccModel): Array<() => void>;
     render(): TemplateResult;
 }

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

@@ -1,3 +1,11 @@
 export declare const defaultFontBase = "/fonts/";
+export interface FontFile {
+    family: string;
+    weight: number;
+    url: string;
+    format: 'woff2' | 'opentype';
+}
+export declare function fontFiles(base: string | null, codeBase: string): FontFile[];
 export declare function fontFaces(base: string | null, codeBase: string): string;
+export declare function installedFonts(): readonly FontFile[];
 export declare function installFonts(document: Document, base: string | null, codeBase: string): HTMLStyleElement;

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

@@ -0,0 +1,24 @@
+import { LitElement, type PropertyValues, type TemplateResult } from 'lit';
+type IconNode = Array<[string, Record<string, string | number>]>;
+type Library = Record<string, unknown> & {
+    icons: Record<string, IconNode>;
+};
+export declare function load(): Promise<Library>;
+export declare function pascal(name: string): string;
+export declare function svg(name: string, node: IconNode): string;
+export declare function icons(names: readonly unknown[]): Promise<Record<string, string>>;
+export declare class SliccLucide extends LitElement {
+    static properties: {
+        name: {};
+        markup: {
+            state: boolean;
+        };
+    };
+    name: string;
+    markup: string;
+    static styles: import("lit").CSSResult;
+    constructor();
+    protected willUpdate(changed: PropertyValues<this>): void;
+    render(): TemplateResult;
+}
+export {};

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

@@ -1,7 +1,8 @@
 import { nothing, type TemplateResult } from 'lit';
-import type { AssistantMessage, ErrorAction, LickChannel, LickMessage, LickState, MessagePart, SystemMessage, ToolCall, ToolMessage, UserMessage } from '../model/types.js';
+import type { AssistantMessage, ErrorAction, LickChannel, LickMessage, LickState, MessagePart, SliccModel, SystemMessage, ToolCall, ToolMessage, UserMessage } from '../model/types.js';
 export interface Handlers {
     color: 'light' | 'dark';
+    model: SliccModel | null;
     answer(questionId: string, answer: string): void;
     resolve(messageId: string, state: Exclude<LickState, 'pending'>): void;
     action(action: ErrorAction): void;

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

@@ -28,12 +28,12 @@ export declare const documents: Record<DocumentKind, {
     title(path: string): string;
 }>;
 export declare function screenClass(width: number): ScreenClass;
-export declare function surface(id: string): Surface | undefined;
+export declare function surface(id: string, items?: readonly Surface[]): Surface | undefined;
 export declare function create(tag: string, model: SliccModel, params?: PanelParams): HTMLElement;
 export declare function placement(dock: SliccDock, side: Side, screen: ScreenClass): Placement;
 export declare function openSurface(dock: SliccDock, item: Surface, screen: ScreenClass): void;
 export declare function openDocument(dock: SliccDock, kind: DocumentKind, path: string, screen: ScreenClass): string;
-export declare function defaultLayout(dock: SliccDock, screen: ScreenClass): void;
-export declare function closed(dock: SliccDock): Surface[];
+export declare function defaultLayout(dock: SliccDock, screen: ScreenClass, items?: readonly Surface[]): void;
+export declare function closed(dock: SliccDock, items?: readonly Surface[]): Surface[];
 export declare function sprinkleSurface(sprinkle: Sprinkle): Surface;
 export declare function openSprinkle(dock: SliccDock, sprinkle: Sprinkle, screen: ScreenClass): string;

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

@@ -20,11 +20,13 @@ import '@spectrum-web-components/icons-workflow/icons/sp-icon-add.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-checkmark.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-compare.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-contrast.js';
+import '@spectrum-web-components/icons-workflow/icons/sp-icon-edit.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-filter.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-checkmark-circle.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-data.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-history.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-lightbulb.js';
+import '@spectrum-web-components/icons-workflow/icons/sp-icon-save-floppy.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-globe-grid.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-code.js';
 import '@spectrum-web-components/icons-workflow/icons/sp-icon-folder.js';

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

@@ -1,7 +1,15 @@
 import { type TemplateResult } from 'lit';
 import type { SliccModel } from '../model/types.js';
 import { ThemedElement } from './base.js';
-export declare function themed(source: string, color: 'light' | 'dark'): string;
+import { type FontFile } from './fonts.js';
+export declare const bridge = "(() => {\n  const post = (message) => parent.postMessage(message, '*');\n  window.slicc = {\n    name: document.currentScript.dataset.name,\n    lick(event) {\n      const value = typeof event === 'string' ? { action: event } : event || {};\n      post({ type: 'slicc-lick', action: String(value.action || ''), data: value.data ?? null, target: value.target ?? null });\n    },\n  };\n  const wanted = new Set();\n  let timer = 0;\n  window.LucideIcons = {\n    render() {\n      for (const node of document.querySelectorAll('i[data-lucide]')) wanted.add(node.dataset.lucide);\n      clearTimeout(timer);\n      timer = setTimeout(() => post({ type: 'slicc-icons', names: [...wanted] }));\n    },\n  };\n  const swap = (found) => {\n    for (const node of document.querySelectorAll('i[data-lucide]')) {\n      const markup = found[node.dataset.lucide];\n      if (!markup) continue;\n      const template = document.createElement('template');\n      template.innerHTML = markup;\n      const svg = template.content.firstElementChild;\n      for (const { name, value } of node.attributes) {\n        if (name === 'class') svg.setAttribute('class', svg.getAttribute('class') + ' ' + value);\n        else if (name !== 'data-lucide') svg.setAttribute(name, value);\n      }\n      node.replaceWith(svg);\n    }\n  };\n  const fonts = (list) => {\n    for (const font of list) {\n      const face = new FontFace(font.family, font.data, { weight: String(font.weight) });\n      document.fonts.add(face);\n      face.load().catch(() => {});\n    }\n  };\n  addEventListener('message', (event) => {\n    if (event.source !== parent) return;\n    const message = event.data || {};\n    if (message.type === 'slicc-icons') swap(message.icons);\n    if (message.type === 'slicc-fonts') fonts(message.fonts);\n  });\n  const size = () => {\n    const style = getComputedStyle(document.body);\n    post({ type: 'slicc-size', height: Math.ceil(document.body.offsetHeight + parseFloat(style.marginTop) + parseFloat(style.marginBottom)) });\n  };\n  document.addEventListener('DOMContentLoaded', () => {\n    window.LucideIcons.render();\n    new ResizeObserver(size).observe(document.body);\n  });\n  post({ type: 'slicc-ready' });\n})();";
+export declare function frameDocument(source: string, color: 'light' | 'dark', name: string): string;
+export declare function fontData(url: string): Promise<ArrayBuffer | null>;
+export declare function frameFonts(files: readonly FontFile[], base: string): Promise<Array<{
+    family: string;
+    weight: number;
+    data: ArrayBuffer;
+}>>;
 export declare class SliccSprinkle extends ThemedElement {
     #private;
     static properties: {
@@ -9,8 +17,17 @@ export declare class SliccSprinkle extends ThemedElement {
             attribute: boolean;
         };
         sprinkle: {};
+        inline: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        height: {
+            state: boolean;
+        };
     };
     sprinkle: string;
+    inline: boolean;
+    height: number;
     constructor();
     static styles: import("lit").CSSResult;
     protected subscribe(model: SliccModel): Array<() => void>;

package/dist/types/kernel/files.d.ts

@@ -0,0 +1,20 @@
+import { Emitter } from '../model/emitter.js';
+import type { Change, FileEntry, FileEvents, FilePort } from '../model/types.js';
+export interface KernelFilesOptions {
+    skip?: readonly string[];
+    interval?: number;
+}
+export declare class KernelFiles extends Emitter<FileEvents> implements FilePort {
+    #private;
+    constructor(root: FileSystemDirectoryHandle, { skip, interval }?: KernelFilesOptions);
+    start(): void;
+    stop(): void;
+    refresh(): Promise<void>;
+    list(): Promise<readonly FileEntry[]>;
+    read(path: string): Promise<string>;
+    write(path: string, text: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    changes(): readonly Change[];
+    accept(): void;
+    revert(): Promise<void>;
+}

package/dist/types/kernel/idle.d.ts

@@ -0,0 +1,51 @@
+import { Emitter } from '../model/emitter.js';
+import type { Agent, AgentEvents, AgentPort, BrowserEvents, BrowserPort, BrowserTab, FrozenCone, Memory, MemoryEvents, MemoryPort, Message, MonitorEvents, MonitorPort, MonitorSnapshot, SprinkleEvents, SprinklePort, TrayEvents, TrayPort, TrayStatus, UserMessage } from '../model/types.js';
+export declare class IdleAgent extends Emitter<AgentEvents> implements AgentPort {
+    list(): readonly Agent[];
+    active(): string;
+    select(): void;
+    messages(): readonly Message[];
+    send(): Promise<void>;
+    stop(): void;
+    busy(): boolean;
+    queue(): readonly UserMessage[];
+    unqueue(): void;
+    suggestion(): string | null;
+    answer(): void;
+    resolveLick(): void;
+    compact(): void;
+    clear(): void;
+    setModel(): void;
+    createScoop(): Agent;
+    frozen(): readonly FrozenCone[];
+    freeze(): void;
+    thaw(): Agent | null;
+    discard(): void;
+}
+export declare class IdleBrowser extends Emitter<BrowserEvents> implements BrowserPort {
+    list(): readonly BrowserTab[];
+    active(): string | null;
+    activate(): void;
+    open(): BrowserTab;
+    navigate(): void;
+    close(): void;
+    screenshot(): Promise<string>;
+}
+export declare class IdleMemory extends Emitter<MemoryEvents> implements MemoryPort {
+    list(): readonly Memory[];
+    save(): Memory;
+    remove(): void;
+}
+export declare class IdleMonitor extends Emitter<MonitorEvents> implements MonitorPort {
+    snapshot(): MonitorSnapshot;
+    resync(): void;
+}
+export declare class IdleSprinkles extends Emitter<SprinkleEvents> implements SprinklePort {
+    list(): readonly [];
+    send(): void;
+}
+export declare class IdleTray extends Emitter<TrayEvents> implements TrayPort {
+    status(): TrayStatus;
+    reconnect(): void;
+    disconnect(): void;
+}

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

@@ -0,0 +1,17 @@
+import type { TerminalKernel } from '../kernel-backend.js';
+import type { SliccModel } from '../model/types.js';
+import { KernelFiles, type KernelFilesOptions } from './files.js';
+import { KernelTerminals, type KernelTerminalsOptions } from './terminals.js';
+export interface KernelModelOptions {
+    kernel: TerminalKernel;
+    root: FileSystemDirectoryHandle;
+    files?: KernelFilesOptions;
+    terminals?: KernelTerminalsOptions;
+    storage?: Storage | null;
+}
+export interface KernelModel extends SliccModel {
+    files: KernelFiles;
+    terminals: KernelTerminals;
+}
+export declare function idleModel(storage?: Storage | null): Omit<SliccModel, 'files' | 'terminals'>;
+export declare function createKernelModel({ kernel, root, files, terminals, storage, }: KernelModelOptions): KernelModel;

package/dist/types/kernel/terminals.d.ts

@@ -0,0 +1,21 @@
+import type { TerminalBackend } from '../backend.js';
+import { type TerminalKernel } from '../kernel-backend.js';
+import { Emitter } from '../model/emitter.js';
+import type { TerminalEvents, TerminalInfo, TerminalPort } from '../model/types.js';
+export interface KernelTerminalsOptions {
+    argv?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    open?: number;
+}
+export declare class KernelTerminals extends Emitter<TerminalEvents> implements TerminalPort {
+    #private;
+    constructor(kernel: TerminalKernel, { argv, cwd, env, open }?: KernelTerminalsOptions);
+    list(): readonly TerminalInfo[];
+    open({ cwd, agentId, }?: {
+        cwd?: string;
+        agentId?: string | null;
+    }): TerminalInfo;
+    close(id: string): void;
+    backend(id: string): TerminalBackend;
+}

package/dist/types/kernel.d.ts

@@ -0,0 +1,7 @@
+export type { KernelFilesOptions } from './kernel/files.js';
+export { KernelFiles } from './kernel/files.js';
+export { IdleAgent, IdleBrowser, IdleMemory, IdleMonitor, IdleSprinkles, IdleTray, } from './kernel/idle.js';
+export type { KernelModel, KernelModelOptions } from './kernel/index.js';
+export { createKernelModel, idleModel } from './kernel/index.js';
+export type { KernelTerminalsOptions } from './kernel/terminals.js';
+export { KernelTerminals } from './kernel/terminals.js';

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

@@ -123,6 +123,9 @@ export type MessagePart = {
     url: string;
     title: string;
     description: string;
+} | {
+    type: 'sprinkle';
+    sprinkle: string;
 } | {
     type: 'error';
     message: string;
@@ -402,6 +405,7 @@ export interface Sprinkle {
     icon: string;
     agentId: string;
     html: string;
+    inline?: boolean;
 }
 export interface SprinkleEvents {
     sprinkles: readonly Sprinkle[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Web components for SLICC on Spectrum Web Components: the terminal, the app shell and its surfaces",
   "type": "module",
   "license": "Apache-2.0",
@@ -33,6 +33,10 @@
     "./dummy": {
       "types": "./dist/types/dummy.d.ts",
       "default": "./dist/slicc-dummy.js"
+    },
+    "./kernel": {
+      "types": "./dist/types/kernel.d.ts",
+      "default": "./dist/slicc-kernel-model.js"
     }
   },
   "files": [
@@ -66,7 +70,7 @@
     }
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.7.2",
+    "@ai-ecoverse/slicc-kernel": "1.8.2",
     "@ai-ecoverse/slicc-shared-web": "1.4.1",
     "@ai-ecoverse/wasm-bash": "5.3.0-7",
     "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
@@ -95,6 +99,7 @@
     "esbuild": "0.28.2",
     "happy-dom": "20.14.5",
     "lefthook": "2.1.17",
+    "lucide": "1.52.0",
     "monocart-coverage-reports": "2.13.0",
     "playwright-core": "1.63.0",
     "semantic-release": "25.0.9",