@theholocron/holocron-config 8.4.5 → 8.4.7

package/dist/configs/monorepo.d.ts

@@ -1,4 +1,4 @@
-import { ComposedPreset } from "@theholocron/cli";
+import { n as ComposedPreset } from "../index-BZQJvxGu.js";
 //#region configs/monorepo.d.ts
 /**
  * Wraps any composed preset with monorepo-specific overrides

package/dist/configs/nextjs.d.ts

@@ -1,2 +1,2 @@
-import { n as NextjsOptions, t as nextjs } from "../nextjs-DF6ifcAm.js";
+import { n as NextjsOptions, t as nextjs } from "../nextjs-CorAF9jM.js";
 export { type NextjsOptions, nextjs };

package/dist/configs/nextjs.js

@@ -1,2 +1,2 @@
-import { t as nextjs } from "../nextjs-Q-9hbfm1.js";
+import { t as nextjs } from "../nextjs-DAzq_mG7.js";
 export { nextjs };

package/dist/configs/node-docs.d.ts

@@ -1,4 +1,4 @@
-import { ComposedPreset } from "@theholocron/cli";
+import { n as ComposedPreset } from "../index-BZQJvxGu.js";
 //#region configs/node-docs.d.ts
 type NodeDocsPreset = ComposedPreset;
 type NodeDocsSitePreset = ComposedPreset;

package/dist/configs/node-docs.js

@@ -1,2 +1,2 @@
-import { n as nodeDocsSite, t as nodeDocs } from "../node-docs-CcZ9-AX_.js";
+import { n as nodeDocsSite, t as nodeDocs } from "../node-docs-DI6yiUlZ.js";
 export { nodeDocs, nodeDocsSite };

package/dist/configs/node.d.ts

@@ -1,4 +1,4 @@
-import { ComposedPreset } from "@theholocron/cli";
+import { n as ComposedPreset } from "../index-BZQJvxGu.js";
 //#region configs/node.d.ts
 /**
  * Base preset for theholocron Node.js repositories.

package/dist/configs/node.js

@@ -1,5 +1,4 @@
-import { t as node$1 } from "../node-BLjkrd5k.js";
-import { compose } from "@theholocron/cli";
+import { n as compose, t as node$1 } from "../node-C6uBnA36.js";
 //#region configs/node.ts
 /**
 * Base preset for theholocron Node.js repositories.

package/dist/configs/react.d.ts

@@ -1,2 +1,2 @@
-import { n as ReactOptions, t as react } from "../react-Da48S4-Q.js";
+import { n as ReactOptions, t as react } from "../react-C7k74R65.js";
 export { type ReactOptions, react };

package/dist/configs/react.js

@@ -1,7 +1,6 @@
-import { t as node } from "../node-BLjkrd5k.js";
+import { n as compose, t as node } from "../node-C6uBnA36.js";
 import { t as typecheck } from "../typecheck-CG1ePvP6.js";
 import { t as react$1 } from "../react-4Ap2ev6C.js";
-import { compose } from "@theholocron/cli";
 //#region configs/react.ts
 /**
 * Preset for single-package React/Vite application repos. Includes Storybook,

package/dist/index-BZQJvxGu.d.ts

@@ -0,0 +1,497 @@
+//#region ../../node_modules/.pnpm/@theholocron+cli@5.0.0-alpha.3_@astrojs+react@6.0.4_@types+node@26.5.0_@types+react-dom_06b2c823ae2f3941c2eddca67aad934c/node_modules/@theholocron/cli/dist/plugin/capabilities.d.mts
+//#region src/plugin/capabilities.d.ts
+/**
+ * Capability interfaces — the contracts that providers implement.
+ *
+ * Each capability has a stable key (`'source'`, `'ci'`, …) and a
+ * cardinality (`'single'` = one provider; `'many'` = several active
+ * at once). The cardinality is part of the type contract via
+ * `CardinalityFor<K>` so config resolution + command code can branch
+ * statically.
+ *
+ * See `docs/wiki/specifications/tech-architecture.spec.md` for the design narrative
+ * (issue: #74).
+ */
+type CapabilityKey = "source" | "ci" | "secrets" | "environments" | "issues" | "deployment" | "storage" | "auth" | "vault" | "dns" | "tooling" | "notifications" | "analytics" | "errors" | "logs" | "wiki" | "workers";
+type TeamPermission = "pull" | "triage" | "push" | "maintain" | "admin";
+/** Shorthand `"slug"` defaults to `push` permission. */
+type TeamEntry = string | {
+  slug: string;
+  permission: TeamPermission;
+};
+//#endregion
+//#region ../../node_modules/.pnpm/@theholocron+observability@0.3.2_@axiomhq+pino@2.0.0_@sentry+node@10.70.0_@opentelemetr_54d8c9cd9043e393a104e3e16de7b704/node_modules/@theholocron/observability/dist/logger-CIRNGqYs.d.mts
+/** Log levels, ordered least to most severe. */
+type LogLevel = "debug" | "info" | "warn" | "error";
+//#endregion
+//#region ../../node_modules/.pnpm/@theholocron+cli@5.0.0-alpha.3_@astrojs+react@6.0.4_@types+node@26.5.0_@types+react-dom_06b2c823ae2f3941c2eddca67aad934c/node_modules/@theholocron/cli/dist/index.d.mts
+//#endregion
+//#region src/config/config.d.ts
+/** Structured-logging config. The Axiom **token** never lives here — only in
+ *  env vars or the OS keyring — but the non-secret dataset name may. */
+interface LogConfig {
+  /**
+   * Default log level. The lowest-priority level source: `--verbose` /
+   * `--quiet` and `HOLOCRON_LOG_LEVEL` both outrank it.
+   */
+  level?: LogLevel;
+  /**
+   * Axiom log-shipping. Set `axiom.dataset` to opt local runs into Axiom
+   * without exporting `HOLOCRON_AXIOM_DATASET` — the CLI then pairs it with
+   * the token from `HOLOCRON_AXIOM_TOKEN` / `AXIOM_TOKEN` or the OS keyring
+   * (`holocron auth set axiom[.<org>] <TOKEN>`). Env vars still win. In CI,
+   * prefer the `HOLOCRON_AXIOM_DATASET` variable.
+   */
+  axiom?: {
+    /** Target Axiom dataset, e.g. `"holocron-local"`. */
+    dataset?: string;
+  };
+}
+/**
+ * CLI self-telemetry config — the committed, reviewable override layer over the
+ * env-var + shipped-fallback activation (ADR-0007 / ADR-0008). No secret lives
+ * here; the Sentry DSN and PostHog key come from env vars or ship as fallbacks.
+ *
+ * Precedence: `HOLOCRON_TELEMETRY=false` (env) → `telemetry.enabled` (this) →
+ * default on. `enabled` never *re-enables* what the env var turned off.
+ */
+interface TelemetryConfig {
+  /**
+   * Repo-level opt-out — the committed peer of `HOLOCRON_TELEMETRY=false`.
+   * `false` installs the no-op sinks for the whole run. Default on.
+   */
+  enabled?: boolean;
+  /**
+   * Usage-analytics provider. `"none"` disables PostHog usage analytics while
+   * leaving error reporting (Sentry) untouched. Default `"posthog"`.
+   */
+  analytics?: "posthog" | "none";
+}
+type ProviderOptions = Record<string, unknown>;
+type SingleEntry = string | [provider: string, options: ProviderOptions];
+type MultiEntry = Array<string | [provider: string, options: ProviderOptions]>;
+type RawProviderEntry = SingleEntry | MultiEntry;
+type RawProvidersConfig = Partial<Record<CapabilityKey, RawProviderEntry>>;
+type RepoProtection = "balanced" | "strict" | "none";
+/**
+ * Raw `docs` config as written by the user. `build` is optional so the
+ * field can be declared without committing to a build type yet; setup
+ * will error if `docs` is present but `build` is absent.
+ */
+interface DocsConfig {
+  /**
+   * GitHub Pages build source.
+   * "workflow" → GitHub Actions  (PUT { build_type: "workflow" })
+   * "branch"   → classic gh-pages branch (PUT { build_type: "legacy", source: { branch: "gh-pages", path: "/" } })
+   * When absent, Pages is not managed by `holocron setup`.
+   */
+  build?: "workflow" | "branch";
+  /**
+   * Custom domain / CNAME (e.g. "docs.theholocron.dev").
+   * When set and `homepage` is not explicitly provided, setup derives
+   * `homepage` as `https://{domain}/` for package.json and the repo website field.
+   */
+  domain?: string;
+  /** Enforce HTTPS. Only effective once the custom domain is DNS-verified. */
+  https?: boolean;
+}
+interface RepoProperties {
+  lifecycle?: "active" | "experimental" | "deprecated";
+  open_source?: boolean;
+  runtime_environment?: "node" | "browser" | "universal" | "none";
+  uses_external_packages?: boolean;
+}
+interface RepoConfig {
+  /** "owner/name" — the GitHub repository coordinate. Derived from the git remote when absent. */
+  name?: string;
+  /**
+   * Branch protection preset applied by `holocron setup`. When omitted,
+   * no protection is applied and no `branch_protection_level` property is set.
+   * Required-status-check contexts for `"strict"` are derived from the task
+   * manifest — `{ required: true }` tasks + top-level `extraRequiredChecks`
+   * (see `astromech.requiredChecks()`).
+   */
+  protection?: RepoProtection;
+  /**
+   * GitHub teams granted repository access. Synced by `holocron setup`, which
+   * also writes `.github/CODEOWNERS` for teams with write-or-higher permission.
+   * String shorthand defaults to `push` (Write).
+   */
+  teams?: TeamEntry[];
+  /** GitHub topics set on the repository. */
+  topics?: string[];
+  /** GitHub custom properties synced to the org dashboard. */
+  properties?: RepoProperties;
+}
+interface AppConfig {
+  name: string;
+  path: string;
+  kind?: string;
+}
+interface DoctorConfig {
+  checks?: string[];
+}
+interface EnvConfig {
+  /**
+   * Namespace prefixes used by this project's env vars.
+   * Listed from least- to most-specific (cascade model — last wins).
+   * Tooling reads this to generate `.env.example`, validate required
+   * vars, and produce documentation.
+   *
+   * @example
+   * // Project-only prefix
+   * namespaces: ["CLI_TEMPLATE"]
+   *
+   * // Org-wide defaults + project-specific overrides
+   * namespaces: ["HOLOCRON", "MY_CLI"]
+   */
+  namespaces?: string[];
+}
+/**
+ * A single Chromatic project entry in a monorepo `run-chromatic` config.
+ * Each entry produces one matrix job in CI, publishing to a separate Chromatic project.
+ *
+ * The `tokenName` maps to a repository secret named `CHROMATIC_PROJECT_TOKEN_<TOKENNAME>`.
+ * Additional fields correspond to chromaui/action inputs and are passed through directly.
+ *
+ * @see https://www.chromatic.com/docs/monorepos/
+ */
+interface ChromaticProjectConfig {
+  /**
+   * Secret suffix. The CI job reads `CHROMATIC_PROJECT_TOKEN_<tokenName>`.
+   * Must be uppercase (e.g. `"WEB"`, `"UI"`).
+   */
+  tokenName: string;
+  /**
+   * Path to run the Chromatic build from, relative to the repo root.
+   * Typically the package directory (e.g. `"apps/web"`, `"packages/ui"`).
+   */
+  workingDir: string;
+  /**
+   * Script name to build Storybook. Defaults to `"build:storybook"`.
+   * Must accept `--output-dir` pass-through (use `turbo run … --` at root).
+   */
+  buildScript?: string;
+  /**
+   * Path to the Storybook folder relative to `workingDir`, for TurboSnap.
+   * Tells Chromatic where to find `.storybook/` when the Storybook config
+   * is in a subdirectory. Corresponds to `--storybook-base-dir`.
+   */
+  storybookBaseDir?: string;
+  /**
+   * Glob patterns of files/dirs that should NOT trigger a TurboSnap bailout
+   * when changed. Useful for ignoring non-UI changes in a monorepo
+   * (e.g. `"./packages/!(ui)/**"` to focus TurboSnap on the UI package).
+   * Corresponds to `--untraced`. Accepts a single glob string or array.
+   */
+  untraced?: string | string[];
+  /**
+   * Glob patterns matching story files to snapshot. When set, only matching
+   * stories are captured. Corresponds to `--only-story-files`.
+   * Cannot be combined with `onlyStoryNames`.
+   */
+  onlyStoryFiles?: string;
+  /**
+   * Exit with code 0 even when visual changes are detected.
+   * Useful during initial setup before baselines are approved.
+   * Corresponds to `--exit-zero-on-changes`.
+   */
+  exitZeroOnChanges?: boolean;
+}
+/**
+ * A single Storybook app in a deploy workflow config.
+ * `name` becomes the sandbox sub-path (`_site/sandbox/<name>/`).
+ * `path` is the working directory relative to the repo root; defaults to `"."` (repo root) when omitted.
+ */
+interface StorybookDeployProject {
+  name?: string;
+  path?: string;
+}
+/**
+ * Typed `with:` inputs for reusable workflows.
+ *
+ * `run-chromatic` accepts either a plain boolean (single-project) or a
+ * `ChromaticProjectConfig[]` object (multi-project monorepo).
+ *
+ * `docs` / `storybook` are high-level deploy shorthand that `holocron setup`
+ * translates to `type` / `storybook-projects` before writing the thin caller.
+ * They also drive automatic `paths:` derivation so you never need to write
+ * `paths:` manually for deploy entries.
+ */
+type WorkflowWithConfig = Record<string, unknown> & {
+  "run-chromatic"?: boolean | {
+    projects: ChromaticProjectConfig[];
+  };
+  /**
+   * Docs deployment shorthand. `true` uses the org-standard `docs/` directory;
+   * `{ path: "custom" }` uses a custom directory. Both derive a `paths:` entry automatically.
+   */
+  docs?: true | {
+    path: string;
+  };
+  /** Storybook apps to deploy alongside docs. Each entry's `path` is appended to `paths:`. */
+  storybook?: StorybookDeployProject[];
+};
+/**
+ * A `tasks` manifest entry in object form. A bare string entry is shorthand
+ * for `{ name, ci: true, local: true }`.
+ */
+interface TaskEntryConfig {
+  name: string;
+  with?: WorkflowWithConfig;
+  paths?: string[];
+  linters?: string[];
+  /** Emit a `.github/workflows/<name>.yml` thin caller + include in `holocron ci`. Default `true`. */
+  ci?: boolean;
+  /** Write a `package.json` script + let `holocron run <name>` resolve the task. Default `true`. */
+  local?: boolean;
+  /** The task's CI check context is a required status check + part of `holocron ci`'s default run. */
+  required?: boolean;
+}
+interface HolocronConfig {
+  /** Project name. Derived from package.json when absent. */
+  name?: string;
+  description?: string;
+  /** Project homepage URL. Synced to package.json#homepage and the GitHub repo's website field by `holocron sync`. */
+  homepage?: string;
+  /**
+   * Active org name for namespaced keyring lookup. When set, token resolution
+   * tries `<service>.<org>` before the unnamespaced `<service>` fallback, so
+   * a single machine can hold credentials for multiple GitHub orgs without
+   * collision. Overridden by `--org` CLI flag or `HOLOCRON_ORG` env var.
+   */
+  org?: string;
+  /**
+   * Org canonical domain (e.g. `"theholocron.dev"`). Subdomains are derived
+   * from this — `preview: true` on a deploy workflow resolves the preview base
+   * domain as `preview.<domain>`, giving URLs like `<repo>-pr-<n>.<domain>`.
+   */
+  domain?: string;
+  /**
+   * Repository identity and metadata. When set, `PluginLoader` injects
+   * `repo.name` into every plugin's `RuntimeContext.repo` so plugins that
+   * need a repo (github, etc.) don't require `--repo` on every invocation.
+   * `--repo` on the command line still overrides.
+   */
+  repo?: RepoConfig;
+  /**
+   * The task manifest — what this repo runs. Each entry is a task name
+   * (backed by a reusable workflow in `theholocron/.github`), or the object
+   * form to pass `with:` inputs. `@theholocron/astromech` reads this as the
+   * single source for `holocron run` / `holocron ci` / the generated CI
+   * workflows / `package.json` scripts.
+   *
+   * Supported values (intent-facing vocabulary — epic #672, D3):
+   *   "verification.unitTests" | "verification.typeSafety" | "verification.performance" |
+   *   "sourceQuality.staticAnalysis" | "sourceQuality.formatting" |
+   *   "sourceQuality.structuredDataValidation" | "sourceQuality.deadCodeAnalysis" |
+   *   "security.secretDetection" | "security.codeScanning" |
+   *   "delivery.build" | "delivery.publish" | "delivery.deploy" | "delivery.bundleSize" |
+   *   "platform.repoSync" | "platform.commitStandards" | "platform.repoValidation" |
+   *   "knowledge.wiki" | "knowledge.docs" | "knowledge.components" |
+   *   "review" | "tag" | "stale" | "greetings" | "dependencies" | "bookkeeping"
+   *
+   * `holocron setup` writes `.github/workflows/<name>.yml` for each entry,
+   * calling the corresponding reusable workflow in `theholocron/.github`.
+   * Files are overwritten on each run — they are generated artifacts.
+   *
+   * ### delivery.deploy / knowledge.docs / knowledge.components
+   * `delivery.deploy` uses `docs` and/or `storybook` in `with:` — setup
+   * derives `paths:` automatically. `docs: true` uses the org-standard
+   * `docs/` directory; `docs: { path: "custom" }` overrides it.
+   * `knowledge.docs` / `knowledge.components` are the same underlying
+   * mechanism, each dedicated to exactly one type — they imply the
+   * corresponding shorthand, so a repo using them never has to spell out
+   * `docs: true` / `storybook: […]` itself.
+   *
+   * ```ts
+   * // Docs only (standard layout)
+   * { name: "delivery.deploy", with: { docs: true } }
+   * // …or equivalently, the dedicated task:
+   * "knowledge.docs"
+   *
+   * // Docs + monorepo storybooks
+   * {
+   *   name: "delivery.deploy",
+   *   with: {
+   *     docs: true,
+   *     storybook: [
+   *       { name: "web", path: "apps/web" },
+   *       { name: "ui", path: "packages/ui" },
+   *     ],
+   *   },
+   * }
+   *
+   * // Non-standard docs location
+   * { name: "delivery.deploy", with: { docs: { path: "packages/site" } } }
+   * ```
+   *
+   * ### run-chromatic
+   * For a single-project repo, use `"run-chromatic": true` with a
+   * `CHROMATIC_PROJECT_TOKEN` repository secret.
+   *
+   * For monorepos with multiple Storybooks, use the object form:
+   * ```ts
+   * "run-chromatic": {
+   *   projects: [
+   *     { tokenName: "WEB", workingDir: "apps/web" },
+   *     { tokenName: "UI",  workingDir: "packages/ui" },
+   *   ]
+   * }
+   * ```
+   * Each `tokenName` maps to a repository secret named
+   * `CHROMATIC_PROJECT_TOKEN_<TOKENNAME>`. `holocron setup` expands this
+   * to the flat `run-chromatic: true` + `chromatic-projects: <json>` inputs
+   * that the reusable workflow accepts.
+   *
+   * @example
+   * ["sourceQuality.staticAnalysis", { "name": "delivery.publish", "with": { "run-build": false } }]
+   * { "name": "delivery.deploy", "with": { "docs": true } }
+   */
+  tasks?: Array<string | TaskEntryConfig>;
+  /**
+   * Opt out of `holocron sync`'s `package.json` script writes. Default `true`.
+   */
+  syncScripts?: boolean;
+  /**
+   * The command the synced `"holocron"` `package.json` script runs. Default
+   * `"holocron"` (the installed bin). This repo overrides it to run its own
+   * build (`"node packages/cli/dist/cli.mjs"`).
+   */
+  holocronScript?: string;
+  /**
+   * Required status-check contexts not backed by a `required` task (codecov
+   * gates, the bundle-build check, …). `holocron setup` appends these to the
+   * task-derived list from `astromech.requiredChecks()`.
+   */
+  extraRequiredChecks?: string[];
+  /**
+   * Git hooks `holocron setup` installs. `true` / `{ prePush: true }` writes
+   * `.husky/pre-push` (runs `holocron ci` before every push); `false` /
+   * `{ prePush: false }` opts out. Omitted → on for `protection: "strict"`,
+   * off otherwise. `--hooks` / `--no-hooks` on `holocron setup` override.
+   */
+  hooks?: boolean | {
+    prePush?: boolean;
+  };
+  providers: RawProvidersConfig;
+  apps?: AppConfig[];
+  doctor?: DoctorConfig;
+  /**
+   * Agent runtime that determines where skills are installed by `holocron setup`.
+   * Skills are installed to `.agents/skills/<name>/` (canonical) with a
+   * relative symlink at the agent-specific path:
+   * - `"claude"` → `.claude/skills/<name>` → `../../.agents/skills/<name>`
+   * - `"codex"` | `"gemini"` → logged as unsupported; skipped gracefully.
+   */
+  agent?: "claude" | "codex" | "gemini";
+  /**
+   * Skill names from `@theholocron/skills` to install during `holocron setup`.
+   * Installed paths are gitignored and managed by setup — do not commit them.
+   *
+   * @example
+   * ["git-safety", "pr-workflow", "commit-standards"]
+   */
+  skills?: string[];
+  /**
+   * GitHub Pages configuration. When present, `holocron setup` calls the
+   * Pages API using `HOLOCRON_DEPLOY_TOKEN` (requires `pages:write` + `repo` scope).
+   * When absent, Pages is left as-is.
+   *
+   * @example
+   * { build: "workflow", domain: "docs.theholocron.dev", https: true }
+   */
+  docs?: DocsConfig;
+  /**
+   * Environment variable namespace configuration.
+   * Declares the prefix(es) this project uses for its env vars so that
+   * tooling can generate `.env.example`, validate required vars, and
+   * produce accurate documentation without hard-coding prefix strings.
+   *
+   * @example
+   * { namespaces: ["HOLOCRON", "MY_CLI"] }
+   */
+  env?: EnvConfig;
+  /**
+   * Structured-logging config. Only the level belongs here — Axiom
+   * credentials come from env vars, never a committed file.
+   *
+   * @example
+   * { level: "debug" }
+   */
+  log?: LogConfig;
+  /**
+   * CLI self-telemetry override layer. Env var (`HOLOCRON_TELEMETRY=false`)
+   * still wins; this is the committed way to opt a repo out or drop usage
+   * analytics while keeping error reporting.
+   *
+   * @example
+   * { enabled: false }
+   * { analytics: "none" }
+   */
+  telemetry?: TelemetryConfig;
+}
+//#endregion
+//#region src/config/compose.d.ts
+type TaskEntry = NonNullable<HolocronConfig["tasks"]>[number];
+/** A single composable capability fragment. */
+interface Capability {
+  /** Unique identifier — used for deduplication and dependency resolution. */
+  id: string;
+  /** Other capability IDs that must be present in the same compose() call. */
+  requires?: string[];
+  /** Task entries contributed by this capability. Merged by name; last writer wins. */
+  tasks?: TaskEntry[];
+  /** Provider config. Shallow-merged at the top level; later capabilities override per-key. */
+  providers?: RawProvidersConfig;
+  /**
+   * Required status-check contexts **not** backed by a `required` task
+   * (codecov gates, `Storybook Publish`, …). Unioned across all capabilities
+   * onto the top-level `extraRequiredChecks`. Task-backed checks come from
+   * `{ required: true }` task entries via `astromech.requiredChecks()`.
+   */
+  extraRequiredChecks?: string[];
+  /** Repo config fragment. Scalar fields: last writer wins. properties/topics/teams: merged. */
+  repo?: Partial<Omit<RepoConfig, "name">>;
+  /** Org name. Last writer wins. */
+  org?: string;
+  /** Org canonical domain. Last writer wins. */
+  domain?: string;
+  /** Docs site config. Last writer wins. */
+  docs?: DocsConfig;
+}
+/** The merged result of a compose() call. Spreads into defineConfig(). */
+interface ComposedPreset {
+  tasks: TaskEntry[];
+  providers: RawProvidersConfig;
+  repo: Partial<Omit<RepoConfig, "name">>;
+  /** Non-task required-check contexts, unioned across capabilities. */
+  extraRequiredChecks: string[];
+  org?: string;
+  domain?: string;
+  docs?: DocsConfig;
+}
+/**
+ * Merge any number of capability fragments into a single preset object that
+ * spreads directly into `defineConfig()`.
+ *
+ * - Accepts individual capabilities or nested arrays (for bundle presets).
+ * - Deduplicates by `id` — when the same ID appears more than once, the last
+ *   occurrence wins. This lets callers override bundle defaults by listing an
+ *   explicit capability after the bundle.
+ * - Validates all `requires` at call time and throws `ConfigError` if any are
+ *   unmet, listing every missing dependency in a single message.
+ *
+ * @example
+ * // docs-only site — no typecheck
+ * const preset = compose(node(), docs());
+ *
+ * // library with docs
+ * const preset = compose(node(), typecheck(), docs());
+ *
+ * // nextjs() is a bundle that returns Capability[]
+ * const preset = compose(node(), nextjs());
+ */
+declare function compose(...args: (Capability | Capability[])[]): ComposedPreset;
+//#endregion
+export { ComposedPreset as n, compose as r, Capability as t };

