@aussieljk/forkbook 0.0.0-stage → 0.0.1-10

package/dist/cli/tools/sdk/index.d.ts

@@ -0,0 +1,137 @@
+import { d as ToolsetOutcome } from "../../../chunk-BCoJQE-f.js";
+import { p as Channel } from "../../../chunk-BXLImeLy.js";
+import { C as attachGateReasonFromError, E as StorybookInstanceRecord, S as ToolsRuntimeErrorReason, T as ToolsRuntime, _ as AttachUnavailableReason, a as ToolsCallOptions, b as ToolsAttachGateReason, c as ToolsHostKind, d as ToolsStorybookInfo, f as ToolsetCatalog, g as AttachUnavailableError, h as ToolsetJsonSchema, i as Tools, l as ToolsMode, m as ToolsetCatalogMethod, n as CreateToolsOptions, o as ToolsClientInfo, p as ToolsetCatalogEntry, r as LocalTools, s as ToolsDescribeOptions, t as AttachedTools, u as ToolsSiblingInstance, v as EnvironmentMismatchError, w as isAttachGateError, x as ToolsRuntimeError, y as SpawnFailedError } from "../../../chunk-D0NUmzXp.js";
+import { fork } from "node:child_process";
+import { logger } from "@aussieljk/forkbook/internal/node-logger";
+
+//#region .dts-emit/code/core/src/cli/tools/sdk/node-channel.d.ts
+interface NodeChannelConnection {
+  channel: Channel;
+  connected: Promise<void>;
+  disconnected: Promise<never>;
+  close(): void;
+}
+//#endregion
+//#region .dts-emit/code/core/src/cli/tools/sdk/attached-runtime.d.ts
+type AttachedInProcessResult = {
+  kind: 'in-process';
+  runtime: ToolsRuntime;
+  record: StorybookInstanceRecord; /** Instances that also matched the target project but were not selected, best first. */
+  siblings: StorybookInstanceRecord[];
+  connection: Pick<NodeChannelConnection, 'close' | 'disconnected'>;
+};
+type AttachedSpawnResult = {
+  kind: 'spawn';
+  record: StorybookInstanceRecord; /** The instance's verified installation root the child host must be resolved from. */
+  storybookPath: string; /** Instances that also matched the target project but were not selected, best first. */
+  siblings: StorybookInstanceRecord[];
+};
+type AttachedBootstrapResult = AttachedInProcessResult | AttachedSpawnResult;
+//#endregion
+//#region .dts-emit/code/core/src/cli/tools/sdk/child-client.d.ts
+type SpawnChildHostDeps = {
+  fork?: typeof fork;
+  resolveScript?: (cwd: string) => string;
+  logger?: Pick<typeof logger, 'log' | 'warn'>;
+};
+declare function spawnChildHost(args: {
+  cwd: string;
+  installationPath?: string;
+  options: CreateToolsOptions & {
+    mode: 'local';
+  };
+  clientInfo: Required<ToolsClientInfo>;
+  requestedMode: ToolsMode;
+}, deps?: SpawnChildHostDeps): Promise<LocalTools>;
+declare function spawnChildHost(args: {
+  cwd: string;
+  installationPath?: string;
+  options: CreateToolsOptions & {
+    mode: 'attached';
+  };
+  clientInfo: Required<ToolsClientInfo>;
+  requestedMode: ToolsMode;
+}, deps?: SpawnChildHostDeps): Promise<AttachedTools>;
+declare function spawnChildHost(args: {
+  cwd: string;
+  installationPath?: string;
+  options: CreateToolsOptions;
+  clientInfo: Required<ToolsClientInfo>;
+  requestedMode: ToolsMode;
+}, deps?: SpawnChildHostDeps): Promise<Tools>;
+//#endregion
+//#region .dts-emit/code/core/src/cli/tools/sdk/create-tools.d.ts
+/**
+ * The in-process attach shape `createTools` consumes: the fields of
+ * {@link AttachedInProcessResult} it reads, with the record narrowed to identifying info so tests
+ * can hand a minimal instance.
+ */
+type AttachedInProcess = {
+  runtime: ToolsRuntime;
+  record: {
+    url: string;
+    pid: number;
+    configDir?: string;
+    cwd?: string;
+    port?: number;
+  };
+  siblings?: StorybookInstanceRecord[];
+  connection: {
+    close(): void;
+    disconnected: Promise<never>;
+  };
+};
+/** Injectable dependencies for tests. Not part of the public SDK. */
+type CreateToolsDeps = {
+  bootstrap?: (target: {
+    cwd?: string;
+    configDir?: string;
+  }) => Promise<ToolsRuntime>;
+  attach?: (target: {
+    cwd?: string;
+    configDir?: string;
+    port?: number;
+  }, deps?: unknown) => Promise<AttachedBootstrapResult | AttachedInProcess>;
+  spawnChild?: typeof spawnChildHost;
+};
+/**
+ * Resolve a host for the tools the target Forkbook configuration registers.
+ *
+ * `local` loads that configuration without a running Forkbook. When this process is already in
+ * the target directory, it loads in-process. Otherwise it spawns a child host from the `storybook`
+ * package resolved under that directory. It never changes `process.cwd()`.
+ *
+ * `attached` joins a running Forkbook over its channel and never changes `process.cwd()`. Two
+ * processes never attach across `storybook` installations: when this process is the instance's
+ * installation (compared by the package root each side derives from its own module location), it
+ * joins in-process; when it is a different installation, it spawns a child host from the
+ * installation the instance recorded and proxies through it.
+ *
+ * `auto` tries `attached` first and, on a gate failure, loads `local` instead. A missing instance
+ * is the expected auto path and stays silent. Unexpected gate failures carry `fallbackNotice`.
+ *
+ * @throws {ToolsRuntimeError} With reason `config-load-failed` when the target configuration cannot
+ *   be loaded, or `mode-unavailable` when a foreign `cwd` needs a child host and `autoSpawn` is
+ *   declined.
+ * @throws {AttachUnavailableError} When `attached` cannot find or reach a matching instance.
+ * @throws {EnvironmentMismatchError} When the instance record cannot prove which installation it
+ *   runs, or the installations differ and spawning is not allowed (`autoSpawn: false`, or this
+ *   process is already a child host).
+ * @throws {SpawnFailedError} When a child host cannot be resolved or started.
+ */
+declare function createTools(options: CreateToolsOptions & {
+  mode: 'local';
+}, deps?: CreateToolsDeps): Promise<LocalTools>;
+declare function createTools(options: CreateToolsOptions & {
+  mode: 'attached';
+}, deps?: CreateToolsDeps): Promise<AttachedTools>;
+declare function createTools(options?: CreateToolsOptions, deps?: CreateToolsDeps): Promise<Tools>;
+//#endregion
+//#region .dts-emit/code/core/src/cli/tools/sdk/attach-messages.d.ts
+/**
+ * Out-of-band warning for a run that attached while sibling instances also matched the project.
+ * Rendered to stderr, never into the result, so `--json` and `-o` output stay clean.
+ */
+declare function formatMultiInstanceNotice(storybook: Pick<ToolsStorybookInfo, 'url' | 'port' | 'pid' | 'cwd' | 'configDir' | 'siblings'>): string;
+//#endregion
+export { AttachUnavailableError, type AttachUnavailableReason, type AttachedTools, type CreateToolsDeps, type CreateToolsOptions, EnvironmentMismatchError, type LocalTools, SpawnFailedError, type Tools, type ToolsAttachGateReason, type ToolsCallOptions, type ToolsClientInfo, type ToolsDescribeOptions, type ToolsHostKind, type ToolsMode, type ToolsRuntime, ToolsRuntimeError, type ToolsRuntimeErrorReason, type ToolsSiblingInstance, type ToolsStorybookInfo, type ToolsetCatalog, type ToolsetCatalogEntry, type ToolsetCatalogMethod, type ToolsetJsonSchema, type ToolsetOutcome, attachGateReasonFromError, createTools, formatMultiInstanceNotice, isAttachGateError };

