create-zenbu-app 0.0.30 → 0.0.33

package/dist/desktop.d.mts

@@ -0,0 +1,185 @@
+//#region src/desktop/deps-sig.d.ts
+type PmType = "pnpm" | "npm" | "yarn" | "bun";
+interface PmSpec {
+  type: PmType;
+  version: string;
+}
+/**
+ * Mirror of `packages/core/src/shared/pm-install.ts#depsSignature`, with
+ * `electronVersion` accepted explicitly because we run from Node (not
+ * Electron) and `process.versions.electron` is undefined here.
+ *
+ * Must stay byte-for-byte equivalent to the launcher's recipe so the
+ * pre-seeded `<appsDir>/.zenbu/deps-sig` matches what `ensureDepsInstalled`
+ * recomputes on first launch and the install gate skips.
+ */
+declare function depsSignature(opts: {
+  appsDir: string;
+  pm: PmSpec;
+  electronVersion: string;
+  arch?: NodeJS.Architecture;
+  platform?: NodeJS.Platform;
+}): Promise<string>;
+declare function writeDepsSig(appsDir: string, sig: string): Promise<void>;
+//#endregion
+//#region src/desktop/log.d.ts
+interface DesktopLogger {
+  /** Absolute path of the log file backing this logger. */
+  readonly file: string;
+  /** Append a structured step boundary. */
+  step(label: string): void;
+  /** Append a free-form line (also mirrored to stdout when verbose). */
+  info(line: string): void;
+  /** Append an error line. Always mirrored to stderr. */
+  error(line: string): void;
+  /**
+   * Run `fn`, logging its start and end with timing. Throws are recorded
+   * with the step label and re-thrown.
+   */
+  withStep<T>(label: string, fn: () => Promise<T> | T): Promise<T>;
+  /** Last `n` lines of the log file (string, may be empty). */
+  tail(n?: number): string;
+  /** Close the underlying stream. */
+  close(): void;
+}
+interface CreateLoggerOpts {
+  /** Display slug, used in the log file name. */
+  slug: string;
+  /** When true, mirror every line to stdout. */
+  verbose?: boolean;
+}
+declare function createLogger(opts: CreateLoggerOpts): DesktopLogger;
+//#endregion
+//#region src/desktop/electron-cache.d.ts
+interface EnsureElectronAppOpts {
+  /**
+   * Either an exact version (`"42.1.3"`) or a semver-range string
+   * (`"^42.0.0"`). When a range, we resolve the latest published version
+   * matching the range from the npm registry.
+   */
+  versionRange: string;
+  log: DesktopLogger;
+  /** Override download URL prefix (for testing). */
+  downloadBase?: string;
+}
+interface EnsureElectronAppResult {
+  electronAppPath: string;
+  version: string;
+  major: number;
+}
+declare function ensureElectronApp(opts: EnsureElectronAppOpts): Promise<EnsureElectronAppResult>;
+//#endregion
+//#region src/desktop/bundle.d.ts
+interface SynthesizeBundleOpts {
+  /** Cached vanilla Electron.app to clone-copy from. */
+  cachedElectronApp: string;
+  /** Final installed bundle path (e.g. `/Applications/<Name>.app`). */
+  destApp: string;
+  /** Display name shown in Finder, dock, menu bar. */
+  displayName: string;
+  /** Slug used for `CFBundleIdentifier` and `app-config.name`. */
+  slug: string;
+  /** App version (matches user project package.json#version). */
+  version: string;
+  /** Bundle id, defaults to `dev.zenbu.<slug>`. */
+  bundleId?: string;
+  /** Optional user icon (.icns or .png). When omitted, keep electron.icns. */
+  iconSource?: string;
+  /** Package manager that pre-seeded `<appsDir>/node_modules`. */
+  packageManager: PmSpec;
+  /** Pre-seeded apps dir (`~/.zenbu/apps/<slug>`). */
+  appsDir: string;
+  /** Path to `@zenbujs/core/dist/launcher.mjs` to bake into the bundle. */
+  launcherSource: string;
+  log: DesktopLogger;
+  dryRun?: boolean;
+  force?: boolean;
+}
+declare function synthesizeBundle(opts: SynthesizeBundleOpts): Promise<void>;
+/**
+ * Ad-hoc deep-sign a bundle with the same entitlements used at synthesize
+ * time. Reusable so post-synthesize mutations (e.g. icon swap) can re-sign
+ * without rebuilding the whole bundle.
+ */
+declare function adhocCodesign(opts: {
+  destApp: string;
+  log: DesktopLogger;
+  dryRun?: boolean;
+}): Promise<void>;
+declare function stripQuarantine(opts: {
+  destApp: string;
+  log: DesktopLogger;
+  dryRun?: boolean;
+}): Promise<void>;
+/**
+ * Resolve the path to `@zenbujs/core/dist/launcher.mjs` from any cwd. We
+ * use `package.json` as the resolution anchor because that subpath is
+ * exported (see packages/core/package.json `exports`).
+ */
+declare function resolveLauncherSource(fromDir: string): string;
+//#endregion
+//#region src/desktop/icon.d.ts
+interface PrepareIconOpts {
+  /** Path supplied by the user. May be `.icns` or `.png`. */
+  source: string;
+  /** Destination .icns path inside the bundle's Resources dir. */
+  dest: string;
+  log: DesktopLogger;
+}
+declare function prepareIcon(opts: PrepareIconOpts): Promise<void>;
+//#endregion
+//#region src/desktop/update-icon.d.ts
+interface UpdateBundleIconOpts {
+  /** Absolute path to the existing .app bundle. */
+  destApp: string;
+  /** Source icon, .png (square, ideally 1024x1024) or .icns. */
+  iconSource: string;
+  /**
+   * If true, also poke the macOS icon services so Finder/Dock pick up the
+   * new icon without a full re-login. Best-effort.
+   */
+  refreshIconServices?: boolean;
+  log: DesktopLogger;
+}
+/**
+ * Swap an existing bundle's `Contents/Resources/icon.icns`, then re-codesign
+ * (ad-hoc, deep) so the bundle stays valid. Optionally nudges Launch
+ * Services to re-read the icon.
+ */
+declare function updateBundleIcon(opts: UpdateBundleIconOpts): Promise<void>;
+//#endregion
+//#region src/desktop/index.d.ts
+interface DesktopRunOpts {
+  /** Display name (e.g. "My Notes"). */
+  displayName: string;
+  /** Slug used for paths and bundle id (e.g. "my-notes"). */
+  slug: string;
+  /** App version, defaults to the project package.json#version. */
+  version: string;
+  /** Optional explicit electron version range (default: read from project pkg). */
+  electronVersionRange?: string;
+  /** Optional icon (.icns or .png) path. */
+  iconSource?: string;
+  /** Pre-seeded apps dir (e.g. ~/.zenbu/apps/<slug>). */
+  appsDir: string;
+  /** Package manager that just installed deps in `appsDir`. */
+  packageManager: PmSpec;
+  /** Override destination (default `/Applications/<DisplayName>.app`). */
+  destApp?: string;
+  /** Project dir from where to resolve the launcher source (`@zenbujs/core`). */
+  resolveFrom: string;
+  log: DesktopLogger;
+  force?: boolean;
+  dryRun?: boolean;
+  /** Skip writing `<appsDir>/.zenbu/deps-sig`. Useful when `--no-install`. */
+  skipDepsSig?: boolean;
+}
+interface DesktopRunResult {
+  destApp: string;
+  electronVersion: string;
+  appsDir: string;
+  launchCommand: string;
+}
+declare function buildDesktopApp(opts: DesktopRunOpts): Promise<DesktopRunResult>;
+//#endregion
+export { type DesktopLogger, DesktopRunOpts, DesktopRunResult, type UpdateBundleIconOpts, adhocCodesign, buildDesktopApp, createLogger, depsSignature, ensureElectronApp, prepareIcon, resolveLauncherSource, stripQuarantine, synthesizeBundle, updateBundleIcon, writeDepsSig };

package/dist/desktop.mjs

@@ -0,0 +1,2 @@
+import { a as writeDepsSig, c as stripQuarantine, d as ensureElectronApp, i as depsSignature, l as synthesizeBundle, n as updateBundleIcon, o as adhocCodesign, r as createLogger, s as resolveLauncherSource, t as buildDesktopApp, u as prepareIcon } from "./desktop-CtHHGkP3.mjs";
+export { adhocCodesign, buildDesktopApp, createLogger, depsSignature, ensureElectronApp, prepareIcon, resolveLauncherSource, stripQuarantine, synthesizeBundle, updateBundleIcon, writeDepsSig };

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { };