@savvy-web/silk-effects 9.5.4 → 9.6.0

package/changesets/remark/rules/required-sections.js

@@ -4,7 +4,7 @@ import { toString } from "mdast-util-to-string";
 import { lintRule } from "unified-lint-rule";
 import { visit } from "unist-util-visit";
 
-//#region src/changesets/remark/rules/required-sections.ts
+// src/changesets/remark/rules/required-sections.ts
 const RequiredSectionsRule = lintRule("remark-lint:changeset-required-sections", (tree, file) => {
 	visit(tree, "heading", (node) => {
 		if (node.depth !== 2) return;
@@ -13,5 +13,4 @@ const RequiredSectionsRule = lintRule("remark-lint:changeset-required-sections",
 	});
 });
 
-//#endregion
 export { RequiredSectionsRule };

package/changesets/remark/rules/uncategorized-content.js

@@ -1,7 +1,7 @@
 import { RULE_DOCS } from "../../constants.js";
 import { lintRule } from "unified-lint-rule";
 
-//#region src/changesets/remark/rules/uncategorized-content.ts
+// src/changesets/remark/rules/uncategorized-content.ts
 /**
 * Node types to ignore when detecting uncategorized content (e.g., HTML comments).
 *
@@ -27,5 +27,4 @@ const UncategorizedContentRule = lintRule("remark-lint:changeset-uncategorized-c
 	}
 });
 
-//#endregion
 export { UncategorizedContentRule };

package/changesets/schemas/changeset.js

@@ -1,7 +1,7 @@
 import { CommitHashSchema } from "./git.js";
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/changeset.ts
+// src/changesets/schemas/changeset.ts
 /**
 * Effect schemas for changeset entries and dependency updates.
 *
@@ -145,5 +145,4 @@ const DependencyUpdateSchema = Schema.Struct({
 	newVersion: Schema.String
 });
 
-//#endregion
 export { ChangesetSchema, ChangesetSummarySchema, DependencyTypeSchema, DependencyUpdateSchema };

package/changesets/schemas/dependency-table.js

@@ -1,7 +1,7 @@
 import { NonEmptyString } from "./primitives.js";
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/dependency-table.ts
+// src/changesets/schemas/dependency-table.ts
 /**
 * Effect schemas for structured dependency table entries.
 *
@@ -213,5 +213,4 @@ const DependencyTableRowSchema = Schema.Struct({
 */
 const DependencyTableSchema = Schema.Array(DependencyTableRowSchema).check(Schema.isMinLength(1));
 
-//#endregion
 export { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VERSION_RE, VersionOrEmptySchema };

package/changesets/schemas/deps-regen.js

@@ -2,7 +2,7 @@ import { NonEmptyString } from "./primitives.js";
 import { DependencyActionSchema, DependencyTableTypeSchema } from "./dependency-table.js";
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/deps-regen.ts
+// src/changesets/schemas/deps-regen.ts
 /**
 * Result schemas for DepsRegen: the side-effect-free regen plan and the result
 * of applying it.
@@ -74,5 +74,4 @@ const RegenResultSchema = Schema.Struct({
 	coexisting: Schema.Array(CoexistingChangesetSchema)
 }).annotate({ identifier: "RegenResult" });
 
-//#endregion
 export { CoexistingChangesetSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema };

package/changesets/schemas/git.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/git.ts
+// src/changesets/schemas/git.ts
 /**
 * Git-related Effect schemas for commit hashes and version bump types.
 *
@@ -69,5 +69,4 @@ const VersionTypeSchema = Schema.Literals([
 	"none"
 ]);
 
-//#endregion
 export { CommitHashSchema, VersionTypeSchema };

package/changesets/schemas/github.js

@@ -2,7 +2,7 @@ import { PositiveInteger } from "./primitives.js";
 import { MARKDOWN_LINK_PATTERN } from "../utils/markdown-link.js";
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/github.ts
+// src/changesets/schemas/github.ts
 /**
 * GitHub-related Effect schemas for usernames, issue numbers, and API responses.
 *
@@ -170,5 +170,4 @@ const GitHubInfoSchema = Schema.Struct({
 	})
 });
 
-//#endregion
 export { GitHubInfoSchema, IssueNumberSchema, UrlOrMarkdownLinkSchema, UsernameSchema };

package/changesets/schemas/options.js

@@ -3,7 +3,7 @@ import { LegacyVersionFilesSchema } from "./version-files.js";
 import { PackagesRecordSchema } from "./package-scope.js";
 import { Effect, Schema } from "effect";
 
-//#region src/changesets/schemas/options.ts
+// src/changesets/schemas/options.ts
 /**
 * Changeset configuration option schemas and validation.
 *
@@ -185,5 +185,4 @@ function validateChangesetOptions(input) {
 	})));
 }
 
-//#endregion
 export { ChangesetOptionsSchema, RepoSchema, validateChangesetOptions };

package/changesets/schemas/package-scope.js

@@ -1,7 +1,7 @@
 import { VersionFileConfigSchema } from "./version-files.js";
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/package-scope.ts
+// src/changesets/schemas/package-scope.ts
 /**
 * Schemas for the per-package release-surface configuration introduced in
 * \@savvy-web/changesets 0.9.0.
@@ -120,5 +120,4 @@ const PackageScopeSchema = Schema.Struct({
 */
 const PackagesRecordSchema = Schema.Record(Schema.String, PackageScopeSchema);
 
-//#endregion
 export { GlobSchema, PackageScopeSchema, PackagesRecordSchema };

package/changesets/schemas/primitives.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/primitives.ts
+// src/changesets/schemas/primitives.ts
 /**
 * Primitive reusable schemas for common constrained types.
 *
@@ -67,5 +67,4 @@ const NonEmptyString = Schema.String.check(Schema.isMinLength(1));
 */
 const PositiveInteger = Schema.Number.check(Schema.isInt(), Schema.isGreaterThan(0));
 
-//#endregion
 export { NonEmptyString, PositiveInteger };

package/changesets/schemas/release-plan.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/release-plan.ts
+// src/changesets/schemas/release-plan.ts
 /**
 * Result schemas for the {@link ReleasePlanner} service — the structured
 * preview of pending releases and the result of a native apply.
@@ -56,5 +56,4 @@ const AppliedReleaseSchema = Schema.Struct({
 	versionFileUpdates: Schema.Array(VersionFileUpdateRecordSchema)
 }).annotate({ identifier: "AppliedRelease" });
 
-//#endregion
 export { AppliedReleaseEntrySchema, AppliedReleaseSchema, BumpTypeSchema, ChangesetPreviewSchema, PendingChangesetSchema, PreviewReleaseSchema, VersionFileUpdateRecordSchema };

package/changesets/schemas/version-files.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 
-//#region src/changesets/schemas/version-files.ts
+// src/changesets/schemas/version-files.ts
 /**
 * Schemas for `versionFiles` configuration entries.
 *
@@ -146,5 +146,4 @@ const LegacyVersionFileConfigSchema = Schema.Struct({
 */
 const LegacyVersionFilesSchema = Schema.Array(LegacyVersionFileConfigSchema);
 
-//#endregion
 export { JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, VersionFileConfigSchema, VersionFilesSchema };

package/changesets/services/branch-analyzer.js

@@ -3,7 +3,7 @@ import { ClassificationReasonSchema, ConfigInspector } from "./config-inspector.
 import { Context, Effect, Layer, Option, Schema } from "effect";
 import { Git } from "@effected/git";
 
-//#region src/changesets/services/branch-analyzer.ts
+// src/changesets/services/branch-analyzer.ts
 /** Git diff status as reported by `--name-status`. @public */
 const FileStatusSchema = Schema.Literals([
 	"added",
@@ -163,5 +163,4 @@ function makeBranchAnalyzerTest(fixed) {
 	return Layer.succeed(BranchAnalyzer, { analyzeBranch: () => Effect.succeed(fixed) });
 }
 
-//#endregion
 export { BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest };

package/changesets/services/changelog.js

@@ -1,6 +1,6 @@
 import { Context } from "effect";
 
-//#region src/changesets/services/changelog.ts
+// src/changesets/services/changelog.ts
 /**
 * Effect service tag for changelog formatting.
 *
@@ -33,5 +33,4 @@ import { Context } from "effect";
 */
 var ChangelogService = class extends Context.Service()("ChangelogService") {};
 
-//#endregion
 export { ChangelogService };

package/changesets/services/config-inspector.js

@@ -9,7 +9,7 @@ import { GlobPattern, GlobPatternOptions } from "@effected/glob";
 import { compileAndExpand } from "@effected/walker";
 import { WorkspaceDiscovery } from "@effected/workspaces";
 
-//#region src/changesets/services/config-inspector.ts
+// src/changesets/services/config-inspector.ts
 /**
 * `ConfigInspector` service — surface the project's `.changeset/config.json`
 * in a structured, validated form that agents and tooling can consume.
@@ -580,5 +580,4 @@ function makeConfigInspectorTest(fixed) {
 	});
 }
 
-//#endregion
 export { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest };

package/changesets/services/deps-regen.js

@@ -13,7 +13,7 @@ import { Git } from "@effected/git";
 import { LockfileReader, PublishabilityDetector, WorkspaceCatalogs, WorkspaceDiscovery, WorkspaceSnapshots, Workspaces } from "@effected/workspaces";
 import { Yaml } from "@effected/yaml";
 
-//#region src/changesets/services/deps-regen.ts
+// src/changesets/services/deps-regen.ts
 /**
 * `Changesets.DepsRegen` service — lift the `deps regen` / `deps detect`
 * orchestration out of the CLI into a `Context.Service` with a
@@ -542,5 +542,4 @@ function makeDepsRegenDefault(options) {
 */
 const DepsRegenDefault = makeDepsRegenDefault();
 
-//#endregion
 export { DepsRegen, DepsRegenDefault, depsChangesetFilename, isPureDependencyChangeset, makeDepsRegenDefault, parseChangesetPackages };

package/changesets/services/github.js

@@ -2,7 +2,7 @@ import { GitHubApiError } from "../errors.js";
 import { getGitHubInfo } from "../vendor/github-info.js";
 import { Context, Effect, Layer } from "effect";
 
-//#region src/changesets/services/github.ts
+// src/changesets/services/github.ts
 /**
 * GitHub service for fetching commit metadata.
 *
@@ -160,5 +160,4 @@ function makeGitHubTest(responses) {
 	} });
 }
 
-//#endregion
 export { GitHubService, makeGitHubTest };

package/changesets/services/maintenance-reason.js

@@ -1,7 +1,7 @@
 import { ChangesetConfig } from "../../services/ChangesetConfig.js";
 import { Schema } from "effect";
 
-//#region src/changesets/services/maintenance-reason.ts
+// src/changesets/services/maintenance-reason.ts
 /**
 * A group co-member whose own changesets forced this release.
 *
@@ -70,5 +70,4 @@ function deriveMaintenanceReason(release, plan, config) {
 	};
 }
 
-//#endregion
 export { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason };

package/changesets/services/release-planner.js

@@ -13,7 +13,7 @@ import { readPreState } from "@changesets/pre";
 import { readChangesets } from "@changesets/read";
 import { getPackages } from "@manypkg/get-packages";
 
-//#region src/changesets/services/release-planner.ts
+// src/changesets/services/release-planner.ts
 /**
 * `ReleasePlanner` service — drive the genuine changesets release engine to
 * compute a plan, render a read-only preview, or natively apply a release.
@@ -509,5 +509,4 @@ function applyEffect(root, dryRun, changelogModules, snapshot, onStepOption, ins
 	});
 }
 
-//#endregion
 export { ReleasePlanner, extractVersionBlock, makeReleasePlannerTest, withChangelogModules };

package/changesets/utils/commit-parser.js

@@ -1,4 +1,4 @@
-//#region src/changesets/utils/commit-parser.ts
+// src/changesets/utils/commit-parser.ts
 /**
 * Matches conventional commit format: `type(scope)!: description`.
 *
@@ -58,5 +58,4 @@ function parseCommitMessage(message) {
 	return { description: message };
 }
 
-//#endregion
 export { parseCommitMessage };

package/changesets/utils/dep-diff.js

@@ -2,7 +2,7 @@ import { sortDependencyRows } from "./dependency-table.js";
 import { Option } from "effect";
 import { WorkspaceStateSnapshot } from "@effected/workspaces";
 
-//#region src/changesets/utils/dep-diff.ts
+// src/changesets/utils/dep-diff.ts
 /**
 * Compute per-workspace-package dependency-table rows from two
 * {@link WorkspaceStateSnapshot}s, resolving `catalog:` / `workspace:`
@@ -151,5 +151,4 @@ function computeWorkspaceDependencyDiffs(before, after) {
 	return result;
 }
 
-//#endregion
 export { computeWorkspaceDependencyDiffs };

package/changesets/utils/dependency-section.js

@@ -1,4 +1,4 @@
-//#region src/changesets/utils/dependency-section.ts
+// src/changesets/utils/dependency-section.ts
 /**
 * Scan a `## Dependencies` section starting at the node AFTER its heading.
 *
@@ -30,5 +30,4 @@ function scanDependencySection(nodes, startIndex, adapter) {
 	};
 }
 
-//#endregion
 export { scanDependencySection };

package/changesets/utils/dependency-table.js

@@ -3,7 +3,7 @@ import { stringifyMarkdown } from "./remark-pipeline.js";
 import { Schema } from "effect";
 import { toString } from "mdast-util-to-string";
 
-//#region src/changesets/utils/dependency-table.ts
+// src/changesets/utils/dependency-table.ts
 /**
 * Dependency table utilities for parsing, serializing, collapsing, and sorting
 * dependency table rows between MDAST table nodes and typed representations.
@@ -354,5 +354,4 @@ function sortDependencyRows(rows) {
 	});
 }
 
-//#endregion
 export { collapseDependencyRows, parseDependencyTable, serializeDependencyTable, serializeDependencyTableToMarkdown, sortDependencyRows };

package/changesets/utils/git.js

@@ -3,7 +3,7 @@ import { Effect, Option } from "effect";
 import { basename } from "node:path";
 import { Git } from "@effected/git";
 
-//#region src/changesets/utils/git.ts
+// src/changesets/utils/git.ts
 /**
 * Git helpers for the changesets deps regen/detect orchestration.
 *
@@ -105,5 +105,4 @@ function gitShowFileAtRef(cwd, ref, path) {
 	});
 }
 
-//#endregion
 export { gitListChangesetFilesAtRef, gitMergeBase, gitResolveRef, gitShowFileAtRef };

package/changesets/utils/issue-refs.js

@@ -1,6 +1,6 @@
 import { collectReferenceLists, keywordFamily } from "@effected/github-references";
 
-//#region src/changesets/utils/issue-refs.ts
+// src/changesets/utils/issue-refs.ts
 /**
 * The output category each keyword family lands in.
 *
@@ -66,5 +66,4 @@ function parseIssueReferences(commitMessage) {
 	return references;
 }
 
-//#endregion
 export { parseIssueReferences };

package/changesets/utils/jsonpath.js

@@ -1,4 +1,4 @@
-//#region src/changesets/utils/jsonpath.ts
+// src/changesets/utils/jsonpath.ts
 /**
 * Tokenize a JSONPath string into segments.
 *
@@ -148,5 +148,4 @@ function jsonPathResolve(obj, path) {
 	return walkJsonPath(obj, path).map((entry) => entry.path);
 }
 
-//#endregion
 export { jsonPathGet, jsonPathResolve, parseJsonPath };

package/changesets/utils/logger.js

@@ -1,6 +1,6 @@
 import { Context, Effect } from "effect";
 
-//#region src/changesets/utils/logger.ts
+// src/changesets/utils/logger.ts
 /**
 * Warning output for changelog generation, parameterised by a
 * {@link ChangesetLogMode} reference instead of an ambient environment read.
@@ -60,5 +60,4 @@ function logWarning(message, ...args) {
 	});
 }
 
-//#endregion
 export { ChangesetLogMode, logWarning };

package/changesets/utils/markdown-emit.js

@@ -1,7 +1,7 @@
 import { Result } from "effect";
-import { Markdown, Mdast } from "@effected/markdown";
+import { Code, Markdown, MarkdownTransform, Mdast } from "@effected/markdown";
 
-//#region src/changesets/utils/markdown-emit.ts
+// src/changesets/utils/markdown-emit.ts
 /**
 * Unwrap a `Result` from the kit's emit boundary, converting a typed failure
 * into a defect.
@@ -37,26 +37,16 @@ function unwrap(result, context) {
 * the kit's own per-node fidelity field, `fenceChar`, post-decode. It has to
 * happen post-decode: `Mdast.fromMdast` drops non-mdast fields from foreign
 * trees, so a `fenceChar` set on the plain tree would never survive the
-* boundary. Nodes are copied only where a default is applied; everything
-* else is returned by reference.
+* boundary. `MarkdownTransform.map` rebuilds only the paths to a changed
+* code node; every other subtree is returned by reference.
 *
 * @internal
 */
 function ensureFencedCode(node) {
-	let result = node;
-	const children = node.children;
-	if (children !== void 0) {
-		const mapped = children.map(ensureFencedCode);
-		if (mapped.some((child, index) => child !== children[index])) result = {
-			...node,
-			children: mapped
-		};
-	}
-	if (result.type === "code" && result.lang === void 0 && result.fenceChar === void 0) return {
-		...result,
+	return MarkdownTransform.map(node, { code: (code) => code.lang === void 0 && code.fenceChar === void 0 ? new Code({
+		...code,
 		fenceChar: "`"
-	};
-	return result;
+	}) : code });
 }
 /**
 * Serialize a plain MDAST tree to canonical markdown.
@@ -81,6 +71,39 @@ function emitMarkdown(tree) {
 	const fenced = ensureFencedCode(unwrap(Mdast.fromMdastResult(tree), "markdown emit: mdast tree failed to decode"));
 	return unwrap(Markdown.stringifyResult(fenced), "markdown emit: canonical stringify failed");
 }
+/**
+* Parse markdown text straight into `@effected/markdown`'s node classes (GFM
+* dialect, frontmatter capture off).
+*
+* @remarks
+* Synchronous for the same reason as {@link emitMarkdown}; the kit's parser
+* is total over text, so a failure here is a defect (the nesting-depth
+* hardening guard), not an operational condition.
+*
+* @param text - The markdown source
+* @returns The parsed kit root
+*
+* @internal
+*/
+function parseKitMarkdown(text) {
+	const parsed = unwrap(Markdown.parseResult(text), "markdown parse: canonical parse failed");
+	return unwrap(Mdast.fromMdastResult(Mdast.toMdast(parsed)), "markdown parse: fidelity strip failed");
+}
+/**
+* Serialize a kit root, or a single kit block node, to canonical markdown.
+*
+* @remarks
+* The kit-tree twin of {@link emitMarkdown}: the same fence normalization,
+* then `Markdown.stringifyResult`. A lone block node emits byte-identically
+* to a one-child root, trailing newline included.
+*
+* @param node - The kit root or block node to serialize
+* @returns Canonical markdown text
+*
+* @internal
+*/
+function emitKitMarkdown(node) {
+	return unwrap(Markdown.stringifyResult(ensureFencedCode(node)), "markdown emit: canonical stringify failed");
+}
 
-//#endregion
-export { emitMarkdown };
+export { emitKitMarkdown, emitMarkdown, parseKitMarkdown };

package/changesets/utils/markdown-link.js

@@ -1,4 +1,4 @@
-//#region src/changesets/utils/markdown-link.ts
+// src/changesets/utils/markdown-link.ts
 /**
 * Pattern matching markdown link format: `[text](url)`.
 *
@@ -39,5 +39,4 @@ function extractUrlFromMarkdown(linkOrUrl) {
 	return match ? match[2] : linkOrUrl;
 }
 
-//#endregion
 export { MARKDOWN_LINK_PATTERN, extractUrlFromMarkdown };

package/changesets/utils/publishability.js

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import { PublishabilityDetector } from "@effected/workspaces";
 
-//#region src/changesets/utils/publishability.ts
+// src/changesets/utils/publishability.ts
 /**
 * Compute the set of currently-publishable workspace package names.
 *
@@ -33,5 +33,4 @@ function listPublishablePackageNames(packages, _root) {
 	});
 }
 
-//#endregion
 export { listPublishablePackageNames };

package/changesets/utils/remark-pipeline.js

@@ -3,54 +3,7 @@ import remarkGfm from "remark-gfm";
 import remarkParse from "remark-parse";
 import { unified } from "unified";
 
-//#region src/changesets/utils/remark-pipeline.ts
-/**
-* Create a unified processor configured with remark-parse and remark-gfm.
-*
-* @remarks
-* Each call creates a fresh processor instance. The plugin chain is:
-* 1. `remark-parse` — markdown to MDAST
-* 2. `remark-gfm` — GitHub Flavored Markdown extensions (tables, etc.)
-*
-* The processor carries no compiler: stringification goes through
-* {@link stringifyMarkdown}, never `processor.stringify`.
-*
-* @privateRemarks
-* Return type is intentionally inferred because the unified `Processor`
-* generic signature is complex and parameterized by the plugin chain.
-*
-* @returns A configured unified processor
-*
-* @internal
-*/
-function createRemarkProcessor() {
-	return unified().use(remarkParse).use(remarkGfm);
-}
-/**
-* Parse a markdown string into an MDAST AST synchronously.
-*
-* @remarks
-* Uses {@link createRemarkProcessor} internally. The returned tree
-* includes GFM extensions (tables, strikethrough, etc.) thanks to
-* the remark-gfm plugin.
-*
-* @param content - Raw markdown string
-* @returns The parsed MDAST root node
-*
-* @example
-* ```typescript
-* import { parseMarkdown } from "../utils/remark-pipeline.js";
-*
-* const tree = parseMarkdown("## Version 1.0.0\n\nInitial release.");
-* // tree.type === "root"
-* // tree.children[0].type === "heading"
-* ```
-*
-* @internal
-*/
-function parseMarkdown(content) {
-	return createRemarkProcessor().parse(content);
-}
+// src/changesets/utils/remark-pipeline.ts
 /**
 * Stringify an MDAST AST back to markdown text synchronously.
 *
@@ -79,5 +32,4 @@ function stringifyMarkdown(tree) {
 	return emitMarkdown(tree);
 }
 
-//#endregion
-export { createRemarkProcessor, parseMarkdown, stringifyMarkdown };
+export { stringifyMarkdown };