@silo-code/sdk 0.6.0

package/dist/editor-service.d.ts

@@ -0,0 +1,175 @@
+import type { Disposable } from "./types";
+/**
+ * Options for the editor open methods.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface OpenFileOptions {
+    /** Target workspace. Defaults to the active workspace. */
+    workspaceId?: string;
+    /**
+     * Open as a preview tab (single-click style — replaced by the next preview,
+     * italic title) instead of a permanent editor. Defaults to false.
+     */
+    preview?: boolean;
+    /**
+     * Open with a specific editor view — an {@link Editor.id}, e.g. from an
+     * "Open With" menu. Persisted on the tab as {@link EditorRecord.viewType}.
+     * Ignored if no registered editor with that id matches the path (the host
+     * falls back to the highest-priority match). When omitted the default view is
+     * used and any existing tab's view is left unchanged.
+     */
+    viewType?: string;
+}
+/**
+ * One editor view that can render a given file — its id, user-facing label, and
+ * whether it is the view the host would pick by default. Returned by
+ * {@link EditorService.editorsFor}; used to build "Open With" menus and the
+ * breadcrumb view-switcher.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface EditorViewInfo {
+    /** The editor's id (an {@link Editor.id}); pass back as `viewType`. */
+    id: string;
+    /** Human-facing label (falls back to {@link EditorViewInfo.id}). */
+    label: string;
+    /** True for the editor the host resolves by default (highest priority). */
+    isDefault: boolean;
+}
+/**
+ * Save callbacks an editor viewer registers via
+ * {@link EditorService.registerSaveHandler}, so the active-editor `save` /
+ * `saveAs` commands can dispatch to whichever editor is focused.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface EditorSaveHandlers {
+    /** Save the editor's contents. */
+    save: () => void | Promise<void>;
+    /** Save-as (prompt for a new path). Optional. */
+    saveAs?: () => void | Promise<void>;
+}
+/**
+ * What to open in a diff view, passed to {@link EditorService.openDiff}. The
+ * diff is **generic** — it renders two contents and knows nothing about where
+ * they come from. `providerId` names a {@link DiffContentProvider} (registered
+ * via {@link EditorService.registerDiffContentProvider}) that resolves the two
+ * sides; `args` is the serializable payload that provider needs (e.g. a git
+ * revision/mode) and is persisted so the content can be recomputed on restart.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface OpenDiffSpec {
+    /** The file the diff is OF — drives language detection, breadcrumb, title. */
+    filePath: string;
+    /** Id of the registered content provider that resolves the two sides. */
+    providerId: string;
+    /** Serializable args handed back to the provider to (re)compute content. */
+    args?: Record<string, unknown>;
+    /** Tab title. Defaults to the file's base name. */
+    title?: string;
+}
+/** The two sides of a diff, resolved by a {@link DiffContentProvider}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface DiffContent {
+    /** Left/original side. */
+    original: string;
+    /** Right/modified side. */
+    modified: string;
+}
+/**
+ * The request a {@link DiffContentProvider} receives to resolve a diff's two
+ * sides — the {@link OpenDiffSpec}'s `filePath`/`args` plus the folder of the
+ * workspace the diff lives in (the natural cwd for path-relative providers).
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface DiffContentRequest {
+    /** The file the diff is OF (from {@link OpenDiffSpec.filePath}). */
+    filePath: string;
+    /** The provider's args (from {@link OpenDiffSpec.args}). */
+    args?: Record<string, unknown>;
+    /** Folder of the workspace the diff lives in, or `null` if none. */
+    workspaceFolder: string | null;
+}
+/**
+ * Resolves the two sides of a diff on demand — called by the host whenever a
+ * diff panel mounts (open, tab switch, app restart), so content stays a pure
+ * computed view and never has to be persisted. Register one with
+ * {@link EditorService.registerDiffContentProvider}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export type DiffContentProvider = (request: DiffContentRequest) => Promise<DiffContent>;
+/**
+ * The editor & document domain, exposed as {@link ExtensionContext.editors}.
+ * Open files into editor tabs, drive the active editor (save / close), and let
+ * editor viewers register save handlers. The single entry point for opening
+ * editors — prefer it over reaching into workspace/editor state.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface EditorService {
+    /**
+     * Open a file in an editor tab. Promotes an existing preview, focuses an
+     * already-open tab, or opens a new one.
+     */
+    open(path: string, opts?: OpenFileOptions): void;
+    /** Open a fresh untitled editor. */
+    openUntitled(opts?: OpenFileOptions): void;
+    /**
+     * Open a diff view. The content is supplied by the {@link OpenDiffSpec.providerId | provider}
+     * named in `spec` — the editor itself is content-agnostic.
+     */
+    openDiff(spec: OpenDiffSpec, opts?: OpenFileOptions): void;
+    /** Save the active editor. Returns false if there's no active saveable editor. */
+    save(): boolean;
+    /** Save-as the active editor. Returns false if unavailable. */
+    saveAs(): boolean;
+    /** Close the active dock panel. Returns false if there's nothing to close. */
+    closeActive(): boolean;
+    /**
+     * List the editor views that match `path` (or `null` for an untitled buffer),
+     * highest-priority first, each flagged whether it's the one the host resolves
+     * by default. Read-only enumeration for building "Open With" menus and the
+     * breadcrumb view-switcher. Returns `[]` only when nothing matches — in
+     * practice never empty for a real path, since the core text editor matches
+     * everything.
+     */
+    editorsFor(path: string | null): EditorViewInfo[];
+    /**
+     * Switch an already-open editor tab to a different view in place — without
+     * closing and reopening it — and persist the choice on the tab. No-op if the
+     * editor isn't found, `viewType` names no registered editor, or that editor
+     * doesn't match the tab's file. The panel remounts onto the new view, so
+     * per-instance state (scroll, selection) resets — expected, it's a different
+     * presenter.
+     */
+    setViewType(editorId: string, viewType: string, opts?: {
+        workspaceId?: string;
+    }): void;
+    /**
+     * Register save handlers for an editor instance (by its `editorId`), so the
+     * active-editor `save` / `saveAs` dispatch to it while it's focused. Dispose
+     * to unregister (do this when the editor unmounts).
+     */
+    registerSaveHandler(editorId: string, handlers: EditorSaveHandlers): Disposable;
+    /**
+     * Register a {@link DiffContentProvider} under `providerId`. A diff opened
+     * with that `providerId` (see {@link OpenDiffSpec}) resolves its two sides
+     * through this provider, on every mount. Dispose to unregister.
+     */
+    registerDiffContentProvider(providerId: string, provider: DiffContentProvider): Disposable;
+}
+//# sourceMappingURL=editor-service.d.ts.map

