@aussieljk/forkbook 0.0.0-stage → 0.0.1-2

package/dist/telemetry/index.d.ts

@@ -0,0 +1,314 @@
+import { IndexEntry, PackageJson, StorybookConfig, TypescriptOptions } from "@aussieljk/forkbook/internal/types";
+import { BinaryLike } from "crypto";
+import { Attributes } from "@opentelemetry/api";
+
+//#region ../../node_modules/package-manager-detector/dist/shared/package-manager-detector.vknIX8gX.d.mts
+type Agent = 'npm' | 'yarn' | 'yarn@berry' | 'pnpm' | 'pnpm@6' | 'pnpm-rush' | 'bun' | 'deno' | 'nub' | 'aube' | 'upm';
+type AgentName = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'deno' | 'nub' | 'aube' | 'upm';
+interface DetectResult {
+  /**
+   * Agent name without the specifier.
+   *
+   * Can be `npm`, `yarn`, `pnpm`, `bun`, `deno`, `nub`, `aube`, or `upm`.
+   */
+  name: AgentName;
+  /**
+   * Agent specifier to resolve the command.
+   *
+   * May contain '@' to differentiate the version (e.g. 'yarn@berry').
+   * Use `name` for the agent name without the specifier.
+   */
+  agent: Agent;
+  /**
+   * Specific version of the agent, read from `packageManager` field in package.json.
+   */
+  version?: string;
+}
+//#endregion
+//#region .dts-emit/code/core/src/shared/utils/get-monorepo-type.d.ts
+declare const monorepoConfigs: {
+  readonly Nx: 'nx.json';
+  readonly Turborepo: 'turbo.json';
+  readonly Lerna: 'lerna.json';
+  readonly Rush: 'rush.json';
+  readonly Lage: 'lage.config.json';
+};
+type MonorepoType = keyof typeof monorepoConfigs | 'Workspaces' | undefined;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/detect-agent.d.ts
+type AgentInfo = {
+  /**
+   * The name of the detected AI coding agent (e.g. `claude`, `gemini`, `codex`, `cursor`). Can be
+   * any value supported by std-env or explicitly set via the `AI_AGENT` environment variable.
+   */
+  name: string;
+};
+type AgentDetection = AgentInfo | undefined;
+/** Detect whether Forkbook CLI is likely being invoked by an AI agent, using std-env. */
+declare const detectAgent: () => AgentDetection;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/get-known-packages.d.ts
+type PackageGroupResult = Record<string, string | null | undefined>;
+type KnownPackagesList = {
+  testPackages?: PackageGroupResult;
+  bundlerPackages?: PackageGroupResult;
+  /**
+   * Installed versions of the active renderer's UI framework runtime packages. Unlike the other
+   * groups, this is keyed off the detected Forkbook renderer rather than the project's declared
+   * dependencies, so monorepos don't report sibling frameworks.
+   */
+  rendererPackages?: PackageGroupResult;
+  stylingPackages?: PackageGroupResult;
+  stateManagementPackages?: PackageGroupResult;
+  dataFetchingPackages?: PackageGroupResult;
+  uiLibraryPackages?: PackageGroupResult;
+  i18nPackages?: PackageGroupResult;
+  routerPackages?: PackageGroupResult;
+};
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/types.d.ts
+type EventType = 'boot' | 'add' | 'dev' | 'build' | 'index' | 'init' | 'init-step' | 'scaffolded-empty' | 'browser' | 'canceled' | 'exit' | 'error' | 'error-metadata' | 'version-update' | 'core-config' | 'remove' | 'save-story' | 'open-in-editor' | 'testing-module-watch-mode' | 'testing-module-completed-report' | 'testing-module-crash-report' | 'addon-test' | 'test-run' | 'mocking' | 'preview-first-load' | 'review' | 'share' | 'ghost-stories' | 'sidebar-filter' | 'tools-command' | 'skills-get' | 'ai-init-opt-in' | 'ai-prompt-nudge' | 'ai-setup' | 'ai-setup-final-scoring' | 'ai-setup-self-healing-scoring';
+interface Dependency {
+  version: string | undefined;
+  versionSpecifier?: string;
+}
+interface StorybookAddon extends Dependency {
+  options: any;
+}
+type StorybookMetadata = {
+  storybookVersion?: string;
+  storybookVersionSpecifier: string;
+  generatedAt?: number;
+  userSince?: number; /** If we can identify the agent, report it; otherwise `unknown` when detected heuristically. */
+  agent?: AgentInfo;
+  language: 'typescript' | 'javascript';
+  framework?: {
+    name?: string;
+    options?: any;
+  };
+  builder?: string;
+  renderer?: string;
+  monorepo?: MonorepoType;
+  packageManager?: {
+    type: DetectResult['name'];
+    version: DetectResult['version'];
+    agent: DetectResult['agent'];
+    nodeLinker: NodeLinker;
+  };
+  typescriptOptions?: Partial<TypescriptOptions>;
+  addons?: Record<string, StorybookAddon>;
+  storybookPackages?: Record<string, Dependency>;
+  metaFramework?: {
+    name: string;
+    packageName: string;
+    version: string;
+  };
+  packageJsonType?: 'unknown' | 'module' | 'commonjs';
+  knownPackages?: KnownPackagesList;
+  hasRouterPackage?: boolean;
+  hasStorybookEslint?: boolean;
+  hasStaticDirs?: boolean;
+  /**
+   * Whether a Next.js project customizes webpack through the `webpack` option of `next.config.*`.
+   */
+  hasCustomWebpack?: boolean; /** Whether the Forkbook config defines `viteFinal`. */
+  hasCustomVite?: boolean;
+  hasCustomBabel?: boolean;
+  /**
+   * Whether a Next.js project's scripts opt into Turbopack via an explicit `--turbopack` /
+   * `--webpack` flag. `undefined` when no such flag is present (ambiguous from Next.js 16
+   * onwards, where Turbopack is the default) or when the project isn't using Next.js.
+   */
+  hasTurbopack?: boolean;
+  /**
+   * Whether the project has a Module Federation package installed (e.g. `@module-federation/*`
+   * or `@originjs/vite-plugin-federation`). This can't detect projects that configure webpack's
+   * built-in `ModuleFederationPlugin` directly without one of these packages.
+   */
+  hasModuleFederation?: boolean;
+  features?: StorybookConfig['features'];
+  refCount?: number;
+  preview?: {
+    usesGlobals?: boolean;
+  };
+  portableStoriesFileCount?: number;
+  applicationFileCount?: number;
+};
+interface Payload {
+  [key: string]: any;
+}
+type PayloadFactory = () => Payload | Promise<Payload>;
+type PayloadInput = Payload | PayloadFactory;
+interface Context {
+  [key: string]: any;
+}
+type YarnNodeLinker = 'node-modules' | 'pnp' | 'pnpm';
+type PnpmNodeLinker = 'isolated' | 'hoisted' | 'pnp';
+type NodeLinker = 'node_modules' | YarnNodeLinker | PnpmNodeLinker;
+interface Options {
+  retryDelay: number;
+  immediate: boolean;
+  configDir?: string;
+  enableCrashReports?: boolean;
+  stripMetadata?: boolean;
+  notify?: boolean;
+  /** Override the event timestamp. Used when flushing queued events to preserve original timing. */
+  timestamp?: number;
+  /** When true, bypass the disabled state. Used for error telemetry with enableCrashReports. */
+  force?: boolean;
+}
+interface TelemetryData {
+  eventType: EventType;
+  payload: Payload;
+  metadata?: StorybookMetadata;
+}
+interface TelemetryEvent extends TelemetryData {
+  eventId: string;
+  sessionId: string;
+  context: Context;
+}
+interface InitPayload {
+  projectType: string;
+  features: {
+    dev: boolean;
+    docs: boolean;
+    test: boolean;
+    ai: boolean;
+  };
+  versionSpecifier: string | undefined;
+  cliIntegration: string | undefined;
+}
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/one-way-hash.d.ts
+declare const oneWayHash: (payload: BinaryLike) => string;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/storybook-metadata.d.ts
+declare const metaFrameworks: Record<string, string>;
+declare const sanitizeAddonName: (name: string) => string;
+declare const computeStorybookMetadata: ({
+  packageJsonPath,
+  packageJson,
+  mainConfig,
+  configDir
+}: {
+  packageJsonPath: string;
+  packageJson: PackageJson;
+  mainConfig?: StorybookConfig & Record<string, any>;
+  configDir: string;
+}) => Promise<StorybookMetadata>;
+declare const getStorybookMetadata: (_configDir?: string) => Promise<StorybookMetadata>;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/sanitize.d.ts
+interface IErrorWithStdErrAndStdOut {
+  stderr?: Buffer | string;
+  stdout?: Buffer | string;
+  [key: string]: unknown;
+}
+declare function removeAnsiEscapeCodes(input?: string): string;
+/**
+ * Removes all user-specific file system paths from the input string, replacing them with "$SNIP".
+ * This helps sanitize sensitive user information from output (such as error messages or logs). e.g.
+ * `/Users/username/storybook-app/src/pages/index.js` -> `$SNIP/src/pages/index.js`
+ */
+declare function cleanPaths(str: string, separator?: string): string;
+declare function sanitizeError(error: Error, pathSeparator?: string): any;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/error-collector.d.ts
+/**
+ * Service for collecting errors during Forkbook initialization.
+ *
+ * This singleton class exists to accumulate non-fatal errors that occur during the Forkbook's
+ * processes. Instead of immediately reporting errors to telemetry (which could interrupt the
+ * process), errors are collected here and then batch-reported at the end of initialization via the
+ * telemetry system.
+ *
+ * This allows Forkbook to continue e.g. initialization even when non-critical errors occur,
+ * ensuring a better user experience while still capturing all errors for telemetry and debugging
+ * purposes.
+ */
+declare class ErrorCollector {
+  private static instance;
+  private errors;
+  private constructor();
+  static getInstance(): ErrorCollector;
+  static addError(error: unknown): void;
+  static getErrors(): unknown[];
+}
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/ai-setup-utils.d.ts
+/**
+ * Determines whether a story index entry was authored by the `forkbook skills setup` flow.
+ * Currently checks title prefix. When we migrate to a tag-based approach,
+ * swap this to check for the tag instead — this is the single swap point.
+ */
+declare function isStoryCreatedByAISetup(entry: IndexEntry): boolean;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/event-cache.d.ts
+interface UpgradeSummary {
+  timestamp: number;
+  eventType?: EventType;
+  eventId?: string;
+  sessionId?: string;
+}
+interface CacheEntry {
+  timestamp: number;
+  body: TelemetryEvent;
+}
+declare const getLastEvents: () => Promise<Record<EventType, CacheEntry>>;
+declare const getPrecedingUpgrade: (events?: Partial<Record<EventType, CacheEntry>> | undefined) => Promise<UpgradeSummary | undefined>;
+/**
+ * Returns true when the current session falls within the 2-hour window opened by the most recent
+ * occurrence of one of the given event types
+ *
+ * Used to gate telemetry that should only be captured during a single session window of a given event (e.g. init)
+ */
+declare function isWithinInitialSession(events: EventType | EventType[]): Promise<boolean>;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/session-id.d.ts
+declare const SESSION_TIMEOUT: number;
+declare const getSessionId: () => Promise<string>;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/telemetry.d.ts
+declare const addToGlobalContext: (key: string, value: any) => void;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/otel.d.ts
+/** Runs `run` in a trace span. Without OpenTelemetry, it only runs `run`. */
+declare function withSpan<T>(name: string, attributes: Attributes, run: () => Promise<T>): Promise<T>;
+//#endregion
+//#region .dts-emit/code/core/src/telemetry/index.d.ts
+/** Is this story part of the CLI generated examples, including user-created stories in those files */
+declare const isExampleStoryId: (storyId: string) => boolean;
+type QueuedEvent = {
+  eventType: EventType;
+  payload: PayloadInput;
+  options: Partial<Options>;
+  timestamp: number;
+};
+/**
+ * Resolve telemetry state. When enabled, flushes the queue. When disabled, clears it.
+ * This should be called once presets have been evaluated and the disableTelemetry config is known.
+ */
+declare function setTelemetryEnabled(enabled: boolean): Promise<void>;
+/** Check whether telemetry is currently enabled. */
+declare function isTelemetryModuleEnabled(): boolean;
+/** Check whether the telemetry state has been resolved (is no longer uninitialized). */
+declare function isTelemetryStateResolved(): boolean;
+/**
+ * Callback invoked when a payload factory throws or returns { error }.
+ * Registered by withTelemetry() to delegate to sendTelemetryError with full context
+ * (presets, cache, error levels, sub-errors).
+ */
+type PayloadErrorHandler = (error: Error, eventType: EventType) => Promise<void>;
+/**
+ * Register a handler for payload factory errors. When a telemetry payload factory
+ * throws or returns { error }, this handler is called instead of sending the normal event.
+ * Pass undefined to clear the handler.
+ *
+ * This is used by withTelemetry() to wire up sendTelemetryError with full context
+ * (cliOptions, presetOptions, error levels, sub-errors) so all commands benefit
+ * from automatic error telemetry.
+ */
+declare function onPayloadError(handler: PayloadErrorHandler | undefined): void;
+declare const telemetry: (eventType: EventType, payload?: PayloadInput, options?: Partial<Options>) => Promise<void>;
+//#endregion
+export { type AgentInfo, type CacheEntry, Context, Dependency, ErrorCollector, EventType, IErrorWithStdErrAndStdOut, InitPayload, NodeLinker, Options, Payload, PayloadErrorHandler, PayloadFactory, PayloadInput, PnpmNodeLinker, QueuedEvent, SESSION_TIMEOUT, StorybookAddon, StorybookMetadata, TelemetryData, TelemetryEvent, YarnNodeLinker, addToGlobalContext, cleanPaths, computeStorybookMetadata, detectAgent, getLastEvents, getPrecedingUpgrade, getSessionId, getStorybookMetadata, isExampleStoryId, isStoryCreatedByAISetup, isTelemetryModuleEnabled, isTelemetryStateResolved, isWithinInitialSession, metaFrameworks, onPayloadError, oneWayHash, removeAnsiEscapeCodes, sanitizeAddonName, sanitizeError, setTelemetryEnabled, telemetry, withSpan };

