create-opentray 0.21.0 → 0.22.0

package/dist/index.d.mts

@@ -1,7 +1,479 @@
 import { WizardCliOptions, main, parseWizardCli } from "./bin.mjs";
-import { DiscoveredService, DiscoveredService as DiscoveredService$1, FamilyFormState, FaviconCandidate, LaunchVector, MaterializeContext, MaterializeContext as MaterializeContext$1, MaterializeInput, MaterializeLogEvent, MaterializeResult, MaterializeResult as MaterializeResult$1, ScaffoldAppConfig, ScaffoldOptions, ScaffoldResult, ScrapeResult, ScrapedIcon, TokenizeResult, createPortDiscovery, deriveDefaultAppId, deriveDefaultAppName, detectPackageManager, expectedDarwinBundlePath, extractFaviconCandidates, extractTitle, faviconCandidateSize, isDirectoryOccupied, isValidAppId, materialize, openMaterializedApp, parseLsofPorts, parseNetstatPorts, parsePowerShellPorts, parseShebangInterpreter, pinningHint, rankFaviconCandidates, resolveFaviconUrl, resolveLaunchVector, resolveLaunchVector as resolveLaunchVector$1, resolveOnPath, resolveOnPath as resolveOnPath$1, scrapeService, scrapeService as scrapeService$1, serviceUrl, startCommandRun, toProjectDirectoryName, tokenizeCommandLine, verifyHttpService, waitForTcpPort, writeScaffold } from "@create-opentray/core";
 import { IncomingMessage } from "node:http";
+import { AppIcon } from "@opentray/spec";
 