package/dist/editor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-service.d.ts","sourceRoot":"","sources":["../src/editor-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oEAAoE;IACpE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjD,oCAAoC;IACpC,YAAY,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3D,kFAAkF;IAClF,IAAI,IAAI,OAAO,CAAC;IAChB,+DAA+D;IAC/D,MAAM,IAAI,OAAO,CAAC;IAClB,8EAA8E;IAC9E,WAAW,IAAI,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,EAAE,CAAC;IAClD;;;;;;;OAOG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,IAAI,CAAC;IACR;;;;OAIG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,CAAC;IACd;;;;OAIG;IACH,2BAA2B,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,mBAAmB,GAC5B,UAAU,CAAC;CACf"}

package/dist/editor-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=editor-service.js.map

package/dist/editor-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-service.js","sourceRoot":"","sources":["../src/editor-service.ts"],"names":[],"mappings":""}

package/dist/extension-storage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Namespaced, persisted key/value storage handed to side-panel components
+ * via `SidePanelProps.storage`. Each panel id gets its own bag; values are
+ * persisted alongside the rest of the app state.
+ *
+ * The store is hydrated asynchronously after the panels mount, so consumers
+ * that need to wait for restored values should check `props.hydrated` or
+ * use `subscribe` to re-read once it flips.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface ExtensionStorage {
+    /** Read a value. Returns `fallback` if the key is missing. */
+    get<T>(key: string): T | undefined;
+    get<T>(key: string, fallback: T): T;
+    /** Write a value. `undefined` deletes the key. */
+    set(key: string, value: unknown): void;
+    /**
+     * Subscribe to changes in this namespace. Called on any set within this
+     * namespace, and also whenever the underlying app state finishes hydrating
+     * (so callers can re-read after persisted state loads).
+     */
+    subscribe(listener: () => void): () => void;
+}
+//# sourceMappingURL=extension-storage.d.ts.map