package/dist/telemetry/index.js

@@ -0,0 +1,103 @@
+import CJS_COMPAT_NODE_URL_ro17f80mg6k from 'node:url';
+import CJS_COMPAT_NODE_PATH_ro17f80mg6k from 'node:path';
+import CJS_COMPAT_NODE_MODULE_ro17f80mg6k from "node:module";
+
+var __filename = CJS_COMPAT_NODE_URL_ro17f80mg6k.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_ro17f80mg6k.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_ro17f80mg6k.createRequire(import.meta.url);
+
+// ------------------------------------------------------------
+// end of CJS compatibility banner, injected by Forkbook's esbuild configuration
+// ------------------------------------------------------------
+import {
+  ErrorCollector,
+  addToGlobalContext,
+  cleanPaths,
+  computeStorybookMetadata,
+  getLastEvents,
+  getPrecedingUpgrade,
+  getStorybookMetadata,
+  isExampleStoryId,
+  isStoryCreatedByAISetup,
+  isTelemetryModuleEnabled,
+  isTelemetryStateResolved,
+  isWithinInitialSession,
+  metaFrameworks,
+  onPayloadError,
+  oneWayHash,
+  removeAnsiEscapeCodes,
+  sanitizeAddonName,
+  sanitizeError,
+  setTelemetryEnabled,
+  telemetry,
+  withSpan
+} from "../_node-chunks/chunk-W4OMYLSP.js";
+import {
+  SESSION_TIMEOUT,
+  getSessionId
+} from "../_node-chunks/chunk-CQKMLL5J.js";
+import "../_node-chunks/chunk-5DQFEZEA.js";
+import "../_node-chunks/chunk-WAXVSN3O.js";
+import {
+  detectAgent
+} from "../_node-chunks/chunk-DHJFTB4K.js";
+import "../_node-chunks/chunk-JZOO7GGC.js";
+import "../_node-chunks/chunk-UMUBKI6E.js";
+import "../_node-chunks/chunk-JGGFYIG5.js";
+import "../_node-chunks/chunk-UVINFLGY.js";
+import "../_node-chunks/chunk-FPZB5OI7.js";
+import "../_node-chunks/chunk-GRBLDJCR.js";
+import "../_node-chunks/chunk-SWO5CDYU.js";
+import "../_node-chunks/chunk-YZFWBA5L.js";
+import "../_node-chunks/chunk-3BKIBF5S.js";
+import "../_node-chunks/chunk-SIEXZVCR.js";
+import "../_node-chunks/chunk-RZMQ7S3L.js";
+import "../_node-chunks/chunk-6LMWA44H.js";
+import "../_node-chunks/chunk-TFCEV2XX.js";
+import "../_node-chunks/chunk-MK2KYAI6.js";
+import "../_node-chunks/chunk-IDEL2J23.js";
+import "../_node-chunks/chunk-BXVYT7SB.js";
+import "../_node-chunks/chunk-SLWQNBGO.js";
+import "../_node-chunks/chunk-4FEANXWU.js";
+import "../_node-chunks/chunk-TEQGGSP7.js";
+import "../_node-chunks/chunk-OWNFOGTA.js";
+import "../_node-chunks/chunk-HMP2G23X.js";
+import "../_node-chunks/chunk-3W7F2B7P.js";
+import "../_node-chunks/chunk-OUW6R7C3.js";
+import "../_node-chunks/chunk-SVTBJ7Q3.js";
+import "../_node-chunks/chunk-JDXXX6LB.js";
+import "../_node-chunks/chunk-34EO2PUT.js";
+import "../_node-chunks/chunk-F3ZFKBHY.js";
+import "../_node-chunks/chunk-TNJIXE37.js";
+import "../_node-chunks/chunk-U5W53R2J.js";
+import "../_node-chunks/chunk-2BUPBPFB.js";
+import "../_node-chunks/chunk-FW2HQUBQ.js";
+import "../_node-chunks/chunk-DC7DKR5K.js";
+import "../_node-chunks/chunk-ZMAMXQKP.js";
+import "../_node-chunks/chunk-CXRU72ET.js";
+export {
+  ErrorCollector,
+  SESSION_TIMEOUT,
+  addToGlobalContext,
+  cleanPaths,
+  computeStorybookMetadata,
+  detectAgent,
+  getLastEvents,
+  getPrecedingUpgrade,
+  getSessionId,
+  getStorybookMetadata,
+  isExampleStoryId,
+  isStoryCreatedByAISetup,
+  isTelemetryModuleEnabled,
+  isTelemetryStateResolved,
+  isWithinInitialSession,
+  metaFrameworks,
+  onPayloadError,
+  oneWayHash,
+  removeAnsiEscapeCodes,
+  sanitizeAddonName,
+  sanitizeError,
+  setTelemetryEnabled,
+  telemetry,
+  withSpan
+};