package/dist/index.d.ts

@@ -1,9 +1,8 @@
+import { n as ComposedPreset, r as compose, t as Capability } from "./index-BZQJvxGu.js";
 import { monorepo } from "./configs/monorepo.js";
-import { n as NextjsOptions, r as nextjs$1, t as nextjs } from "./nextjs-DF6ifcAm.js";
+import { n as NextjsOptions, r as nextjs$1, t as nextjs } from "./nextjs-CorAF9jM.js";
 import { NodeDocsPreset, NodeDocsSitePreset, nodeDocs, nodeDocsSite } from "./configs/node-docs.js";
-import { HolocronPreset as ComposedPreset$1 } from "./configs/node.js";
-import { n as ReactOptions, r as react$1, t as react } from "./react-Da48S4-Q.js";
-import { Capability, Capability as Capability$1, ComposedPreset, compose } from "@theholocron/cli";
+import { n as ReactOptions, r as react$1, t as react } from "./react-C7k74R65.js";
 //#region constants.d.ts
 /** Cloudflare account ID for the theholocron org. */
 declare const CLOUDFLARE_ACCOUNT_ID = "9c558af98664d13fc89b7e0a0d93d5a8";
@@ -19,7 +18,7 @@ declare const CLOUDFLARE_ACCOUNT_ID = "9c558af98664d13fc89b7e0a0d93d5a8";
  * `lint` and `test` are marked `required` — `holocron setup` derives their
  * `… / Conclusion` branch-protection check contexts from the manifest.
  */