package/dist/cli/tools/sdk/index.js

@@ -0,0 +1,44 @@
+import CJS_COMPAT_NODE_URL_upaeg5sjpn from 'node:url';
+import CJS_COMPAT_NODE_PATH_upaeg5sjpn from 'node:path';
+import CJS_COMPAT_NODE_MODULE_upaeg5sjpn from "node:module";
+
+var __filename = CJS_COMPAT_NODE_URL_upaeg5sjpn.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_upaeg5sjpn.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_upaeg5sjpn.createRequire(import.meta.url);
+
+// ------------------------------------------------------------
+// end of CJS compatibility banner, injected by Forkbook's esbuild configuration
+// ------------------------------------------------------------
+import "../../../_node-chunks/chunk-BMJPOQ2S.js";
+import {
+  createTools
+} from "../../../_node-chunks/chunk-MBPHOLXB.js";
+import {
+  formatMultiInstanceNotice
+} from "../../../_node-chunks/chunk-DR7NW2MI.js";
+import {
+  AttachUnavailableError,
+  EnvironmentMismatchError,
+  SpawnFailedError,
+  ToolsRuntimeError,
+  attachGateReasonFromError,
+  isAttachGateError
+} from "../../../_node-chunks/chunk-BDU3ZUMK.js";
+import "../../../_node-chunks/chunk-GJSYGBI5.js";
+import "../../../_node-chunks/chunk-LX2XSPPL.js";
+import "../../../_node-chunks/chunk-ZD5TUA6I.js";
+import "../../../_node-chunks/chunk-7KD5DKGZ.js";
+import "../../../_node-chunks/chunk-MIWBXEUH.js";
+import "../../../_node-chunks/chunk-LH5QBX2U.js";
+import "../../../_node-chunks/chunk-7O2UIVID.js";
+import "../../../_node-chunks/chunk-FQGQ5KHN.js";
+export {
+  AttachUnavailableError,
+  EnvironmentMismatchError,
+  SpawnFailedError,
+  ToolsRuntimeError,
+  attachGateReasonFromError,
+  createTools,
+  formatMultiInstanceNotice,
+  isAttachGateError
+};