package/dist/extension-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-storage.d.ts","sourceRoot":"","sources":["../src/extension-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,kDAAkD;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C"}

package/dist/extension-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-storage.js.map

package/dist/extension-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-storage.js","sourceRoot":"","sources":["../src/extension-storage.ts"],"names":[],"mappings":""}

package/dist/file-service.d.ts

@@ -0,0 +1,84 @@
+import type { Disposable } from "./types";
+/**
+ * Metadata for a single directory entry, as returned by
+ * {@link FileService.readDir}.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface FileMeta {
+    /** The entry's base name (no path). */
+    name: string;
+    /** Absolute path to the entry. */
+    path: string;
+    /** True if the entry is a directory. */
+    isDir: boolean;
+    /** Size in bytes (0 for directories). */
+    size: number;
+    /** Last-modified time, milliseconds since the Unix epoch. */
+    modifiedMs: number;
+}
+/**
+ * A filesystem change event delivered to a {@link FileService.watch} listener,
+ * for changes under that watch's path.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface FileChangeEvent {
+    /** The paths that changed in this event. */
+    paths: string[];
+    /** The backend's change kind (e.g. `"create"`, `"modify"`, `"remove"`). */
+    kind: string;
+}
+/**
+ * The filesystem domain, exposed as {@link ExtensionContext.files}. All access
+ * is host-mediated: extensions read, write, and watch the filesystem through
+ * here rather than calling Tauri directly.
+ *
+ * **Paths are workspace-scoped.** A relative path resolves against the open
+ * workspace folder (`"src/index.ts"` → `<workspace>/src/index.ts`); an absolute
+ * path is allowed only if it falls inside a workspace folder. A path outside the
+ * workspace throws {@link PathDeniedError} unless the extension declared the
+ * matching {@link Permission} (`fs:read` for reads, `fs:write` for writes).
+ * First-party (bundled) extensions are unscoped. Prefer relative paths — they're
+ * portable across machines.
+ *
+ * Watching is host-owned: {@link FileService.watch} expresses intent — "tell me
+ * about changes under this path" — and the host owns the underlying OS
+ * watcher(s). Many in-workspace subscriptions are served from a single,
+ * ref-counted workspace watcher the host manages; extensions never start or
+ * stop watchers themselves, and each listener receives only events scoped to
+ * its path.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface FileService {
+    /** Read a file's contents as UTF-8 text. */
+    readText(path: string): Promise<string>;
+    /** Read a file's raw bytes. */
+    readBytes(path: string): Promise<ArrayBuffer>;
+    /** List a directory's immediate entries. */
+    readDir(path: string): Promise<FileMeta[]>;
+    /** Resolve true if a file or directory exists at `path`. */
+    pathExists(path: string): Promise<boolean>;
+    /** Write UTF-8 text to a file, creating or overwriting it. */
+    writeText(path: string, content: string): Promise<void>;
+    /** Create a directory (and any missing parents). */
+    createDir(path: string): Promise<void>;
+    /** Rename / move a file or directory. */
+    rename(oldPath: string, newPath: string): Promise<void>;
+    /** Delete a file or directory. */
+    delete(path: string): Promise<void>;
+    /** Reveal a path in the OS file manager (Finder / Explorer). */
+    reveal(path: string): Promise<void>;
+    /**
+     * Watch `path` recursively, invoking `listener` for each change under it.
+     * Returns a {@link Disposable} that stops listening when disposed. Watcher
+     * lifecycle is the host's concern — in-workspace paths ride the host's
+     * ref-counted workspace watcher rather than each spinning up its own.
+     */
+    watch(path: string, listener: (event: FileChangeEvent) => void): Disposable;
+}
+//# sourceMappingURL=file-service.d.ts.map