-declare function node(): Capability$1;
+declare function node(): Capability;
 //#endregion
 //#region capabilities/typecheck.d.ts
 /**
@@ -27,7 +26,7 @@ declare function node(): Capability$1;
  * derives the `Typecheck / Conclusion` branch-protection check from the manifest.
  * Requires: node
  */
-declare function typecheck(): Capability$1;
+declare function typecheck(): Capability;
 //#endregion
 //#region capabilities/docs.d.ts
 /**
@@ -36,7 +35,7 @@ declare function typecheck(): Capability$1;
  * `extraRequiredChecks` (enabled for all docs repos).
  * Requires: node
  */
-declare function docs(): Capability$1;
+declare function docs(): Capability;
 //#endregion
 //#region capabilities/audit.d.ts
 interface AuditOptions {
@@ -53,7 +52,7 @@ interface AuditOptions {
  * from the manifest.
  * Requires: node
  */
-declare function audit({ knip, performance, lighthouseConfig }?: AuditOptions): Capability$1;
+declare function audit({ knip, performance, lighthouseConfig }?: AuditOptions): Capability;
 //#endregion
 //#region capabilities/monorepo.d.ts
 /**
@@ -64,7 +63,7 @@ declare function audit({ knip, performance, lighthouseConfig }?: AuditOptions):
  * @example
  * const preset = compose(node(), typecheck(), nextjs(), monorepo());
  */
-declare function monorepo$1(): Capability$1;
+declare function monorepo$1(): Capability;
 //#endregion
 //#region capabilities/wiki.d.ts
 /**
@@ -78,6 +77,6 @@ declare function monorepo$1(): Capability$1;
  * const preset = compose(nodeDocs(), wiki());
  * ```
  */
-declare function wiki(): Capability$1;
+declare function wiki(): Capability;
 //#endregion
-export { type AuditOptions, CLOUDFLARE_ACCOUNT_ID, type Capability, type ComposedPreset, type ComposedPreset$1 as HolocronPreset, type NextjsOptions, type NodeDocsPreset, type NodeDocsSitePreset, type ReactOptions, audit, compose, docs, monorepo, monorepo$1 as monorepoCapability, nextjs, nextjs$1 as nextjsBundle, node, nodeDocs, nodeDocsSite, react, react$1 as reactCapability, typecheck, wiki as wikiCapability };
+export { type AuditOptions, CLOUDFLARE_ACCOUNT_ID, type Capability, type ComposedPreset, type ComposedPreset as HolocronPreset, type NextjsOptions, type NodeDocsPreset, type NodeDocsSitePreset, type ReactOptions, audit, compose, docs, monorepo, monorepo$1 as monorepoCapability, nextjs, nextjs$1 as nextjsBundle, node, nodeDocs, nodeDocsSite, react, react$1 as reactCapability, typecheck, wiki as wikiCapability };

package/dist/index.js

@@ -1,11 +1,10 @@
-import { i as CLOUDFLARE_ACCOUNT_ID, n as nodeDocsSite, r as docs, t as nodeDocs } from "./node-docs-CcZ9-AX_.js";
-import { t as node } from "./node-BLjkrd5k.js";
+import { n as compose, t as node } from "./node-C6uBnA36.js";
+import { i as CLOUDFLARE_ACCOUNT_ID, n as nodeDocsSite, r as docs, t as nodeDocs } from "./node-docs-DI6yiUlZ.js";
 import { t as typecheck } from "./typecheck-CG1ePvP6.js";
 import { t as react$1 } from "./react-4Ap2ev6C.js";
-import { n as nextjs$1, t as nextjs } from "./nextjs-Q-9hbfm1.js";
+import { n as nextjs$1, t as nextjs } from "./nextjs-DAzq_mG7.js";
 import { react } from "./configs/react.js";
 import { monorepo } from "./configs/monorepo.js";
-import { compose } from "@theholocron/cli";
 //#region capabilities/audit.ts
 /**
 * Adds BundleWatch + optional Knip and Lighthouse auditing. Marked `required` —

package/dist/{nextjs-DF6ifcAm.d.ts → nextjs-CorAF9jM.d.ts}

@@ -1,4 +1,4 @@
-import { Capability, ComposedPreset } from "@theholocron/cli";
+import { n as ComposedPreset, t as Capability } from "./index-BZQJvxGu.js";
 //#region capabilities/nextjs.d.ts
 interface NextjsOptions {
   /** Extra `with:` inputs merged into the `test` workflow entry. */

package/dist/{nextjs-Q-9hbfm1.js → nextjs-DAzq_mG7.js}

@@ -1,7 +1,6 @@
-import { t as node } from "./node-BLjkrd5k.js";
+import { n as compose, t as node } from "./node-C6uBnA36.js";
 import { t as typecheck } from "./typecheck-CG1ePvP6.js";
 import { t as react } from "./react-4Ap2ev6C.js";
-import { compose } from "@theholocron/cli";
 //#region capabilities/nextjs.ts
 /**
 * Bundle preset for Next.js application repos. Returns a Capability[] that