@savvy-web/silk-effects 7.5.3 → 8.0.0

package/schemas/SavvySections.js

@@ -1,194 +0,0 @@
-import { CommentStyle, SectionId } from "@effected/templates";
-
-//#region src/schemas/SavvySections.ts
-/**
-* Build a shell-hook section identity from a Silk tool name.
-*
-* @remarks
-* **The key is uppercased here, and that is load-bearing.** The kit renders a
-* key verbatim into its markers (`# --- BEGIN <key> MANAGED SECTION ---`),
-* while the section model this replaces uppercased `toolName` on the way in. A
-* lowercase key would therefore emit `# --- BEGIN savvy-base MANAGED SECTION ---`
-* and no longer match the `SAVVY-BASE` markers already written into every
-* consumer repo's hook files — `check` would report the section absent and
-* `sync` would append a second copy beside the first. Uppercasing keeps the
-* marker bytes identical across the migration.
-*/
-const shellSection = (toolName) => SectionId.make({
-	key: toolName.toUpperCase(),
-	commentStyle: CommentStyle.hash
-});
-/**
-* Section identity for the shared package-manager preamble.
-*
-* `toolName` is `"savvy-base"`; pair with {@link savvyBasePreamble} to build the block:
-*
-* @example
-* ```ts
-* const section = SavvyBaseSection.section(savvyBasePreamble());
-* ```
-*
-* @since 0.5.0
-* @public
-*/
-const SavvyBaseSection = shellSection("savvy-base");
-/**
-* Section identity for the shared repo-hygiene block.
-*
-* `toolName` is `"savvy-hooks"`; pair with {@link savvyHooksHygiene}.
-*
-* @since 0.5.0
-* @public
-*/
-const SavvyHooksSection = shellSection("savvy-hooks");
-/**
-* Package-manager detection preamble shared across Silk Suite hook files.
-*
-* @remarks
-* Side-effect-free definitions meant to run unconditionally — no markers, no outer CI
-* guard. Defines `ROOT`, the `in_ci` predicate, `PM` (via `detect_pm`), and `pm_exec`.
-* `pm_exec` uses local/exec semantics for every package manager and `bun x` (space form),
-* which works regardless of how bun was installed (the `bunx` shim is not always on PATH).
-*
-* @returns The preamble shell, with no surrounding markers or trailing newline.
-*
-* @since 0.5.0
-* @public
-*/
-function savvyBasePreamble() {
-	return `ROOT=$(git rev-parse --show-toplevel)
-
-in_ci() { [ -n "$CI" ] || [ -n "$GITHUB_ACTIONS" ]; }
-
-detect_pm() {
-  if [ -f "$ROOT/package.json" ]; then
-    pm=$(jq -r '.packageManager // empty' "$ROOT/package.json" 2>/dev/null | cut -d'@' -f1)
-    if [ -n "$pm" ]; then echo "$pm"; return; fi
-  fi
-  if   [ -f "$ROOT/pnpm-lock.yaml" ]; then echo "pnpm"
-  elif [ -f "$ROOT/yarn.lock" ];      then echo "yarn"
-  elif [ -f "$ROOT/bun.lock" ];       then echo "bun"
-  else echo "npm"; fi
-}
-PM=$(detect_pm)
-
-pm_exec() {
-  case "$PM" in
-    pnpm) pnpm exec "$@" ;;
-    yarn) yarn exec "$@" ;;
-    bun)  bun x "$@" ;;
-    *)    npx --no -- "$@" ;;
-  esac
-}`;
-}
-/**
-* Repo-hygiene block shared across Silk Suite hook files.
-*
-* @remarks
-* Self-guarded against CI and needs no package manager: disables Git's `core.fileMode`
-* tracking and marks tracked shell scripts executable.
-*
-* @returns The hygiene shell, with no surrounding markers or trailing newline.
-*
-* @since 0.5.0
-* @public
-*/
-function savvyHooksHygiene() {
-	return `if ! { [ -n "$CI" ] || [ -n "$GITHUB_ACTIONS" ]; }; then
-  git config core.fileMode false
-  git ls-files -z '*.sh' | xargs -0 chmod +x 2>/dev/null || true
-fi`;
-}
-/**
-* Build a consumer's one-line tool section so every consumer calls the shared base
-* helpers identically.
-*
-* @remarks
-* The returned block's content is exactly `in_ci || pm_exec <command>` with `command`
-* appended verbatim — it is not parsed, quoted, or interpolated, so shell tokens like
-* `$ROOT` and `$1` survive into the generated literal.
-*
-* **Precondition:** a {@link SavvyBaseSection} block must precede this section in the same
-* hook file so `in_ci` and `pm_exec` are defined. Consumers guarantee this by passing both
-* to `ManagedSection.syncAll` in order:
-*
-* @example
-* ```ts
-* yield* sections.syncAll(".husky/commit-msg", [
-*   SavvyBaseSection.section(savvyBasePreamble()),
-*   savvyToolSection("savvy-commit", 'commitlint --config "$ROOT/lib/configs/commitlint.config.ts" --edit "$1"'),
-* ]);
-* ```
-*
-* @param toolName - Section identity; also drives the marker names (uppercased).
-* @param command - The command passed verbatim to `pm_exec`, run only outside CI.
-* @returns A shell `Section` (`commentStyle: hash`) for `toolName`.
-*
-* @since 0.5.0
-* @public
-*/
-function savvyToolSection(toolName, command) {
-	return shellSection(toolName).section(`in_ci || pm_exec ${command}`);
-}
-/**
-* Section identity for the package-manager toolchain drift check.
-*
-* `toolName` is `"savvy-toolchain"`; pair with {@link savvyToolchainCheck}.
-*
-* @since 7.3.0
-* @public
-*/
-const SavvyToolchainSection = shellSection("savvy-toolchain");
-/**
-* Package-manager drift check shared across Silk Suite hook files.
-*
-* @remarks
-* Compares the running package manager's version against the repo's
-* `devEngines.packageManager` pin and prints a warning on mismatch. **Warn only** —
-* it never blocks the hook and never installs anything, so nobody mid-bisect or
-* mid-rebase on an older pin is stranded.
-*
-* Deliberately self-contained: its homes are `.husky/post-checkout` and
-* `.husky/post-merge`, which carry {@link SavvyHooksSection} but no
-* {@link SavvyBaseSection}, so it defines its own root/CI/pin lookups rather than
-* depending on `ROOT`, `in_ci` or `PM`. It honours the `name` recorded in the pin
-* rather than assuming pnpm.
-*
-* Every input is treated as optional: no `git` root, no `jq`, no `devEngines` block,
-* or a package manager that is not on `PATH` all mean "say nothing". Only an exact
-* pin is comparable, so ranges (`^1.2.3`, `>=1 || <2`) and wildcards (`1.x`) are
-* skipped, and the `+sha512…` integrity tail `devEngines` versions routinely carry is
-* stripped before comparison. Skipped under CI, where the runtime action installs the
-* pin by construction.
-*
-* @returns The drift-check shell, with no surrounding markers or trailing newline.
-*
-* @since 7.3.0
-* @public
-*/
-function savvyToolchainCheck() {
-	return `if ! { [ -n "$CI" ] || [ -n "$GITHUB_ACTIONS" ]; }; then
-  toolchain_root=$(git rev-parse --show-toplevel 2>/dev/null)
-  toolchain_pm=""
-  toolchain_pin=""
-  if [ -n "$toolchain_root" ] && [ -f "$toolchain_root/package.json" ] && command -v jq >/dev/null 2>&1; then
-    toolchain_pm=$(jq -r '.devEngines.packageManager.name // empty' "$toolchain_root/package.json" 2>/dev/null)
-    toolchain_pin=$(jq -r '.devEngines.packageManager.version // empty' "$toolchain_root/package.json" 2>/dev/null | cut -d'+' -f1)
-  fi
-  # Only an exact pin is comparable: drop ranges (^ ~ >= ||) and wildcards (x, *).
-  case "$toolchain_pin" in ""|[!0-9]*|*[!0-9A-Za-z.-]*|*x*|*X*) toolchain_pin="" ;; esac
-  if [ -n "$toolchain_pm" ] && [ -n "$toolchain_pin" ] && command -v "$toolchain_pm" >/dev/null 2>&1; then
-    toolchain_have=$("$toolchain_pm" --version 2>/dev/null | head -n 1 | tr -d '[:space:]')
-    # A manager that failed or answered with prose says nothing about drift.
-    case "$toolchain_have" in [!0-9]*|*[!0-9A-Za-z.-]*) toolchain_have="" ;; esac
-    if [ -n "$toolchain_have" ] && [ "$toolchain_have" != "$toolchain_pin" ]; then
-      printf '⚠ %s %s does not match %s, the version pinned in devEngines.packageManager.\\n' "$toolchain_pm" "$toolchain_have" "$toolchain_pin" >&2
-      printf '  Lockfiles written by this version may differ from CI. Fix: corepack use %s@%s\\n' "$toolchain_pm" "$toolchain_pin" >&2
-    fi
-  fi
-  unset toolchain_root toolchain_pm toolchain_pin toolchain_have
-fi`;
-}
-
-//#endregion
-export { SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyToolSection, savvyToolchainCheck };