package/dist/cli-commands/bin/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import CJS_COMPAT_NODE_URL_upaeg5sjpn from 'node:url';
+import CJS_COMPAT_NODE_PATH_upaeg5sjpn from 'node:path';
+import CJS_COMPAT_NODE_MODULE_upaeg5sjpn from "node:module";
+
+var __filename = CJS_COMPAT_NODE_URL_upaeg5sjpn.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_upaeg5sjpn.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_upaeg5sjpn.createRequire(import.meta.url);
+
+// ------------------------------------------------------------
+// end of CJS compatibility banner, injected by Forkbook's esbuild configuration
+// ------------------------------------------------------------
+
+// src/cli-commands/bin/index.ts
+import {
+  MIN_SUPPORTED_NODE_DESCRIPTION,
+  isNodeVersionSupported
+} from "@aussieljk/forkbook/internal/common";
+import { logger } from "@aussieljk/forkbook/internal/node-logger";
+import { dedent } from "ts-dedent";
+isNodeVersionSupported(process.versions.node) || (logger.error(
+  dedent`To run Forkbook, you need Node.js version ${MIN_SUPPORTED_NODE_DESCRIPTION}.
+      You are currently running Node.js ${process.version}. Please upgrade your Node.js installation.`
+), process.exit(1));
+import("../../_node-chunks/run-TMVS3KKA.js");

package/dist/client-logger/index.d.ts