package/dist/test/index.d.ts

@@ -0,0 +1,158 @@
+/// <reference types="chai" preserve="true" />
+import * as domTestingLibrary from "@testing-library/dom";
+import { FireObject } from "@testing-library/dom";
+import * as _userEvent from "@testing-library/user-event";
+import { userEvent as userEvent$1 } from "@testing-library/user-event";
+import { MaybeMocked, MaybeMockedDeep, MaybePartiallyMocked, MaybePartiallyMockedDeep, Mock, MockInstance, isMockFunction, mocks, spyOn as spyOn$1 } from "@vitest/spy";
+import { TestingLibraryMatchers } from "@testing-library/jest-dom/matchers";
+import { AsymmetricMatchersContaining, ExpectStatic, JestAssertion, MatcherState, MatchersObject } from "@vitest/expect";
+export * from "@vitest/spy";
+
+//#region .dts-emit/code/core/src/test/spy.d.ts
+type Listener = (mock: MockInstance, args: unknown[]) => void;
+declare function onMockCall(callback: Listener): () => void;
+declare const spyOn: typeof spyOn$1;
+type Procedure = Mock extends Mock<infer T> ? T : never;
+declare function fn<T extends Procedure = Procedure>(implementation?: T): Mock<T>;
+/**
+ * Calls [`.mockClear()`](https://vitest.dev/api/mock#mockclear) on every mocked function. This will
+ * only empty `.mock` state, it will not reset implementation.
+ *
+ * It is useful if you need to clean up mock between different assertions.
+ */
+declare function clearAllMocks(): void;
+/**
+ * Calls [`.mockReset()`](https://vitest.dev/api/mock#mockreset) on every mocked function. This will
+ * empty `.mock` state, reset "once" implementations and force the base implementation to return
+ * `undefined` when invoked.
+ *
+ * This is useful when you want to completely reset a mock to the default state.
+ */
+declare function resetAllMocks(): void;
+/**
+ * Calls [`.mockRestore()`](https://vitest.dev/api/mock#mockrestore) on every mocked function. This
+ * will restore all original implementations.
+ */
+declare function restoreAllMocks(): void;
+/**
+ * Type helper for TypeScript. Just returns the object that was passed.
+ *
+ * When `partial` is `true` it will expect a `Partial<T>` as a return value. By default, this will
+ * only make TypeScript believe that the first level values are mocked. You can pass down `{ deep:
+ * true }` as a second argument to tell TypeScript that the whole object is mocked, if it actually
+ * is.
+ *
+ * @param item Anything that can be mocked
+ * @param deep If the object is deeply mocked
+ * @param options If the object is partially or deeply mocked
+ */
+declare function mocked<T>(item: T, deep?: false): MaybeMocked<T>;
+declare function mocked<T>(item: T, deep: true): MaybeMockedDeep<T>;
+declare function mocked<T>(item: T, options: {
+  partial?: false;
+  deep?: false;
+}): MaybeMocked<T>;
+declare function mocked<T>(item: T, options: {
+  partial?: false;
+  deep: true;
+}): MaybeMockedDeep<T>;
+declare function mocked<T>(item: T, options: {
+  partial: true;
+  deep?: false;
+}): MaybePartiallyMocked<T>;
+declare function mocked<T>(item: T, options: {
+  partial: true;
+  deep: true;
+}): MaybePartiallyMockedDeep<T>;
+declare function mocked<T>(item: T): MaybeMocked<T>;
+//#endregion
+//#region .dts-emit/code/core/src/test/utils.d.ts
+type Promisify<Fn> = Fn extends {
+  <T>(...args: infer Args): infer Return;
+} ? {
+  <T>(...args: Args): Return extends Promise<any> ? Return : Promise<Return>;
+} : Fn extends {
+  (...args: infer Args): infer Return;
+} ? {
+  (...args: Args): Return extends Promise<any> ? Return : Promise<Return>;
+} : Fn;
+type PromisifyObject<O> = { [K in keyof O]: Promisify<O[K]> };
+//#endregion
+//#region .dts-emit/code/core/src/test/expect.d.ts
+type Matchers<T> = PromisifyObject<JestAssertion<T>> & TestingLibraryMatchers<ReturnType<ExpectStatic['stringContaining']>, Promise<void>>;
+interface Assertion<T> extends Matchers<T> {
+  toHaveBeenCalledOnce(): Promise<void>;
+  toSatisfy<E>(matcher: (value: E) => boolean, message?: string): Promise<void>;
+  resolves: Assertion<T>;
+  rejects: Assertion<T>;
+  not: Assertion<T>;
+}
+interface Expect extends AsymmetricMatchersContaining {
+  <T>(actual: T, message?: string): Assertion<T>;
+  unreachable(message?: string): Promise<never>;
+  soft<T>(actual: T, message?: string): Assertion<T>;
+  extend(expects: MatchersObject): void;
+  assertions(expected: number): Promise<void>;
+  hasAssertions(): Promise<void>;
+  anything: ExpectStatic['anything'];
+  any: ExpectStatic['any'];
+  getState(): MatcherState;
+  setState(state: Partial<MatcherState>): void;
+  not: AsymmetricMatchersContaining;
+}
+//#endregion
+//#region .dts-emit/code/core/src/test/testing-library.d.ts
+declare const buildQueries: typeof domTestingLibrary.buildQueries, configure: typeof domTestingLibrary.configure, createEvent: domTestingLibrary.CreateObject & domTestingLibrary.CreateFunction, fireEvent: (<T>(element: Document | Element | Node | Window, event: Event) => Promise<false> | Promise<true>) & PromisifyObject<FireObject>, findAllByAltText: typeof domTestingLibrary.findAllByAltText, findAllByDisplayValue: typeof domTestingLibrary.findAllByDisplayValue, findAllByLabelText: typeof domTestingLibrary.findAllByLabelText, findAllByPlaceholderText: typeof domTestingLibrary.findAllByPlaceholderText, findAllByRole: typeof domTestingLibrary.findAllByRole, findAllByTestId: typeof domTestingLibrary.findAllByTestId, findAllByText: typeof domTestingLibrary.findAllByText, findAllByTitle: typeof domTestingLibrary.findAllByTitle, findByAltText: typeof domTestingLibrary.findByAltText, findByDisplayValue: typeof domTestingLibrary.findByDisplayValue, findByLabelText: typeof domTestingLibrary.findByLabelText, findByPlaceholderText: typeof domTestingLibrary.findByPlaceholderText, findByRole: typeof domTestingLibrary.findByRole, findByTestId: typeof domTestingLibrary.findByTestId, findByText: typeof domTestingLibrary.findByText, findByTitle: typeof domTestingLibrary.findByTitle, getAllByAltText: typeof domTestingLibrary.getAllByAltText, getAllByDisplayValue: typeof domTestingLibrary.getAllByDisplayValue, getAllByLabelText: typeof domTestingLibrary.getAllByLabelText, getAllByPlaceholderText: typeof domTestingLibrary.getAllByPlaceholderText, getAllByRole: typeof domTestingLibrary.getAllByRole, getAllByTestId: typeof domTestingLibrary.getAllByTestId, getAllByText: typeof domTestingLibrary.getAllByText, getAllByTitle: typeof domTestingLibrary.getAllByTitle, getByAltText: typeof domTestingLibrary.getByAltText, getByDisplayValue: typeof domTestingLibrary.getByDisplayValue, getByLabelText: typeof domTestingLibrary.getByLabelText, getByPlaceholderText: typeof domTestingLibrary.getByPlaceholderText, getByRole: typeof domTestingLibrary.getByRole, getByTestId: typeof domTestingLibrary.getByTestId, getByText: typeof domTestingLibrary.getByText, getByTitle: typeof domTestingLibrary.getByTitle, getConfig: typeof domTestingLibrary.getConfig, getDefaultNormalizer: typeof domTestingLibrary.getDefaultNormalizer, getElementError: typeof domTestingLibrary.getElementError, getNodeText: typeof domTestingLibrary.getNodeText, getQueriesForElement: typeof domTestingLibrary.getQueriesForElement, getRoles: typeof domTestingLibrary.getRoles, getSuggestedQuery: typeof domTestingLibrary.getSuggestedQuery, isInaccessible: typeof domTestingLibrary.isInaccessible, logDOM: typeof domTestingLibrary.logDOM, logRoles: typeof domTestingLibrary.logRoles, prettyDOM: typeof domTestingLibrary.prettyDOM, queries: typeof domTestingLibrary.queries, queryAllByAltText: typeof domTestingLibrary.queryAllByAltText, queryAllByAttribute: domTestingLibrary.AllByAttribute, queryAllByDisplayValue: typeof domTestingLibrary.queryAllByDisplayValue, queryAllByLabelText: typeof domTestingLibrary.queryAllByLabelText, queryAllByPlaceholderText: typeof domTestingLibrary.queryAllByPlaceholderText, queryAllByRole: typeof domTestingLibrary.queryAllByRole, queryAllByTestId: typeof domTestingLibrary.queryAllByTestId, queryAllByText: typeof domTestingLibrary.queryAllByText, queryAllByTitle: typeof domTestingLibrary.queryAllByTitle, queryByAltText: typeof domTestingLibrary.queryByAltText, queryByAttribute: domTestingLibrary.QueryByAttribute, queryByDisplayValue: typeof domTestingLibrary.queryByDisplayValue, queryByLabelText: typeof domTestingLibrary.queryByLabelText, queryByPlaceholderText: typeof domTestingLibrary.queryByPlaceholderText, queryByRole: typeof domTestingLibrary.queryByRole, queryByTestId: typeof domTestingLibrary.queryByTestId, queryByText: typeof domTestingLibrary.queryByText, queryByTitle: typeof domTestingLibrary.queryByTitle, queryHelpers: typeof domTestingLibrary.queryHelpers, screen: domTestingLibrary.Screen<typeof domTestingLibrary.queries>, waitFor: typeof domTestingLibrary.waitFor, waitForElementToBeRemoved: typeof domTestingLibrary.waitForElementToBeRemoved, within: typeof domTestingLibrary.getQueriesForElement, prettyFormat: typeof domTestingLibrary.prettyFormat;
+type _UserEvent = typeof _userEvent;
+interface UserEvent extends _UserEvent {}
+declare const uninstrumentedUserEvent: {
+  readonly setup: typeof import("@testing-library/user-event/dist/cjs/setup/setup.js").setupMain;
+  readonly clear: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").clear;
+  readonly click: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").click;
+  readonly copy: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").copy;
+  readonly cut: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").cut;
+  readonly dblClick: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").dblClick;
+  readonly deselectOptions: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").deselectOptions;
+  readonly hover: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").hover;
+  readonly keyboard: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").keyboard;
+  readonly pointer: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").pointer;
+  readonly paste: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").paste;
+  readonly selectOptions: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").selectOptions;
+  readonly tripleClick: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").tripleClick;
+  readonly type: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").type;
+  readonly unhover: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").unhover;
+  readonly upload: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").upload;
+  readonly tab: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").tab;
+};
+declare const userEvent: {
+  readonly setup: typeof import("@testing-library/user-event/dist/cjs/setup/setup.js").setupMain;
+  readonly clear: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").clear;
+  readonly click: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").click;
+  readonly copy: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").copy;
+  readonly cut: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").cut;
+  readonly dblClick: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").dblClick;
+  readonly deselectOptions: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").deselectOptions;
+  readonly hover: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").hover;
+  readonly keyboard: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").keyboard;
+  readonly pointer: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").pointer;
+  readonly paste: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").paste;
+  readonly selectOptions: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").selectOptions;
+  readonly tripleClick: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").tripleClick;
+  readonly type: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").type;
+  readonly unhover: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").unhover;
+  readonly upload: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").upload;
+  readonly tab: typeof import("@testing-library/user-event/dist/cjs/setup/directApi.js").tab;
+};
+//#endregion
+//#region .dts-emit/code/core/src/test/index.d.ts
+type UserEventObject = ReturnType<typeof userEvent$1.setup>;
+declare const expect: import("@aussieljk/forkbook/test").Expect;
+type ModuleMockOptions = {
+  spy?: boolean;
+};
+type ReturnTypeOfModuleMocker = (path: string | Promise<unknown>, factory?: ModuleMockOptions) => void;
+declare const sb: {
+  mock: ReturnTypeOfModuleMocker;
+};
+//#endregion
+export { type Assertion, type Expect, UserEvent, UserEventObject, buildQueries, clearAllMocks, configure, createEvent, expect, findAllByAltText, findAllByDisplayValue, findAllByLabelText, findAllByPlaceholderText, findAllByRole, findAllByTestId, findAllByText, findAllByTitle, findByAltText, findByDisplayValue, findByLabelText, findByPlaceholderText, findByRole, findByTestId, findByText, findByTitle, fireEvent, fn, getAllByAltText, getAllByDisplayValue, getAllByLabelText, getAllByPlaceholderText, getAllByRole, getAllByTestId, getAllByText, getAllByTitle, getByAltText, getByDisplayValue, getByLabelText, getByPlaceholderText, getByRole, getByTestId, getByText, getByTitle, getConfig, getDefaultNormalizer, getElementError, getNodeText, getQueriesForElement, getRoles, getSuggestedQuery, isInaccessible, isMockFunction, logDOM, logRoles, mocked, mocks, onMockCall, prettyDOM, prettyFormat, queries, queryAllByAltText, queryAllByAttribute, queryAllByDisplayValue, queryAllByLabelText, queryAllByPlaceholderText, queryAllByRole, queryAllByTestId, queryAllByText, queryAllByTitle, queryByAltText, queryByAttribute, queryByDisplayValue, queryByLabelText, queryByPlaceholderText, queryByRole, queryByTestId, queryByText, queryByTitle, queryHelpers, resetAllMocks, restoreAllMocks, sb, screen, spyOn, uninstrumentedUserEvent, userEvent, waitFor, waitForElementToBeRemoved, within };