package/dist/file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../src/file-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,+BAA+B;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yCAAyC;IACzC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,UAAU,CAAC;CAC7E"}

package/dist/file-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-service.js.map

package/dist/file-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.js","sourceRoot":"","sources":["../src/file-service.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The public Silo extension API surface — the single curated entry point an
+ * extension author imports from. This is the seed of the future `@silo-code/sdk`
+ * package: it re-exports **only** the blessed, permanently supported types.
+ * Anything not re-exported here is host-internal and may change without notice.
+ *
+ * It is also the entry point the API-reference generator (TypeDoc) reads, so
+ * the published reference is exactly this surface — no more, no less.
+ *
+ * @packageDocumentation
+ */
+export type { Disposable, DockPanelApi, EditorProps, EditorCapabilities, Editor, NewFileTemplate, FileType, Command, MenuId, MenuItemContribution, Keybinding, SidePanelProps, SidePanel, DockPanelKind, StatusItem, SettingsPage, ExtensionContext, Extension, ExtensionHandle, } from "./types";
+export type { Workspace, EditorMode, EditorRecord, SidePanelSlot, } from "./domain-types";
+export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, } from "./workspace-service";
+export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, } from "./editor-service";
+export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, } from "./layout-service";
+export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service";
+export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, } from "./terminal-service";
+export type { FileService, FileMeta, FileChangeEvent } from "./file-service";
+export type { Permission } from "./permissions";
+export { PathDeniedError } from "./permissions";
+export type { ThemeService, ThemeState, ThemePreset, ResolvedTheme, ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./theme-service";
+export type { ExtensionStorage } from "./extension-storage";
+export type { DndService, DndItem, DndMime, DragInit, DndMode, DropContext, DropTargetHandlers, } from "./dnd-service";
+export { DND_MIME } from "./dnd-service";
+export type { UiService, FileFilter, MenuItem, MenuItemTrailing, MenuSeparator, MenuHeader, MenuEntry, ShowMenuOptions, ConfirmOptions, PromptOptions, ModalOptions, NotifyAction, NotifyOptions, } from "./ui-service";
+export type { ContextKeys } from "./context-keys";
+export { useServiceState } from "./use-service-state";
+export type { ReactiveService } from "./use-service-state";
+export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group";
+export type { FocusGroup, FocusGroupOptions, FocusGroupContainerProps, FocusGroupItemProps, FocusGroupOrientation, FocusGroupNavQuery, } from "./use-focus-group";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,EACP,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC;AAKjB,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI7E,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,YAAY,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * The public Silo extension API surface — the single curated entry point an
+ * extension author imports from. This is the seed of the future `@silo-code/sdk`
+ * package: it re-exports **only** the blessed, permanently supported types.
+ * Anything not re-exported here is host-internal and may change without notice.
+ *
+ * It is also the entry point the API-reference generator (TypeDoc) reads, so
+ * the published reference is exactly this surface — no more, no less.
+ *
+ * @packageDocumentation
+ */
+export { PathDeniedError } from "./permissions";
+export { DND_MIME } from "./dnd-service";
+// Runtime helpers. The one blessed way for an extension to read a `ctx`
+// service's reactive state in React — replaces hand-rolled useSyncExternalStore.
+export { useServiceState } from "./use-service-state";
+// Headless keyboard navigation for a focus group (list / menu / toolbar / …):
+// one tab stop, arrow/Home/End movement, the WebKit-safe keyboard ring. The
+// `focusGroupNextIndex` helper is the pure roving-index core for widgets that
+// can't use the focus-driven hook (e.g. menus driven by a document listener).
+export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2EH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAuBzC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/layout-service.d.ts

@@ -0,0 +1,46 @@
+import type { Disposable } from "./types";
+/**
+ * Which side column a layout operation targets.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export type SideLocation = "left" | "right";
+/**
+ * Collapse state for one side column.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface SidePanelColumnState {
+    /** True when the column is collapsed (hidden). */
+    collapsed: boolean;
+}
+/**
+ * An immutable view of side-column layout state.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface LayoutState {
+    left: SidePanelColumnState;
+    right: SidePanelColumnState;
+}
+/**
+ * Consumer API for app layout, exposed as {@link ExtensionContext.layout}.
+ * Read side-panel collapse state and drive it.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface LayoutService {
+    /** Current frozen layout state. */
+    getState(): LayoutState;
+    /** Subscribe to layout changes; dispose to stop. */
+    subscribe(listener: (s: LayoutState) => void): Disposable;
+    /** Toggle a side column between collapsed and expanded. */
+    toggleSidePanel(location: SideLocation): void;
+    /** Set a side column's collapsed state explicitly. */
+    setSidePanelCollapsed(location: SideLocation, collapsed: boolean): void;
+}
+//# sourceMappingURL=layout-service.d.ts.map