@@ -0,0 +1,31 @@
+//#region .dts-emit/code/core/src/client-logger/index.d.ts
+type LoggingFn = (message: any, ...args: any[]) => void;
+declare const logger: {
+  readonly trace: (message: any, ...rest: any[]) => void;
+  readonly debug: (message: any, ...rest: any[]) => void;
+  readonly info: (message: any, ...rest: any[]) => void;
+  readonly warn: (message: any, ...rest: any[]) => void;
+  readonly error: (message: any, ...rest: any[]) => void;
+  readonly log: (message: any, ...rest: any[]) => void;
+};
+declare function once(type: keyof typeof logger): (message: any, ...rest: any[]) => void;
+declare namespace once {
+  var clear: () => void;
+  var trace: (message: any, ...rest: any[]) => void;
+  var debug: (message: any, ...rest: any[]) => void;
+  var info: (message: any, ...rest: any[]) => void;
+  var warn: (message: any, ...rest: any[]) => void;
+  var error: (message: any, ...rest: any[]) => void;
+  var log: (message: any, ...rest: any[]) => void;
+}
+declare const deprecate: (message: any, ...rest: any[]) => void;
+declare function pretty(type: keyof typeof logger): (...args: Parameters<LoggingFn>) => void;
+declare namespace pretty {
+  var trace: (message: any, ...args: any[]) => void;
+  var debug: (message: any, ...args: any[]) => void;
+  var info: (message: any, ...args: any[]) => void;
+  var warn: (message: any, ...args: any[]) => void;
+  var error: (message: any, ...args: any[]) => void;
+}
+//#endregion
+export { deprecate, logger, once, pretty };

package/dist/client-logger/index.js

@@ -0,0 +1,65 @@
+import {
+  global
+} from "../_browser-chunks/chunk-6AKCRYVX.js";
+import "../_browser-chunks/chunk-IMSF75WX.js";
+
+// src/client-logger/index.ts
+var { LOGLEVEL } = global, levels = {
+  trace: 1,
+  debug: 2,
+  info: 3,
+  warn: 4,
+  error: 5,
+  silent: 10
+}, currentLogLevelString = LOGLEVEL, currentLogLevelNumber = levels[currentLogLevelString] || levels.info, logger = {
+  trace: (message, ...rest) => {
+    currentLogLevelNumber <= levels.trace && console.trace(message, ...rest);
+  },
+  debug: (message, ...rest) => {
+    currentLogLevelNumber <= levels.debug && console.debug(message, ...rest);
+  },
+  info: (message, ...rest) => {
+    currentLogLevelNumber <= levels.info && console.info(message, ...rest);
+  },
+  warn: (message, ...rest) => {
+    currentLogLevelNumber <= levels.warn && console.warn(message, ...rest);
+  },
+  error: (message, ...rest) => {
+    currentLogLevelNumber <= levels.error && console.error(message, ...rest);
+  },
+  log: (message, ...rest) => {
+    currentLogLevelNumber < levels.silent && console.log(message, ...rest);
+  }
+}, logged = /* @__PURE__ */ new Set(), once = (type) => (message, ...rest) => {
+  if (!logged.has(message))
+    return logged.add(message), logger[type](message, ...rest);
+};
+once.clear = () => logged.clear();
+once.trace = once("trace");
+once.debug = once("debug");
+once.info = once("info");
+once.warn = once("warn");
+once.error = once("error");
+once.log = once("log");
+var deprecate = once("warn"), pretty = (type) => (...args) => {
+  let argArray = [];
+  if (args.length) {
+    let startTagRe = /<span\s+style=(['"])([^'"]*)\1\s*>/gi, endTagRe = /<\/span>/gi, reResultArray;
+    for (argArray.push(args[0].replace(startTagRe, "%c").replace(endTagRe, "%c")); reResultArray = startTagRe.exec(args[0]); )
+      argArray.push(reResultArray[2]), argArray.push("");
+    for (let j = 1; j < args.length; j++)
+      argArray.push(args[j]);
+  }
+  logger[type].apply(logger, argArray);
+};
+pretty.trace = pretty("trace");
+pretty.debug = pretty("debug");
+pretty.info = pretty("info");
+pretty.warn = pretty("warn");
+pretty.error = pretty("error");
+export {
+  deprecate,
+  logger,
+  once,
+  pretty
+};