package/schemas/VersioningSchemas.js

@@ -1,87 +0,0 @@
-import { Effect, Schema } from "effect";
-
-//#region src/schemas/VersioningSchemas.ts
-/**
-* Configuration for how private packages are handled during versioning.
-*
-* @remarks
-* When set to `false`, private packages are completely ignored.
-* When set to an object, `tag` and `version` control whether private packages
-* receive git tags and version bumps respectively.
-*
-* @since 0.2.0
-*/
-const PrivatePackagesConfig = Schema.Union([Schema.Struct({
-	tag: Schema.optional(Schema.Boolean),
-	version: Schema.optional(Schema.Boolean)
-}), Schema.Literal(false)]);
-/**
-* Snapshot release configuration for changesets.
-*
-* @remarks
-* Controls how snapshot versions are generated.
-* `useCalculatedVersion` prepends the calculated version to the snapshot tag.
-* `prereleaseTemplate` is a custom template string for snapshot version format.
-*
-* @since 0.2.0
-*/
-const SnapshotConfig = Schema.Struct({
-	useCalculatedVersion: Schema.optional(Schema.Boolean),
-	prereleaseTemplate: Schema.optional(Schema.String)
-});
-/**
-* Standard changesets configuration matching the `@changesets/config@4.0.0` spec.
-*
-* @remarks
-* Represents the parsed `.changeset/config.json` file. All fields are optional
-* to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
-* adapter is detected.
-*
-* @since 0.1.0
-*/
-/** @public */
-const ChangesetConfigFile = Schema.Struct({
-	changelog: Schema.optional(Schema.Union([
-		Schema.String,
-		Schema.Array(Schema.Unknown),
-		Schema.Literal(false)
-	])),
-	commit: Schema.optional(Schema.Union([
-		Schema.Boolean,
-		Schema.String,
-		Schema.Array(Schema.Unknown)
-	])),
-	fixed: Schema.optional(Schema.Array(Schema.Array(Schema.String))),
-	linked: Schema.optional(Schema.Array(Schema.Array(Schema.String))),
-	access: Schema.optional(Schema.Literals(["public", "restricted"])),
-	baseBranch: Schema.optional(Schema.String),
-	updateInternalDependencies: Schema.optional(Schema.Literals([
-		"patch",
-		"minor",
-		"major"
-	])),
-	ignore: Schema.optional(Schema.Array(Schema.String)),
-	privatePackages: Schema.optional(PrivatePackagesConfig),
-	prettier: Schema.optional(Schema.Boolean),
-	changedFilePatterns: Schema.optional(Schema.Array(Schema.String)),
-	bumpVersionsWithWorkspaceProtocolOnly: Schema.optional(Schema.Boolean),
-	snapshot: Schema.optional(SnapshotConfig)
-});
-/**
-* Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
-*
-* @remarks
-* Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
-* set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
-* references `@savvy-web/changesets`.
-*
-* @since 0.1.0
-*/
-/** @public */
-const SilkChangesetConfigFile = Schema.Struct({
-	...ChangesetConfigFile.fields,
-	_isSilk: Schema.Boolean.pipe(Schema.withDecodingDefaultType(Effect.succeed(true)), Schema.withConstructorDefault(Effect.succeed(true)))
-});
-
-//#endregion
-export { ChangesetConfigFile, SilkChangesetConfigFile };