package/dist/layout-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-service.d.ts","sourceRoot":"","sources":["../src/layout-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,QAAQ,IAAI,WAAW,CAAC;IACxB,oDAAoD;IACpD,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,UAAU,CAAC;IAC1D,2DAA2D;IAC3D,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9C,sDAAsD;IACtD,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACzE"}

package/dist/layout-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layout-service.js.map

package/dist/layout-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-service.js","sourceRoot":"","sources":["../src/layout-service.ts"],"names":[],"mappings":""}

package/dist/permissions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A capability an extension declares in its manifest (`silo.permissions`) to
+ * request access **beyond the open workspace**. With none declared, an
+ * extension's {@link FileService} / {@link ProcessService} access is confined to
+ * the workspace folder(s); each permission lifts one part of that confinement,
+ * and the user consents to the set at install.
+ *
+ * - `fs:read` — read files outside the workspace.
+ * - `fs:write` — write files outside the workspace.
+ * - `process` — run commands with a working directory outside the workspace.
+ * - `network` — make outbound network requests. Declarative consent only until
+ *   sandboxed execution lands (in-process code can reach the network directly);
+ *   declare it so the capability is reviewable and shown at install.
+ *
+ * @category Extension Contract
+ * @public
+ */
+export type Permission = "fs:read" | "fs:write" | "process" | "network";
+/**
+ * Thrown by {@link FileService} and {@link ProcessService} when an extension
+ * touches a path — or runs a process with a working directory — outside the open
+ * workspace without the matching {@link Permission}. Catch it and degrade
+ * gracefully, the same way you'd handle a missing file:
+ *
+ * ```ts
+ * try {
+ *   const text = await ctx.files.readText(path);
+ * } catch (err) {
+ *   if (err instanceof PathDeniedError) showMessage("That file is outside the workspace.");
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export declare class PathDeniedError extends Error {
+    /** The offending path, exactly as the extension passed it. */
+    readonly path: string;
+    constructor(path: string, message?: string);
+}
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS3C"}

package/dist/permissions.js

@@ -0,0 +1,40 @@
+// The extension permission surface — what an extension may declare it needs
+// (`silo.permissions` in its manifest) and the error the host throws when an
+// extension reaches outside the workspace without the matching grant. See the
+// "Permissions & access" guide and ADR 0015 (phased security model).
+/**
+ * Thrown by {@link FileService} and {@link ProcessService} when an extension
+ * touches a path — or runs a process with a working directory — outside the open
+ * workspace without the matching {@link Permission}. Catch it and degrade
+ * gracefully, the same way you'd handle a missing file:
+ *
+ * ```ts
+ * try {
+ *   const text = await ctx.files.readText(path);
+ * } catch (err) {
+ *   if (err instanceof PathDeniedError) showMessage("That file is outside the workspace.");
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export class PathDeniedError extends Error {
+    constructor(path, message) {
+        super(message ?? `Path is outside the workspace: ${path}`);
+        /** The offending path, exactly as the extension passed it. */
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "PathDeniedError";
+        this.path = path;
+        // Restore the prototype chain so `instanceof` works across the down-leveled
+        // class output the SDK ships (and across the host↔extension boundary, where
+        // there's a single shared SDK instance).
+        Object.setPrototypeOf(this, PathDeniedError.prototype);
+    }
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AAqBrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAJ7D,8DAA8D;QACrD;;;;;WAAa;QAIpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF"}