@tallyrelease/core 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/config.d.ts

@@ -1,10 +1,13 @@
-import type { Propagate, VersionMode } from "./plugin.js";
+import type { Propagate, VersionSource } from "./plugin.js";
 /** Config overlay for the unit at a root; creates a config-only unit if none is discovered. */
 export interface UnitOverlay {
     id?: string;
     include?: string[];
     exclude?: string[];
-    version?: VersionMode;
+    /** Default `defaults.release`, else false. */
+    release?: boolean;
+    /** Overrides the plugin's source; applies only when released. */
+    version?: VersionSource;
     scheme?: string;
     tagFormat?: string;
     propagate?: Propagate;
@@ -23,6 +26,7 @@ export interface TallyConfig {
      */
     plugins: Record<string, Record<string, unknown> | null>;
     defaults?: {
+        release?: boolean;
         tagFormat?: string;
         propagate?: Propagate;
     };

package/dist/discover.js

@@ -40,11 +40,12 @@ export const discoverUnits = async (active, env) => {
             });
         }
     }
-    for (const [key, overlay] of Object.entries(env.config.units ?? {})) {
+    for (const [key, { release, ...overlay }] of Object.entries(env.config.units ?? {})) {
         const root = normalizeRoot(key);
         const entry = byRoot.get(root);
         if (entry) {
             entry.draft = { ...entry.draft, ...overlay };
+            entry.release = release;
         }
         else {
             byRoot.set(root, {
@@ -55,6 +56,7 @@ export const discoverUnits = async (active, env) => {
                     root,
                 },
                 meta: {},
+                release,
             });
         }
     }
@@ -82,7 +84,7 @@ export const discoverUnits = async (active, env) => {
     const roots = [...byRoot.keys()].sort(compare);
     const { defaults } = env.config;
     return [...byId.values()]
-        .map(({ plugin, draft, meta }) => {
+        .map(({ plugin, draft, meta, release }) => {
         const { root } = draft;
         const nested = roots
             .filter((r) => isInside(r, root))
@@ -97,7 +99,9 @@ export const discoverUnits = async (active, env) => {
                 ]),
             ]),
             exclude: Object.freeze([...nested, ...(draft.exclude ?? [])]),
-            version: draft.version ?? "tag",
+            version: (release ?? defaults?.release ?? false)
+                ? (draft.version ?? "tag")
+                : "none",
             scheme: draft.scheme ?? "semver",
             tagFormat: draft.tagFormat ??
                 defaults?.tagFormat ??

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { AffectedDoc, AffectedOptions, AffectedReason, AffectedUnit, BaseSo
 export type { DepConfig, TallyConfig, UnitOverlay } from "./config.js";
 export type { Warning } from "./errors.js";
 export type { Graph, SourcedEdge } from "./graph.js";
-export type { BumpLevel, Change, Ctx, Edge, EdgeDraft, GitReader, IntentSource, MaybePromise, Plugin, PreCtx, Propagate, RawCommit, ReadonlyFs, TagRef, Unit, UnitDraft, VersionFile, VersionMode, VersionScheme, WriteCtx, } from "./plugin.js";
+export type { BumpLevel, Change, Ctx, Edge, EdgeDraft, GitReader, IntentSource, MaybePromise, Plugin, PreCtx, Propagate, RawCommit, ReadonlyFs, TagRef, Unit, UnitDraft, VersionFile, VersionMode, VersionScheme, VersionSource, WriteCtx, } from "./plugin.js";
 export type { ActivePlugin, PluginEnv } from "./plugins.js";
 export type { Workspace, WorkspaceInput } from "./workspace.js";
 export { computeAffected } from "./affected.js";

package/dist/plugin.d.ts

@@ -69,14 +69,17 @@ export interface RawCommit {
     date: string;
 }
 export type Propagate = "auto" | "patch" | "rebuild";
-/** `file`: tags and version files; `tag`: tags only; `none`: build-only. */
-export type VersionMode = "file" | "tag" | "none";
+/** Where a released unit's version lives. `file`: tags and version files; `tag`: tags only. */
+export type VersionSource = "file" | "tag";
+/** Effective mode; `none` when the unit is not released. */
+export type VersionMode = VersionSource | "none";
 export interface UnitDraft {
     id: string;
     root: string;
     include?: string[];
     exclude?: string[];
-    version?: VersionMode;
+    /** Source if the unit is released; default `tag`. */
+    version?: VersionSource;
     scheme?: string;
     tagFormat?: string;
     propagate?: Propagate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyrelease/core",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "Pure planning core of tallyrelease",
   "repository": {
     "type": "git",