@theholocron/cli 3.37.2 → 3.38.0

package/dist/index.d.mts

@@ -379,6 +379,63 @@ declare function resolvePluginPackage(provider: string): string;
 declare function resolveEntry(key: CapabilityKey, raw: RawProviderEntry): ResolvedProviderEntry;
 declare function resolveConfig(raw: HolocronConfig): ResolvedHolocronConfig;
 //#endregion
+//#region src/compose.d.ts
+type WorkflowEntry = NonNullable<HolocronConfig["workflows"]>[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[];
+  /** Workflow entries contributed by this capability. Merged by name; last writer wins. */
+  workflows?: WorkflowEntry[];
+  /** Provider config. Shallow-merged at the top level; later capabilities override per-key. */
+  providers?: RawProvidersConfig;
+  /** CI check names that must pass. Unioned across all capabilities. */
+  requiredChecks?: 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 {
+  workflows: WorkflowEntry[];
+  providers: RawProvidersConfig;
+  repo: Partial<Omit<RepoConfig, "name">> & {
+    requiredChecks: 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
 //#region src/define-config.d.ts
 declare function defineConfig(config: HolocronConfig): HolocronConfig;
 //#endregion
@@ -449,4 +506,4 @@ interface LoadedConfig {
  */
 declare function loadConfig(cwd: string): Promise<LoadedConfig>;
 //#endregion
-export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvConfig, EnvLookup, Environment, EnvironmentReviewer, Environments, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, PullRequest, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoConfig, RepoProperties, RepoProtection, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, StorybookDeployProject, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, WorkflowWithConfig, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };
+export { Analytics, AppConfig, Auth, AuthDescription, AuthError, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, Capability, CapabilityConfigPackage, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, ChromaticProjectConfig, Ci, CiRun, CiRunFilter, CiRunStatus, ComposedPreset, ConfigError, ConfigFileError, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, DocsConfig, DoctorConfig, EnsureResult, EnvConfig, EnvLookup, Environment, EnvironmentReviewer, Environments, FeatureResolverConfig, HolocronConfig, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, LoadedConfig, MultiEntry, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, ProviderOptions, PullRequest, REQUIRED_CAPABILITIES, RawProviderEntry, RawProvidersConfig, RepoConfig, RepoProperties, RepoProtection, RepoRef, RepoSettings, type RequestOptions, ResolveTokenConfig, type ResolveTokenInput, ResolvedCapability, ResolvedHolocronConfig, ResolvedProviderEntry, ResolvedProvidersConfig, ResolvedTuple, type RestClient, type RestClientConfig, Ruleset, SecretScope, Secrets, SingleEntry, Source, StatusCategory, Storage, StorageBranch, StorybookDeployProject, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, WorkflowWithConfig, compose, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/dist/index.mjs

@@ -244,6 +244,96 @@ function resolveConfig(raw) {
 	};
 }
 //#endregion
+//#region src/compose.ts
+function workflowName(e) {
+	return typeof e === "string" ? e : e.name;
+}
+/**
+* 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());
+*/
+function compose(...args) {
+	const flat = args.flat();
+	const byId = /* @__PURE__ */ new Map();
+	for (const cap of flat) byId.set(cap.id, cap);
+	const caps = [...byId.values()];
+	const available = new Set(caps.map((c) => c.id));
+	const errors = [];
+	for (const cap of caps) for (const req of cap.requires ?? []) if (!available.has(req)) errors.push(`"${cap.id}" requires "${req}"`);
+	if (errors.length > 0) throw new ConfigError(`compose(): unmet dependencies — ${errors.join(", ")}`);
+	const workflowMap = /* @__PURE__ */ new Map();
+	for (const cap of caps) for (const entry of cap.workflows ?? []) workflowMap.set(workflowName(entry), entry);
+	let providers = {};
+	for (const cap of caps) if (cap.providers) providers = {
+		...providers,
+		...cap.providers
+	};
+	const checksSeen = /* @__PURE__ */ new Set();
+	const requiredChecks = [];
+	for (const cap of caps) for (const check of cap.requiredChecks ?? []) if (!checksSeen.has(check)) {
+		checksSeen.add(check);
+		requiredChecks.push(check);
+	}
+	let repo = {};
+	for (const cap of caps) {
+		if (!cap.repo) continue;
+		const { properties, topics, teams, ...scalars } = cap.repo;
+		repo = {
+			...repo,
+			...scalars
+		};
+		if (properties) repo.properties = {
+			...repo.properties,
+			...properties
+		};
+		if (topics) {
+			const merged = /* @__PURE__ */ new Set([...repo.topics ?? [], ...topics]);
+			repo.topics = [...merged];
+		}
+		if (teams) {
+			const teamMap = new Map((repo.teams ?? []).map((t) => [typeof t === "string" ? t : t.slug, t]));
+			for (const t of teams) teamMap.set(typeof t === "string" ? t : t.slug, t);
+			repo.teams = [...teamMap.values()];
+		}
+	}
+	let org;
+	let domain;
+	let docs;
+	for (const cap of caps) {
+		if (cap.org !== void 0) org = cap.org;
+		if (cap.domain !== void 0) domain = cap.domain;
+		if (cap.docs !== void 0) docs = cap.docs;
+	}
+	return {
+		workflows: [...workflowMap.values()],
+		providers,
+		repo: {
+			...repo,
+			requiredChecks
+		},
+		...org !== void 0 ? { org } : {},
+		...domain !== void 0 ? { domain } : {},
+		...docs !== void 0 ? { docs } : {}
+	};
+}
+//#endregion
 //#region src/define-config.ts
 function defineConfig(config) {
 	return config;
@@ -367,4 +457,4 @@ async function fileExists(path) {
 	}
 }
 //#endregion
-export { AuthError, CARDINALITY, ConfigError, ConfigFileError, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };
+export { AuthError, CARDINALITY, ConfigError, ConfigFileError, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, compose, createEnvLookup, createFeatureResolver, createResolveToken, createRestClient, defineConfig, deleteToken, getToken, isMulti, listStoredProviders, loadConfig, resolveConfig, resolveEntry, resolvePluginPackage, setToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "3.37.2",
+  "version": "3.38.0",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "keywords": [
     "cli",