+//#region packages/core/src/app-id.d.ts
+/**
+ * Default appId derivation. `npx somecommand start --xx` keeps the pre-option
+ * tokens `["npx", "somecommand", "start"]`, reverses them, and dot-joins:
+ * `start.somecommand.npx`. Scoped commands like `npx @deepseek-ai/dsh@latest
+ * web` derive `web.dsh.npx`.
+ */
+declare const deriveDefaultAppId: (tokens: readonly string[]) => string;
+/** Human display name from the appId derivation: `Somecommand Start`. */
+declare const deriveDefaultAppName: (tokens: readonly string[]) => string;
+/** Directory-safe project name from an appId (mirrors packaging normalizeAppId semantics). */
+declare const toProjectDirectoryName: (appId: string) => string;
+/** True when the appId has the shape consumers expect for stable identity. */
+declare const isValidAppId: (appId: string) => boolean;
+//#endregion
+//#region packages/core/src/command-family.d.ts
+type Family = "npm" | "go" | "rust" | "python" | "dotnet" | "custom";
+interface FamilyFormState {
+  readonly family: Family;
+  /** npm/python 系列的 runner（如 `npx`、`yarn dlx`、`uvx`、`pipx run`）。 */
+  readonly runner: string;
+  /** runner 与包名之间的选项 token（如 `deno run -A` 的 `-A`）。 */
+  readonly runnerFlags: string;
+  /** 包名 / module 路径 / crate / 工具 ID（保持用户输入原样）。 */
+  readonly pkg: string;
+  /** 空串 = latest/省略。 */
+  readonly version: string;
+  /** 包名之后的参数（原样字符串）。 */
+  readonly args: string;
+  /** 仅 Rust：运行二进制名；空串 = 与 crate 同名。 */
+  readonly binary: string;
+  /** 仅自定义：完整自由命令。 */
+  readonly raw: string;
+}
+//#endregion
+//#region packages/core/src/launch-vector.d.ts
+interface LaunchVector {
+  readonly command: string;
+  readonly args: readonly string[];
+  readonly cwd: string;
+  /** Optional explicit env overlay merged over the runtime environment. */
+  readonly env?: Readonly<Record<string, string>>;
+}
+interface ResolveLaunchVectorOptions {
+  readonly tokens: readonly string[];
+  readonly cwd: string;
+  readonly platform?: NodeJS.Platform;
+  readonly pathEnv?: string;
+  readonly accessFile?: (path: string) => Promise<void>;
+  readonly firstLine?: (path: string) => Promise<string | undefined>;
+}
+/** Resolve a bare command name against PATH; returns undefined when absent. */
+declare const resolveOnPath: (command: string, options: Pick<ResolveLaunchVectorOptions, "platform" | "pathEnv" | "accessFile">) => Promise<string | undefined>;
+/** Read a `#!/usr/bin/env <interpreter>` shebang; undefined for other files. */
+declare const parseShebangInterpreter: (firstLine: string | undefined) => {
+  interpreter: string;
+  args: readonly string[];
+} | undefined;
+/**
+ * Resolve the user's command tokens to a PATH-independent vector:
+ * - absolute-ize bare executables through PATH lookup;
+ * - resolve relative script paths against cwd;
+ * - when the executable is an `env <interpreter>` shebang script, run the
+ *   interpreter directly with the script as its first argument.
+ * The persisted descriptor never includes an environment map.
+ */
+declare const resolveLaunchVector: (options: ResolveLaunchVectorOptions) => Promise<LaunchVector>;
+//#endregion
+//#region packages/core/src/tokenize.d.ts
+interface TokenizeResult {
+  readonly ok: boolean;
+  readonly tokens: readonly string[];
+  readonly error: string | undefined;
+}
+/**
+ * Shell-style tokenizer for the wizard command input (shell-quote under the
+ * hood). Supports single quotes, double quotes, backslash escapes, and
+ * adjacent segments (`a"b c"d` → `["ab cd"]`). It never executes anything;
+ * it only produces the argv that will be spawned.
+ */
+declare const tokenizeCommandLine: (input: string) => TokenizeResult;
+//#endregion
+//#region packages/core/src/port-scan.d.ts
+interface DiscoveredService {
+  readonly port: number;
+  readonly url: string;
+  readonly firstSeenAt: number;
+  title?: string;
+}
+type ListenersRunner = (platform: NodeJS.Platform) => Promise<ReadonlySet<number>>;
+/** Listener snapshot with process ownership: port -> owning PIDs. */
+type ListenerOwners = ReadonlyMap<number, ReadonlySet<number>>;
+/** Loopback service URL for a discovered port. */
+declare const serviceUrl: (port: number) => string;
+declare const parseLsofPorts: (stdout: string) => ReadonlySet<number>;
+/** Parses `netstat -ano -p tcp` output; keeps LISTENING rows. */
+declare const parseNetstatPorts: (stdout: string) => ReadonlySet<number>;
+declare const parsePowerShellPorts: (stdout: string) => ReadonlySet<number>;
+/** TCP-connect probe used by the generated app and discovery verification. */
+declare const waitForTcpPort: (port: number, timeoutMs: number, intervalMs?: number, host?: string) => Promise<boolean>;
+/** Verify a port answers with an HTTP response (any status counts). */
+declare const verifyHttpService: (port: number, timeoutMs?: number) => Promise<boolean>;
+interface PortDiscoveryOptions {
+  readonly platform?: NodeJS.Platform;
+  readonly baseline: ReadonlySet<number>;
+  readonly listListeners?: ListenersRunner;
+  readonly verifyHttp?: (port: number) => Promise<boolean>;
+  /** Resolves the PIDs whose listeners count as services (preview process tree). */
+  readonly resolveOwnerPids?: () => Promise<ReadonlySet<number>>;
+  readonly listOwners?: () => Promise<ListenerOwners>;
+  readonly intervalMs?: number;
+}
+interface PortDiscoverySession {
+  /** Known new services, first-seen order. */
+  services(): readonly DiscoveredService[];
+  /** One polling pass; resolves to services discovered during this pass. */
+  poll(): Promise<readonly DiscoveredService[]>;
+  stop(): void;
+}
+/**
+ * Diff-based port discovery. Each poll re-enumerates listeners, keeps ports
+ * absent from the baseline, and adds HTTP-verified ones in first-seen order.
+ */
+declare const createPortDiscovery: (options: PortDiscoveryOptions) => PortDiscoverySession;
+//#endregion
+//#region packages/core/src/scrape.d.ts
+/** Variant tag: the original art, or a solid-color silhouette derived from it. */
+type IconVariant = "original" | "solid-black" | "solid-white";
+/** One scraped icon candidate, ranked and deduplicated. */
+interface ScrapedIcon {
+  /** Index within the candidate list (stable for /api/icon-data/:port/:index). */
+  readonly index: number;
+  /** Absolute URL the bytes came from (variants inherit their source URL). */
+  readonly url: string;
+  /** Absolute temp file holding the icon bytes. */
+  readonly path: string;
+  /** True pixel clarity (largest dimension; SVG uses intrinsic or 512). */
+  readonly width: number;
+  readonly height: number;
+  /** png | svg | jpeg | webp | gif | ico (ico payloads are extracted to png). */
+  readonly format: string;
+  /** Which art this entry carries (originals feed the app-icon picker; the
+   *  advanced tray picker also shows solid variants). */
+  readonly variant: IconVariant;
+  /** Index of the original candidate a variant was derived from. */
+  readonly variantOf?: number;
+}
+interface ScrapeResult {
+  readonly ok: boolean;
+  readonly title: string | undefined;
+  /** Absolute temp file holding the chosen (clearest) favicon bytes, when found. */
+  readonly iconPath: string | undefined;
+  readonly iconUrl?: string;
+  /** All viable candidates ranked by clarity, near-duplicates removed. */
+  readonly icons: readonly ScrapedIcon[];
+  /**
+   * Whether the page's response policy allows third-party iframe embedding
+   * (toolbar mode feasibility); undefined when the page could not be fetched.
+   */
+  readonly frameEmbeddable?: boolean;
+}
+interface FaviconCandidate {
+  readonly href: string;
+  readonly rel: string;
+  readonly sizes?: string;
+}
+/** Extract `<title>` text from HTML. */
+declare const extractTitle: (html: string) => string | undefined;
+/** Extract `<link rel=... href=...>` favicon candidates from HTML head. */
+declare const extractFaviconCandidates: (html: string) => readonly FaviconCandidate[];
+/** Largest dimension of a `sizes` attribute value such as `32x32` or `any`. */
+declare const faviconCandidateSize: (candidate: FaviconCandidate) => number;
+/** Resolve a favicon href against the service origin. */
+declare const resolveFaviconUrl: (href: string, origin: string) => string | undefined;
+/** Order candidates: declared-size icons descending, then apple-touch-icon, then others. */
+declare const rankFaviconCandidates: (candidates: readonly FaviconCandidate[]) => readonly FaviconCandidate[];
+interface ScrapePage {
+  readonly ok: boolean;
+  readonly status: number;
+  readonly body: string;
+  readonly headers: Record<string, string>;
+}
+interface ScrapeBytes {
+  readonly ok: boolean;
+  readonly status: number;
+  readonly bytes: Buffer;
+  readonly contentType: string;
+}
+interface ScrapeFetch {
+  page(url: string, timeoutMs?: number): Promise<ScrapePage>;
+  bytes(url: string, timeoutMs?: number): Promise<ScrapeBytes>;
+}
+/**
+ * Scrape title and ALL icon candidates from an arbitrary http(s) URL.
+ * Never throws: failures return `ok: false` with whatever partial identity
+ * was found. (`scrapeService` is the loopback-port wrapper over this.)
+ */
+declare const scrapeUrl: (url: string, options?: {
+  fetch?: ScrapeFetch;
+  tempDir?: string;
+}) => Promise<ScrapeResult>;
+/**
+ * Scrape title and ALL icon candidates from a service port. Never throws:
+ * failures return `ok: false` with whatever partial identity was found.
+ */
+declare const scrapeService: (port: number, options?: {
+  fetch?: ScrapeFetch;
+  tempDir?: string;
+}) => Promise<ScrapeResult>;
+//#endregion
+//#region ../icon/src/generate.d.ts
+interface OpenTrayAppIconOptions {
+  readonly sourcePath: string;
+  readonly outputPath?: string;
+  readonly icnsOutputPath?: string;
+  readonly icoOutputPath?: string;
+  readonly linuxOutputDirectory?: string;
+  readonly manifestOutputPath?: string;
+  readonly cachePath?: string;
+  /** Advanced: override the module whose bytes identify the generator implementation. */
+  readonly implementationPath?: string;
+  /** Advanced: override the source file whose bytes identify the generator implementation. */
+  readonly implementationSourcePath?: string;
+  /**
+   * Pre-composed source: skip glyph re-tiling; pass pixels through verbatim.
+   */
+  readonly composed?: boolean;
+  /**
+   * Separate macOS content source; ICNS encodes from this while ICO/Linux
+   * use sourcePath.
+   */
+  readonly macosSourcePath?: string;
+}
+interface OpenTrayAppIconCacheMetadata {
+  readonly schemaVersion: number;
+  readonly sourceSha256: string;
+  readonly macosSourceSha256?: string;
+  readonly composed?: boolean;
+  readonly sourceImplementationSha256: string | null;
+  readonly implementationSha256: string;
+  readonly recipeVersion: string;
+  readonly jsquashPngVersion: string;
+  readonly jsquashResizeVersion: string;
+  readonly resvgVersion: string;
+  readonly iconEncoderVersion: string;
+  readonly figmaSquircleVersion: string;
+  readonly exifrVersion: string;
+  readonly outputPath: string;
+  readonly icnsOutputPath: string;
+  readonly icoOutputPath: string;
+  readonly linuxPngOutputPaths: readonly {
+    readonly size: number;
+    readonly path: string;
+  }[];
+  readonly manifestOutputPath: string;
+  /** Absolute file sources ready to pass to OpenTray at runtime. */
+  readonly appIcon: AppIcon;
+}
+/** Generate one strict cross-platform AppIcon asset set. */
+declare function generateOpenTrayAppIcon(options: OpenTrayAppIconOptions): Promise<OpenTrayAppIconCacheMetadata>;
+//#endregion
+//#region ../icon/src/default-icon.d.ts
+interface DefaultAppIconOptions {
+  readonly appName: string;
+  readonly accent?: string;
+  readonly outputDir: string;
+  /**
+   * Output file stem. The runtime uses the default (`default-app-icon`); the
+   * create pipeline passes `app-icon` so the glyph fallback lands in the
+   * scaffold's standard catalog layout — one generator, one visual standard.
+   */
+  readonly fileStem?: string;
+  /** Cache metadata path; defaults to `<outputDir>/../.cache/default-app-icon.json`. */
+  readonly cachePath?: string;
+}
+interface DefaultAppIconResult {
+  readonly fullPngPath: string;
+  readonly macOSPngPath: string;
+  readonly icnsPath: string;
+  readonly icoPath: string;
+  readonly linuxPngPaths: readonly {
+    size: number;
+    path: string;
+  }[];
+  readonly manifestPath: string;
+  /** Absolute file sources ready to pass to the runtime as `appIcon`. */
+  readonly appIcon: AppIcon;
+  readonly cacheIdentity: string;
+  /**
+   * True when the name's own first glyph could not be covered by the font
+   * ladder on this host and the neutral terminal mark was used instead
+   * (e.g. CJK names on CJK-less CI runners and containers).
+   */
+  readonly degraded: boolean;
+}
+/** Generate (or reuse, by full identity) the default glyph App icon catalog. */
+declare function generateDefaultAppIcon(options: DefaultAppIconOptions): Promise<DefaultAppIconResult>;
+//#endregion
+//#region ../icon/src/compose.d.ts
+type IconBackground = "black" | "white" | "transparent";
+//#endregion
+//#region packages/core/src/command-run.d.ts
+interface CommandRunEvent {
+  readonly type: "stdout" | "stderr" | "exit" | "spawn-error" | "pty-ready" | "pty-unavailable";
+  /** The PTY binding's output chunk, verbatim; rendering is the frontend's job. */
+  readonly chunk?: string;
+  readonly code?: number | null;
+  readonly message?: string;
+}
+interface CommandRunTerminalSize {
+  readonly cols: number;
+  readonly rows: number;
+}
+interface CommandRunOptions {
+  readonly tokens: readonly string[];
+  readonly cwd?: string;
+  readonly env?: NodeJS.ProcessEnv;
+  readonly ringLimit?: number;
+  /** Attach through a PTY when available; defaults to true. */
+  readonly pty?: boolean;
+  readonly terminalSize?: CommandRunTerminalSize;
+  readonly onEvent: (event: CommandRunEvent) => void;
+}
+interface CommandRun {
+  readonly pid: number | undefined;
+  readonly pty: boolean;
+  readonly exited: Promise<{
+    code: number | null;
+    spawnError?: string;
+  }>;
+  readonly output: readonly string[];
+  /** Write terminal input bytes to the command's stdin (PTY mode only). */
+  write(data: string): void;
+  /** Resize the pseudo-terminal (PTY mode only). */
+  resize(size: CommandRunTerminalSize): void;
+  kill(): Promise<void>;
+}
+declare const startCommandRun: (options: CommandRunOptions) => Promise<CommandRun>;
+//#endregion
+//#region packages/core/src/open-app.d.ts
+interface OpenAppInput {
+  readonly projectDir: string;
+  readonly bundlePath: string | undefined;
+  readonly platform?: NodeJS.Platform | undefined;
+}
+interface OpenAppResult {
+  readonly ok: boolean;
+  readonly detail: string;
+}
+declare const openMaterializedApp: (input: OpenAppInput) => Promise<OpenAppResult>;
+/** Platform-truthful pinning hint; makes no persistence claim before first open. */
+declare const pinningHint: (platform?: NodeJS.Platform) => string;
+//#endregion
+//#region packages/core/src/scaffold.d.ts
+interface ScaffoldAppConfig {
+  readonly schemaVersion: 1;
+  readonly appId: string;
+  readonly appName: string;
+  /** Command source; exactly one of command/url is present (v1 XOR). */
+  readonly command?: LaunchVector;
+  /** URL source: the address the generated window opens directly. */
+  readonly url?: string;
+  readonly service: {
+    readonly port: number;
+  };
+  readonly window: {
+    readonly width: number;
+    readonly height: number; /** URL applications: host the address-bar wrapper (D12). */
+    readonly toolbar?: boolean;
+    readonly titleFollowsDocument: boolean;
+    readonly iconFollowsDocument: boolean;
+  };
+  /** Tray icon asset (written by materialize); omitted → text-only tray. */
+  readonly trayIcon?: {
+    readonly path: string;
+    readonly template: boolean;
+  };
+  /** Generated-app shell (startup terminal / address-bar tabs). */
+  readonly shell?: {
+    readonly showTerminal: boolean;
+    readonly showAddressBar: boolean;
+  };
+  /** v1 developerMode: only WebView DevTools admission; default false. */
+  readonly developerMode?: boolean;
+}
+interface ScaffoldOptions {
+  readonly config: ScaffoldAppConfig;
+  readonly targetDir: string;
+  /** opentray/@opentray/ext-webview version range written into package.json. */
+  readonly dependencyRange: string;
+  /** Whether install will be skipped; only affects README guidance text. */
+  readonly skipInstall?: boolean;
+  /** Directory holding the prebuilt shell UI (copied to app-shell/).
+   * Defaults to the adapter-staged assets resolved from the running package
+   * layout (published create-opentray/dist/shell, or the workspace build). */
+  readonly shellAssetsDir?: string;
+}
+interface ScaffoldResult {
+  readonly projectDir: string;
+  readonly entryPath: string;
+  readonly configPath: string;
+  readonly appIconDir: string;
+  readonly writtenFiles: readonly string[];
+}
+declare const writeScaffold: (options: ScaffoldOptions) => Promise<ScaffoldResult>;
+//#endregion
+//#region packages/core/src/materialize.d.ts
+type MaterializeLogEvent = {
+  readonly type: "step";
+  readonly step: string;
+  readonly message: string;
+} | {
+  readonly type: "log";
+  readonly message: string;
+};
+interface MaterializeInput {
+  readonly config: ScaffoldAppConfig;
+  readonly targetDir: string;
+  readonly dependencyRange: string;
+  readonly iconSourcePath: string | undefined;
+  /** True when the tray source is a solid silhouette (darwin template). */
+  readonly trayIconIsSolid?: boolean;
+  /** Icon composition (owner round-12): background + foreground scale. */
+  readonly iconBackground?: IconBackground;
+  readonly iconScale?: number;
+  /** Nearest-neighbor sampling for pixel-art sources (v1 imageSmoothingEnabled). */
+  readonly imageSmoothingEnabled?: boolean;
+  /** Tray icon source; defaults to the app icon source when omitted. */
+  readonly trayIconSourcePath?: string;
+  /** Generated-app shell options (startup terminal / address bar). */
+  readonly shell?: {
+    showTerminal: boolean;
+    showAddressBar: boolean;
+  };
+  /** Adapter-owned prebuilt shell UI directory (copied to app-shell/). */
+  readonly shellAssetsDir?: string;
+  readonly packageManager: "npm" | "pnpm" | "bun";
+  readonly skipInstall: boolean;
+  readonly force: boolean;
+}
+interface MaterializeResult {
+  readonly scaffold: ScaffoldResult;
+  readonly projectDir: string;
+}
+interface MaterializeContext {
+  readonly log: (event: MaterializeLogEvent) => void;
+  readonly generateIcon?: typeof generateOpenTrayAppIcon;
+  /** Same seam for the glyph default catalog (wizard tests stub both). */
+  readonly generateDefaultIcon?: typeof generateDefaultAppIcon;
+  readonly runInstall?: (options: RunInstallOptions) => Promise<void>;
+}
+interface RunInstallOptions {
+  readonly projectDir: string;
+  readonly packageManager: "npm" | "pnpm" | "bun";
+  readonly log: (message: string) => void;
+}
+/** True when the directory exists and contains anything beyond ignorable files. */
+declare const isDirectoryOccupied: (dir: string) => Promise<boolean>;
+/** Detect package manager from lockfiles then npm_config_user_agent. */
+declare const detectPackageManager: (files: readonly string[], userAgent: string | undefined) => "npm" | "pnpm" | "bun";
+/** Expected stable Darwin bundle path for the generated project's identity. */
+declare const expectedDarwinBundlePath: (config: {
+  appName: string;
+  appId: string;
+}) => string;
+/**
+ * Backward-compatible composition used by the wizard adapter: generation is
+ * the payload phase. There is no first-launch validation — the wizard panel's
+ * command preview is the validator (decision D1).
+ */
+declare const materialize: (input: MaterializeInput, context: MaterializeContext) => Promise<MaterializeResult>;
+//#endregion
 //#region src/wizard.d.ts
 interface WizardEnvEntry {
   readonly key: string;
@@ -97,7 +569,7 @@ type WizardEvent = {
   readonly defaultCwd: string;
 } | {
   readonly type: "services";
-  readonly services: readonly DiscoveredService$1[];
+  readonly services: readonly DiscoveredService[];
   readonly selectedPort: number | undefined;
 } | {
   readonly type: "scrape";
@@ -129,12 +601,13 @@ type WizardEvent = {
   readonly type: "snapshot";
   readonly state: WizardState;
   readonly runAlive: boolean;
-  readonly command: string;
+  readonly command: string; /** URL 模式激活时的源地址（命令模式为 undefined）。 */
+  readonly urlSource?: string;
   readonly commandOptions: WizardCommandOptions;
   readonly form: WizardFormValues;
   readonly defaults: WizardFormDefaults;
   readonly targetDirExists: boolean;
-  readonly services: readonly DiscoveredService$1[];
+  readonly services: readonly DiscoveredService[];
   readonly selectedPort?: number | undefined;
   readonly iconCandidates: readonly ScrapedIcon[];
   readonly iconsPort?: number | undefined;
@@ -159,20 +632,22 @@ interface WizardOptions {
   readonly listListeners?: () => Promise<ReadonlySet<number>>;
   readonly verifyHttp?: (port: number) => Promise<boolean>;
   /** Test/embedding seam for listener ownership. */
-  readonly listPortOwners?: () => Promise<import("@create-opentray/core").ListenerOwners>;
-  readonly scrape?: typeof scrapeService$1;
-  readonly resolveVector?: typeof resolveLaunchVector$1;
+  readonly listPortOwners?: () => Promise<ListenerOwners>;
+  readonly scrape?: typeof scrapeService;
+  /** Test seam for the URL-mode preset scrape. */
+  readonly scrapeUrl?: typeof scrapeUrl;
+  readonly resolveVector?: typeof resolveLaunchVector;
   /** Test/embedding seam for PATH resolution of the cargo-install guard. */
-  readonly resolveOnPath?: typeof resolveOnPath$1;
+  readonly resolveOnPath?: typeof resolveOnPath;
   /** Test/embedding seam for the materialize pipeline. */
-  readonly materializeContext?: Partial<MaterializeContext$1>;
+  readonly materializeContext?: Partial<MaterializeContext>;
   readonly platform?: NodeJS.Platform;
   readonly pollIntervalMs?: number;
   readonly scrapeIntervalMs?: number;
 }
 interface WizardSession {
   readonly state: WizardState;
-  readonly services: readonly DiscoveredService$1[];
+  readonly services: readonly DiscoveredService[];
   readonly selectedPort: number | undefined;
   /** True while the preview process is alive (Run button shows Interrupt). */
   readonly runAlive: boolean;
@@ -203,12 +678,17 @@ interface WizardSession {
   /** Auto-suggestion for the foreground (background + reason). */
   analyzeIconForeground(foregroundPath: string): Promise<WizardIconAnalysis>;
   readonly form: WizardFormValues;
-  readonly result: MaterializeResult$1 | undefined;
+  readonly result: MaterializeResult | undefined;
   /** Whole-session state for reconnecting clients (page refresh recovery). */
   snapshot(): WizardEvent;
   /** String form is tokenized; array form is taken as argv verbatim (array
    *  input mode — no string splitting is ever applied to it). */
   submitCommand(command: string | readonly string[]): Promise<void>;
+  /** URL 模式入口：地址即源（一次抓取预设，进入 discovered 可确认态）；
+   * 空 url 退出 URL 模式回到 idle。 */
+  submitUrl(url: string): Promise<void>;
+  /** Active URL-mode source address; undefined in command mode. */
+  readonly urlSource: string | undefined;
   /** Derive placeholder defaults from command text without spawning anything. */
   prime(command: string | readonly string[]): void;
   readonly commandOptions: WizardCommandOptions;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/wizard.ts","../src/server.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../packages/core/src/app-id.ts","../packages/core/src/command-family.ts","../packages/core/src/launch-vector.ts","../packages/core/src/tokenize.ts","../packages/core/src/port-scan.ts","../packages/core/src/scrape.ts","../../icon/src/generate.ts","../../icon/src/default-icon.ts","../../icon/src/compose.ts","../packages/core/src/command-run.ts","../packages/core/src/open-app.ts","../packages/core/src/scaffold.ts","../packages/core/src/materialize.ts","../src/wizard.ts","../src/server.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,3 +1,2 @@
-import { a as isAuthorized, i as createWizardServer, o as isLoopbackHost, r as parseWizardCli, s as createWizardSession, t as main } from "./bin-Dl6P1QjJ.mjs";
-import { createPortDiscovery, deriveDefaultAppId, deriveDefaultAppName, detectPackageManager, expectedDarwinBundlePath, extractFaviconCandidates, extractTitle, faviconCandidateSize, isDirectoryOccupied, isValidAppId, materialize, openMaterializedApp, parseLsofPorts, parseNetstatPorts, parsePowerShellPorts, parseShebangInterpreter, pinningHint, rankFaviconCandidates, resolveFaviconUrl, resolveLaunchVector, resolveOnPath, scrapeService, serviceUrl, toProjectDirectoryName, tokenizeCommandLine, verifyHttpService, waitForTcpPort, writeScaffold } from "@create-opentray/core";
+import { A as resolveOnPath, C as parseNetstatPorts, D as waitForTcpPort, E as verifyHttpService, F as toProjectDirectoryName, M as deriveDefaultAppId, N as deriveDefaultAppName, O as parseShebangInterpreter, P as isValidAppId, S as parseLsofPorts, T as serviceUrl, _ as faviconCandidateSize, a as isAuthorized, b as scrapeService, c as openMaterializedApp, d as expectedDarwinBundlePath, f as isDirectoryOccupied, g as extractTitle, h as extractFaviconCandidates, i as createWizardServer, j as tokenizeCommandLine, k as resolveLaunchVector, l as pinningHint, m as writeScaffold, o as isLoopbackHost, p as materialize, r as parseWizardCli, s as createWizardSession, t as main, u as detectPackageManager, v as rankFaviconCandidates, w as parsePowerShellPorts, x as createPortDiscovery, y as resolveFaviconUrl } from "./bin-Dyfucd3C.mjs";
 export { createPortDiscovery, createWizardServer, createWizardSession, deriveDefaultAppId, deriveDefaultAppName, detectPackageManager, expectedDarwinBundlePath, extractFaviconCandidates, extractTitle, faviconCandidateSize, isAuthorized, isDirectoryOccupied, isLoopbackHost, isValidAppId, materialize, openMaterializedApp, parseLsofPorts, parseNetstatPorts, parsePowerShellPorts, parseShebangInterpreter, parseWizardCli, pinningHint, rankFaviconCandidates, resolveFaviconUrl, resolveLaunchVector, resolveOnPath, main as runWizardMain, scrapeService, serviceUrl, toProjectDirectoryName, tokenizeCommandLine, verifyHttpService, waitForTcpPort, writeScaffold };

package/dist/jpeg-B4tsxG5f.mjs

@@ -0,0 +1,2 @@
+import decode from "./decode-Xr7mARKr.mjs";
+export { decode };

package/dist/png-rD0XEazj.mjs

@@ -0,0 +1,35 @@
+import { decode, n as encode$1, t as __wbg_init } from "./decode-FysWS28R.mjs";
+//#region ../../node_modules/.pnpm/@jsquash+png@3.1.1/node_modules/@jsquash/png/encode.js
+/**
+* Copyright 2020 Google Inc. All Rights Reserved.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*     http://www.apache.org/licenses/LICENSE-2.0
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+let pngModule;
+async function init(moduleOrPath) {
+	if (!pngModule) pngModule = __wbg_init(moduleOrPath);
+	return pngModule;
+}
+async function encode(data, options = {}) {
+	var _a;
+	await init();
+	const bitDepth = (_a = options === null || options === void 0 ? void 0 : options.bitDepth) !== null && _a !== void 0 ? _a : 8;
+	if (bitDepth !== 8 && bitDepth !== 16) throw new Error("Invalid bit depth. Must be either 8 or 16.");
+	const isUint16Array = data.data instanceof Uint16Array;
+	if (isUint16Array && bitDepth !== 16) throw new Error("Invalid bit depth, must be 16 for Uint16Array or manually convert to RGB8 values with Uint8Array.");
+	if (!isUint16Array && bitDepth === 16) throw new Error("Invalid bit depth, must be 8 for Uint8Array or manually convert to RGB16 values with Uint16Array.");
+	const output = await encode$1(new Uint8Array(data.data.buffer), data.width, data.height, bitDepth);
+	if (!output) throw new Error("Encoding error.");
+	return output.buffer;
+}
+//#endregion
+export { decode, encode };
+
+//# sourceMappingURL=png-rD0XEazj.mjs.map

package/dist/png-rD0XEazj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"png-rD0XEazj.mjs","names":["initPngModule","pngEncode"],"sources":["../../../node_modules/.pnpm/@jsquash+png@3.1.1/node_modules/@jsquash/png/encode.js"],"sourcesContent":["/**\n * Copyright 2020 Google Inc. All Rights Reserved.\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *     http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport initPngModule, { encode as pngEncode } from './codec/pkg/squoosh_png.js';\nlet pngModule;\nexport async function init(moduleOrPath) {\n    if (!pngModule) {\n        pngModule = initPngModule(moduleOrPath);\n    }\n    return pngModule;\n}\nexport default async function encode(data, options = {}) {\n    var _a;\n    await init();\n    const bitDepth = (_a = options === null || options === void 0 ? void 0 : options.bitDepth) !== null && _a !== void 0 ? _a : 8;\n    if (bitDepth !== 8 && bitDepth !== 16) {\n        throw new Error('Invalid bit depth. Must be either 8 or 16.');\n    }\n    const isUint16Array = data.data instanceof Uint16Array;\n    if (isUint16Array && bitDepth !== 16) {\n        throw new Error('Invalid bit depth, must be 16 for Uint16Array or manually convert to RGB8 values with Uint8Array.');\n    }\n    if (!isUint16Array && bitDepth === 16) {\n        throw new Error('Invalid bit depth, must be 8 for Uint8Array or manually convert to RGB16 values with Uint16Array.');\n    }\n    const encodeData = new Uint8Array(data.data.buffer);\n    const output = await pngEncode(encodeData, data.width, data.height, bitDepth);\n    if (!output)\n        throw new Error('Encoding error.');\n    return output.buffer;\n}\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;;;AAaA,IAAI;AACJ,eAAsB,KAAK,cAAc;CACrC,IAAI,CAAC,WACD,YAAYA,WAAc,YAAY;CAE1C,OAAO;AACX;AACA,eAA8B,OAAO,MAAM,UAAU,CAAC,GAAG;CACrD,IAAI;CACJ,MAAM,KAAK;CACX,MAAM,YAAY,KAAK,YAAY,QAAQ,YAAY,KAAK,IAAI,KAAK,IAAI,QAAQ,cAAc,QAAQ,OAAO,KAAK,IAAI,KAAK;CAC5H,IAAI,aAAa,KAAK,aAAa,IAC/B,MAAM,IAAI,MAAM,4CAA4C;CAEhE,MAAM,gBAAgB,KAAK,gBAAgB;CAC3C,IAAI,iBAAiB,aAAa,IAC9B,MAAM,IAAI,MAAM,mGAAmG;CAEvH,IAAI,CAAC,iBAAiB,aAAa,IAC/B,MAAM,IAAI,MAAM,mGAAmG;CAGvH,MAAM,SAAS,MAAMC,SAAU,IADR,WAAW,KAAK,KAAK,MACJ,GAAG,KAAK,OAAO,KAAK,QAAQ,QAAQ;CAC5E,IAAI,CAAC,QACD,MAAM,IAAI,MAAM,iBAAiB;CACrC,OAAO,OAAO;AAClB"}