package/schemas/WorkspaceAnalysisSchemas.js

@@ -1,209 +0,0 @@
-import { ChangesetConfigFile, SilkChangesetConfigFile } from "./VersioningSchemas.js";
-import { trimTrailingSlashes } from "../utils/TrailingSlash.js";
-import { Effect, Equal, Function, Hash, Option, Schema } from "effect";
-import { PublishConfig, PublishTarget, TagStyle, VersioningStrategy } from "@effected/workspaces";
-
-//#region src/schemas/WorkspaceAnalysisSchemas.ts
-const PublishProtocol = Schema.Literals(["npm", "jsr"]);
-const PublishTargetShorthand = Schema.Literals([
-	"npm",
-	"github",
-	"jsr"
-]);
-const PublishTargetObject = Schema.Struct({
-	protocol: PublishProtocol.pipe(Schema.withDecodingDefaultType(Effect.succeed("npm")), Schema.withConstructorDefault(Effect.succeed("npm"))),
-	registry: Schema.optional(Schema.String),
-	directory: Schema.optional(Schema.String),
-	access: Schema.optional(Schema.Literals(["public", "restricted"])),
-	provenance: Schema.optional(Schema.Boolean),
-	tag: Schema.optional(Schema.String)
-});
-/**
-* Silk-extended publishConfig schema.
-*
-* @remarks
-* Extends the base PublishConfig from `@effected/workspaces` (which covers the
-* npm standard fields — access, registry, directory, tag — and, as of kit
-* round 3, `linkDirectory`) with the Silk `targets` extension for
-* multi-registry publishing.
-*
-* @since 0.2.0
-* @public
-*/
-var SilkPublishConfig = class extends PublishConfig.extend("SilkPublishConfig")({ targets: Schema.optional(Schema.Array(Schema.Union([PublishTargetShorthand, PublishTargetObject]))) }) {};
-const KNOWN_REGISTRIES = {
-	npm: "https://registry.npmjs.org/",
-	github: "https://npm.pkg.github.com/",
-	jsr: "https://jsr.io/"
-};
-/**
-* Compare registry URLs ignoring a trailing slash. `SilkPublishability` resolves
-* targets from the bundler's `dist/prod/targets.json` binding, which writes
-* registry endpoints WITHOUT a trailing slash (`https://registry.npmjs.org`),
-* while `KNOWN_REGISTRIES` / `NPM_DEFAULT` use the trailing-slash form. Normalize
-* both sides so `hasTarget`/`targetFor` match regardless of which form a target
-* carries (binding-driven, placeholder, or access-branch fallback).
-*/
-const sameRegistry = (a, b) => trimTrailingSlashes(a) === trimTrailingSlashes(b);
-/**
-* The package's declared version. `current` is absent for a member whose manifest carries no
-* `version` — legal for a private package and the ordinary shape for a private monorepo root,
-* which `@effected/workspaces` discovers as a member rather than rejecting (its `missingVersion`
-* failure kind was retired in 0.19.0). Such a package has no version to bump, tag or stamp.
-*/
-const WorkspaceVersion = Schema.Struct({ current: Schema.optional(Schema.String) });
-/**
-* A fully analyzed workspace with publish targets, versioning status,
-* and release group membership.
-*
-* @since 0.2.0
-* @public
-*/
-var AnalyzedWorkspace = class AnalyzedWorkspace extends Schema.TaggedClass()("AnalyzedWorkspace", {
-	name: Schema.String,
-	version: WorkspaceVersion,
-	path: Schema.String,
-	root: Schema.Boolean,
-	publishConfig: Schema.NullOr(SilkPublishConfig),
-	publishable: Schema.Boolean,
-	targets: Schema.Array(PublishTarget),
-	versioned: Schema.Boolean,
-	tagged: Schema.Boolean,
-	released: Schema.Boolean,
-	linked: Schema.Array(Schema.suspend(() => AnalyzedWorkspace)),
-	fixed: Schema.Array(Schema.suspend(() => AnalyzedWorkspace))
-}) {
-	get isRoot() {
-		return this.root;
-	}
-	get isPublishable() {
-		return this.publishable;
-	}
-	get isReleasable() {
-		return this.released;
-	}
-	get isFixed() {
-		return this.fixed.length > 0;
-	}
-	get isLinked() {
-		return this.linked.length > 0;
-	}
-	publishesTo(registry) {
-		return this.targets.some((t) => sameRegistry(t.registry, registry));
-	}
-	hasTarget(shorthand) {
-		const registry = KNOWN_REGISTRIES[shorthand];
-		return registry !== void 0 && this.publishesTo(registry);
-	}
-	targetFor(registry) {
-		const found = this.targets.find((t) => sameRegistry(t.registry, registry));
-		return found ? Option.some(found) : Option.none();
-	}
-	[Equal.symbol](that) {
-		if (!(that instanceof AnalyzedWorkspace)) return false;
-		return this.name === that.name && this.path === that.path;
-	}
-	[Hash.symbol]() {
-		return Hash.optimize(Hash.combine(Hash.hash(this.name), Hash.hash(this.path)));
-	}
-	toString() {
-		return this.version.current === void 0 ? this.name : `${this.name}@${this.version.current}`;
-	}
-	toJSON() {
-		return {
-			_tag: "AnalyzedWorkspace",
-			name: this.name,
-			version: this.version,
-			path: this.path,
-			root: this.root,
-			publishable: this.publishable,
-			targets: this.targets,
-			versioned: this.versioned,
-			tagged: this.tagged,
-			released: this.released
-		};
-	}
-	static publishable(workspaces) {
-		return workspaces.filter((w) => w.publishable);
-	}
-	static releasable(workspaces) {
-		return workspaces.filter((w) => w.released);
-	}
-	static findByName;
-	/** Pretty-print an AnalyzedWorkspace instance. */
-	static pretty;
-};
-AnalyzedWorkspace.findByName = Function.dual(2, (workspaces, name) => {
-	const found = workspaces.find((w) => w.name === name);
-	return found ? Option.some(found) : Option.none();
-});
-AnalyzedWorkspace.pretty = Schema.toFormatter(AnalyzedWorkspace);
-const PackageManagerInfo = Schema.Struct({
-	type: Schema.Literals([
-		"npm",
-		"pnpm",
-		"yarn",
-		"bun"
-	]),
-	version: Schema.optional(Schema.String)
-});
-/**
-* Full workspace analysis result containing all analyzed workspaces
-* and project-level configuration.
-*
-* @since 0.2.0
-* @public
-*/
-var WorkspaceAnalysis = class WorkspaceAnalysis extends Schema.TaggedClass()("WorkspaceAnalysis", {
-	root: Schema.String,
-	runtime: Schema.Literals(["node", "bun"]),
-	packageManager: PackageManagerInfo,
-	workspaces: Schema.Array(AnalyzedWorkspace),
-	changesetConfig: Schema.NullOr(Schema.Union([SilkChangesetConfigFile, ChangesetConfigFile])),
-	versioning: Schema.NullOr(VersioningStrategy),
-	tagStrategy: Schema.NullOr(TagStyle)
-}) {
-	findWorkspace(name) {
-		const found = this.workspaces.find((w) => w.name === name);
-		return found ? Option.some(found) : Option.none();
-	}
-	get rootWorkspace() {
-		const root = this.workspaces.find((w) => w.root);
-		return root ? Option.some(root) : Option.none();
-	}
-	get publishableWorkspaces() {
-		return this.workspaces.filter((w) => w.publishable);
-	}
-	get versionedWorkspaces() {
-		return this.workspaces.filter((w) => w.versioned);
-	}
-	get taggedWorkspaces() {
-		return this.workspaces.filter((w) => w.tagged);
-	}
-	get releasableWorkspaces() {
-		return this.workspaces.filter((w) => w.released);
-	}
-	get isSilk() {
-		if (this.changesetConfig == null) return false;
-		return "_isSilk" in this.changesetConfig && this.changesetConfig._isSilk === true;
-	}
-	get hasChangesets() {
-		return this.changesetConfig != null;
-	}
-	[Equal.symbol](that) {
-		if (!(that instanceof WorkspaceAnalysis)) return false;
-		return this.root === that.root;
-	}
-	[Hash.symbol]() {
-		return Hash.optimize(Hash.hash(this.root));
-	}
-	toString() {
-		return `WorkspaceAnalysis(${this.root}, ${this.workspaces.length} workspaces)`;
-	}
-	/** Pretty-print a WorkspaceAnalysis instance. */
-	static pretty;
-};
-WorkspaceAnalysis.pretty = Schema.toFormatter(WorkspaceAnalysis);
-
-//#endregion
-export { AnalyzedWorkspace, SilkPublishConfig, WorkspaceAnalysis };

package/utils/TrailingSlash.js

@@ -1,18 +0,0 @@
-//#region src/utils/TrailingSlash.ts
-/**
-* Trim trailing slashes from a string.
-*
-* @remarks
-* Trims trailing slashes with an index scan rather than `/\/+$/`. That regex is
-* unanchored at the start, so the engine retries the match from every position
-* and degrades to O(n²) on a string of many slashes (CodeQL `js/polynomial-redos`).
-* Only a trailing run of slashes is removed; interior slash runs are untouched.
-*/
-const trimTrailingSlashes = (s) => {
-	let end = s.length;
-	while (end > 0 && s[end - 1] === "/") end -= 1;
-	return s.slice(0, end);
-};
-
-//#endregion
-export { trimTrailingSlashes };