@savvy-web/silk 2.0.0 → 2.1.0

package/packages/silk-effects/dist/dev/pkg/changesets/utils/dependency-table.js

@@ -1,347 +0,0 @@
-import { toString } from "../../../../../../../node_modules/.pnpm/mdast-util-to-string@4.0.0/node_modules/mdast-util-to-string/lib/index.js";
-import remarkGfm from "../../../../../../../node_modules/.pnpm/remark-gfm@4.0.1/node_modules/remark-gfm/lib/index.js";
-import remarkStringify from "../../../../../../../node_modules/.pnpm/remark-stringify@11.0.0/node_modules/remark-stringify/lib/index.js";
-import { unified } from "../../../../../../../node_modules/.pnpm/unified@11.0.5/node_modules/unified/lib/index.js";
-import { DependencyTableRowSchema } from "../schemas/dependency-table.js";
-import { Schema } from "effect";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/utils/dependency-table.js
-/**
-* Dependency table utilities for parsing, serializing, collapsing, and sorting
-* dependency table rows between MDAST table nodes and typed representations.
-*
-* @remarks
-* This module provides the low-level functional primitives that the
-* {@link DependencyTable} class wraps with a stateful, fluent API.
-* It operates on arrays of `DependencyTableRow` objects and MDAST `Table`
-* nodes, converting between the two representations.
-*
-* The collapse algorithm merges rows sharing the same `dependency + type`
-* key, applying semantic rules (e.g., added then removed = net zero).
-* Sorting follows a stable order: removed, updated, added, then
-* alphabetically by type and dependency name.
-*
-* @see {@link DependencyTable} for the public class-based API
-*
-* @internal
-*/
-/**
-* Ordered column headers for dependency tables.
-*
-* Defines the canonical header row: `Dependency | Type | Action | From | To`.
-*
-* @internal
-*/
-const COLUMN_HEADERS = [
-	"Dependency",
-	"Type",
-	"Action",
-	"From",
-	"To"
-];
-/**
-* Property keys on {@link DependencyTableRow} corresponding to each column
-* in {@link COLUMN_HEADERS}.
-*
-* Used to map between positional table cells and typed object fields.
-*
-* @internal
-*/
-const COLUMN_KEYS = [
-	"dependency",
-	"type",
-	"action",
-	"from",
-	"to"
-];
-/** Schema decoder for validating raw cell values into a typed row. */
-const decode = Schema.decodeUnknownSync(DependencyTableRowSchema);
-/**
-* Parse an MDAST table node into validated dependency table rows.
-*
-* @remarks
-* Validates the header row against {@link COLUMN_HEADERS} (case-insensitive),
-* then decodes each data row through the `DependencyTableRowSchema` for
-* type-safe validation of action values, version strings, and dependency types.
-*
-* @param table - An MDAST `Table` node (from remark-gfm)
-* @returns Array of validated `DependencyTableRow` objects
-* @throws If the table has fewer than 2 rows (header + at least one data row)
-* @throws If the header columns do not match the expected column names
-* @throws If any data row fails schema validation
-*
-* @example
-* ```typescript
-* import { parseDependencyTable } from "../utils/dependency-table.js";
-* import { parseMarkdown } from "../utils/remark-pipeline.js";
-* import type { Table } from "mdast";
-*
-* const tree = parseMarkdown("| Dependency | Type | Action | From | To |\n| --- | --- | --- | --- | --- |\n| foo | dependency | added | — | 1.0.0 |");
-* const table = tree.children.find((n) => n.type === "table") as Table;
-* const rows = parseDependencyTable(table);
-* // rows[0].dependency === "foo"
-* ```
-*
-* @internal
-*/
-function parseDependencyTable(table) {
-	const rows = table.children;
-	if (rows.length < 2) throw new Error("Dependency table must have at least one data row");
-	const headers = rows[0].children.map((cell) => toString(cell).trim().toLowerCase());
-	const expected = COLUMN_HEADERS.map((h) => h.toLowerCase());
-	if (headers.length !== expected.length || !headers.every((h, i) => h === expected[i])) throw new Error(`Table must have columns: ${COLUMN_HEADERS.join(", ")}. Got: ${headers.join(", ")}`);
-	const result = [];
-	for (let i = 1; i < rows.length; i++) {
-		const cells = rows[i].children;
-		const raw = {};
-		for (let c = 0; c < COLUMN_KEYS.length; c++) raw[COLUMN_KEYS[c]] = toString(cells[c]).trim();
-		result.push(decode(raw));
-	}
-	return result;
-}
-/**
-* Create a table cell with a text node.
-*
-* @param text - The cell text content
-* @returns An MDAST `TableCell` node
-*
-* @internal
-*/
-function makeCell(text) {
-	return {
-		type: "tableCell",
-		children: [{
-			type: "text",
-			value: text
-		}]
-	};
-}
-/**
-* Create a table row from an array of cell texts.
-*
-* @param texts - Array of cell text values
-* @returns An MDAST `TableRow` node
-*
-* @internal
-*/
-function makeRow(texts) {
-	return {
-		type: "tableRow",
-		children: texts.map(makeCell)
-	};
-}
-/**
-* Serialize dependency table rows into an MDAST `Table` node.
-*
-* @remarks
-* Creates a well-formed GFM table with the canonical header row
-* ({@link COLUMN_HEADERS}) followed by one data row per entry.
-* The inverse of {@link parseDependencyTable}.
-*
-* @param rows - Array of `DependencyTableRow` objects
-* @returns An MDAST `Table` node ready for insertion into an AST
-*
-* @example
-* ```typescript
-* import { serializeDependencyTable } from "../utils/dependency-table.js";
-* import type { DependencyTableRow } from "../schemas/dependency-table.js";
-*
-* const rows: DependencyTableRow[] = [
-*   { dependency: "effect", type: "dependency", action: "updated", from: "3.18.0", to: "3.19.0" },
-* ];
-* const table = serializeDependencyTable(rows);
-* // table.type === "table"
-* // table.children.length === 2 (header + 1 data row)
-* ```
-*
-* @internal
-*/
-function serializeDependencyTable(rows) {
-	return {
-		type: "table",
-		children: [makeRow([...COLUMN_HEADERS]), ...rows.map((row) => makeRow(COLUMN_KEYS.map((key) => row[key])))]
-	};
-}
-/**
-* Serialize dependency table rows to a markdown table string.
-*
-* @remarks
-* Combines {@link serializeDependencyTable} with unified/remark-gfm/remark-stringify
-* to produce a ready-to-use GFM markdown table string. The result is trimmed
-* of leading/trailing whitespace.
-*
-* @param rows - Array of `DependencyTableRow` objects
-* @returns Markdown table string (GFM format)
-*
-* @example
-* ```typescript
-* import { serializeDependencyTableToMarkdown } from "../utils/dependency-table.js";
-* import type { DependencyTableRow } from "../schemas/dependency-table.js";
-*
-* const rows: DependencyTableRow[] = [
-*   { dependency: "effect", type: "dependency", action: "updated", from: "3.18.0", to: "3.19.0" },
-* ];
-* const md = serializeDependencyTableToMarkdown(rows);
-* // "| Dependency | Type | Action | From | To |\n| --- | --- | ..."
-* ```
-*
-* @internal
-*/
-function serializeDependencyTableToMarkdown(rows) {
-	const tree = {
-		type: "root",
-		children: [serializeDependencyTable(rows)]
-	};
-	return unified().use(remarkGfm).use(remarkStringify).stringify(tree).trim();
-}
-/**
-* Sort priority for dependency actions: removed first, then updated, then added.
-*
-* @remarks
-* Used by {@link sortDependencyRows} for primary sort ordering. The numeric
-* values define the sort position (lower = earlier in the sorted output).
-*
-* @internal
-*/
-const ACTION_ORDER = {
-	removed: 0,
-	updated: 1,
-	added: 2
-};
-/**
-* Collapse dependency table rows with the same `dependency + type` key.
-*
-* @remarks
-* When multiple changelog entries affect the same dependency, this function
-* merges them into a single row using semantic collapse rules. Rows are
-* grouped by a composite key of `dependency\0type` (null-byte separated).
-*
-* The collapse rules applied by {@link collapseTwo} are:
-*
-* | First action | Second action | Result |
-* |---|---|---|
-* | `updated` | `updated` | `updated` (earliest `from`, latest `to`) |
-* | `added` | `updated` | `added` (final `to`) |
-* | `added` | `removed` | dropped (net zero change) |
-* | `updated` | `removed` | `removed` (original `from`) |
-* | `removed` | `added` | `updated` (original `from`, new `to`) |
-* | other | other | keep later entry |
-*
-* @param rows - Array of `DependencyTableRow` objects (in chronological order)
-* @returns Collapsed array with at most one row per `dependency + type` pair
-*
-* @example
-* ```typescript
-* import { collapseDependencyRows } from "../utils/dependency-table.js";
-* import type { DependencyTableRow } from "../schemas/dependency-table.js";
-*
-* const rows: DependencyTableRow[] = [
-*   { dependency: "effect", type: "dependency", action: "updated", from: "3.17.0", to: "3.18.0" },
-*   { dependency: "effect", type: "dependency", action: "updated", from: "3.18.0", to: "3.19.0" },
-* ];
-* const collapsed = collapseDependencyRows(rows);
-* // collapsed[0].from === "3.17.0", collapsed[0].to === "3.19.0"
-* ```
-*
-* @see {@link DependencyTable} for the public API that wraps this function
-*
-* @internal
-*/
-function collapseDependencyRows(rows) {
-	const groups = /* @__PURE__ */ new Map();
-	for (const row of rows) {
-		const key = `${row.dependency}\0${row.type}`;
-		const existing = groups.get(key);
-		if (!existing) {
-			groups.set(key, { ...row });
-			continue;
-		}
-		const merged = collapseTwo(existing, row);
-		if (merged === null) groups.delete(key);
-		else groups.set(key, merged);
-	}
-	return [...groups.values()];
-}
-/**
-* Collapse two rows sharing the same `dependency + type` key into one,
-* or return `null` if they cancel out (net zero).
-*
-* @remarks
-* This is the core merge function called by {@link collapseDependencyRows}.
-* It applies the semantic collapse rules based on the action pair.
-* See {@link collapseDependencyRows} for the full rule table.
-*
-* @param first - The earlier (existing) row
-* @param second - The later (incoming) row
-* @returns The merged row, or `null` to drop the entry entirely
-*
-* @internal
-*/
-function collapseTwo(first, second) {
-	const a = first.action;
-	const b = second.action;
-	if (a === "updated" && b === "updated") return {
-		...first,
-		to: second.to
-	};
-	if (a === "added" && b === "updated") return {
-		...first,
-		to: second.to
-	};
-	if (a === "added" && b === "removed") return null;
-	if (a === "updated" && b === "removed") return {
-		...first,
-		action: "removed",
-		to: "—"
-	};
-	if (a === "removed" && b === "added") return {
-		...first,
-		action: "updated",
-		to: second.to
-	};
-	return { ...second };
-}
-/**
-* Sort dependency table rows into canonical display order.
-*
-* @remarks
-* Applies a three-level stable sort:
-* 1. **Action** — `removed` first, then `updated`, then `added`
-*    (per {@link ACTION_ORDER})
-* 2. **Type** — alphabetically (e.g., `config` before `dependency`)
-* 3. **Dependency name** — alphabetically within each action+type group
-*
-* Returns a new array; the input is not mutated.
-*
-* @param rows - Array of `DependencyTableRow` objects
-* @returns New sorted array
-*
-* @example
-* ```typescript
-* import { sortDependencyRows } from "../utils/dependency-table.js";
-* import type { DependencyTableRow } from "../schemas/dependency-table.js";
-*
-* const rows: DependencyTableRow[] = [
-*   { dependency: "zod", type: "dependency", action: "added", from: "\u2014", to: "3.0.0" },
-*   { dependency: "effect", type: "dependency", action: "removed", from: "3.19.0", to: "\u2014" },
-* ];
-* const sorted = sortDependencyRows(rows);
-* // sorted[0].dependency === "effect" (removed comes first)
-* ```
-*
-* @see {@link DependencyTable} for the public API that wraps this function
-*
-* @internal
-*/
-function sortDependencyRows(rows) {
-	return [...rows].sort((a, b) => {
-		const actionDiff = (ACTION_ORDER[a.action] ?? 99) - (ACTION_ORDER[b.action] ?? 99);
-		if (actionDiff !== 0) return actionDiff;
-		const typeDiff = a.type.localeCompare(b.type);
-		if (typeDiff !== 0) return typeDiff;
-		return a.dependency.localeCompare(b.dependency);
-	});
-}
-
-//#endregion
-export { collapseDependencyRows, parseDependencyTable, serializeDependencyTable, serializeDependencyTableToMarkdown, sortDependencyRows };

package/packages/silk-effects/dist/dev/pkg/changesets/utils/git.cjs

@@ -1,51 +0,0 @@
-const require_errors = require('../errors.cjs');
-let effect = require("effect");
-let node_child_process = require("node:child_process");
-
-//#region ../silk-effects/dist/dev/pkg/changesets/utils/git.js
-/**
-* Git helpers for the changesets deps regen/detect orchestration.
-*
-* @remarks
-* `PointInTimeWorkspace` (from `workspaces-effect`) reads both sides of a
-* dependency diff over `CommandExecutor`. The one git operation it does not
-* cover is resolving the default `--from` ref — the merge-base with the base
-* branch — which stays here as a synchronous `execFileSync` shell-out.
-*
-* @internal
-*/
-/**
-* Run `git merge-base <base> HEAD`, returning the SHA. Errors propagate
-* as {@link GitError}.
-*
-* @internal
-*/
-function gitMergeBase(cwd, base) {
-	return effect.Effect.try({
-		try: () => (0, node_child_process.execFileSync)("git", [
-			"merge-base",
-			base,
-			"HEAD"
-		], {
-			cwd,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		}).trim(),
-		catch: (error) => {
-			const stderr = error.stderr;
-			const text = typeof stderr === "string" ? stderr : stderr?.toString() ?? "";
-			return new require_errors.GitError({
-				command: `git merge-base ${base} HEAD`,
-				cwd,
-				reason: text.trim() || (error.message ?? String(error))
-			});
-		}
-	});
-}
-
-//#endregion
-exports.gitMergeBase = gitMergeBase;

package/packages/silk-effects/dist/dev/pkg/changesets/utils/git.js

@@ -1,51 +0,0 @@
-import { GitError } from "../errors.js";
-import { Effect } from "effect";
-import { execFileSync } from "node:child_process";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/utils/git.js
-/**
-* Git helpers for the changesets deps regen/detect orchestration.
-*
-* @remarks
-* `PointInTimeWorkspace` (from `workspaces-effect`) reads both sides of a
-* dependency diff over `CommandExecutor`. The one git operation it does not
-* cover is resolving the default `--from` ref — the merge-base with the base
-* branch — which stays here as a synchronous `execFileSync` shell-out.
-*
-* @internal
-*/
-/**
-* Run `git merge-base <base> HEAD`, returning the SHA. Errors propagate
-* as {@link GitError}.
-*
-* @internal
-*/
-function gitMergeBase(cwd, base) {
-	return Effect.try({
-		try: () => execFileSync("git", [
-			"merge-base",
-			base,
-			"HEAD"
-		], {
-			cwd,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		}).trim(),
-		catch: (error) => {
-			const stderr = error.stderr;
-			const text = typeof stderr === "string" ? stderr : stderr?.toString() ?? "";
-			return new GitError({
-				command: `git merge-base ${base} HEAD`,
-				cwd,
-				reason: text.trim() || (error.message ?? String(error))
-			});
-		}
-	});
-}
-
-//#endregion
-export { gitMergeBase };

package/packages/silk-effects/dist/dev/pkg/changesets/utils/issue-refs.cjs

@@ -1,102 +0,0 @@
-
-//#region ../silk-effects/dist/dev/pkg/changesets/utils/issue-refs.js
-/**
-* GitHub issue reference parsing from commit messages.
-*
-* @remarks
-* Extracts categorized issue references (`Closes`, `Fixes`, `Refs`) from
-* commit message bodies. Supports multiple formats including with/without
-* colons, singular/plural keywords, and comma-separated issue lists.
-* Input is truncated to 10,000 characters to prevent ReDoS on adversarial input.
-*
-* @see {@link Changelog} for the public API that consumes issue references
-*
-* @internal
-*/
-/**
-* Matches "closes #123" or "close: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const CLOSES_ISSUE_PATTERN = /closes?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Matches "fixes #123" or "fix: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const FIXES_ISSUE_PATTERN = /fix(?:es)?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Matches "refs #123" or "ref: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const REFS_ISSUE_PATTERN = /refs?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Pattern for splitting comma-separated issue numbers.
-*
-* @internal
-*/
-const ISSUE_NUMBER_SPLIT_PATTERN = /, */;
-/**
-* Extract issue numbers from a regex match against a commit message.
-*
-* @remarks
-* Truncates the input to 10,000 characters before matching to prevent
-* ReDoS on adversarial input. Strips `#` prefixes from matched numbers.
-*
-* @param pattern - The regex pattern to match (must have a capture group for issue numbers)
-* @param message - The commit message body to search
-* @returns Array of issue number strings (without `#` prefix)
-*
-* @internal
-*/
-function extractIssueNumbers(pattern, message) {
-	const safeMessage = message.slice(0, 1e4);
-	const match = pattern.exec(safeMessage);
-	if (!match?.[1]) return [];
-	return match[1].split(ISSUE_NUMBER_SPLIT_PATTERN).map((num) => num.replace("#", "").trim());
-}
-/**
-* Parse a commit message for GitHub issue references.
-*
-* Recognizes `Closes`, `Fixes`, and `Refs` keywords with various formats:
-* - `Closes #123`
-* - `Fixes: #456, #789`
-* - `Refs #101`
-*
-* @remarks
-* Each keyword category is matched independently, so a single commit
-* message can contain references in all three categories. Keywords are
-* case-insensitive and accept both singular and plural forms.
-*
-* @param commitMessage - The commit message body to parse
-* @returns Categorized issue references with numbers as strings (no `#` prefix)
-*
-* @example
-* ```typescript
-* import { parseIssueReferences } from "../utils/issue-refs.js";
-*
-* const refs = parseIssueReferences("feat: add API\n\nCloses #42\nFixes: #17, #23");
-* // refs.closes === ["42"]
-* // refs.fixes === ["17", "23"]
-* // refs.refs === []
-* ```
-*
-* @internal
-*/
-function parseIssueReferences(commitMessage) {
-	return {
-		closes: extractIssueNumbers(CLOSES_ISSUE_PATTERN, commitMessage),
-		fixes: extractIssueNumbers(FIXES_ISSUE_PATTERN, commitMessage),
-		refs: extractIssueNumbers(REFS_ISSUE_PATTERN, commitMessage)
-	};
-}
-
-//#endregion
-exports.parseIssueReferences = parseIssueReferences;

package/packages/silk-effects/dist/dev/pkg/changesets/utils/issue-refs.js

@@ -1,101 +0,0 @@
-//#region ../silk-effects/dist/dev/pkg/changesets/utils/issue-refs.js
-/**
-* GitHub issue reference parsing from commit messages.
-*
-* @remarks
-* Extracts categorized issue references (`Closes`, `Fixes`, `Refs`) from
-* commit message bodies. Supports multiple formats including with/without
-* colons, singular/plural keywords, and comma-separated issue lists.
-* Input is truncated to 10,000 characters to prevent ReDoS on adversarial input.
-*
-* @see {@link Changelog} for the public API that consumes issue references
-*
-* @internal
-*/
-/**
-* Matches "closes #123" or "close: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const CLOSES_ISSUE_PATTERN = /closes?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Matches "fixes #123" or "fix: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const FIXES_ISSUE_PATTERN = /fix(?:es)?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Matches "refs #123" or "ref: #456, #789" patterns (case-insensitive).
-*
-* Capture group `[1]` contains the comma-separated issue number list.
-*
-* @internal
-*/
-const REFS_ISSUE_PATTERN = /refs?:?\s*#?(\d+(?:, *#?\d+)*)/i;
-/**
-* Pattern for splitting comma-separated issue numbers.
-*
-* @internal
-*/
-const ISSUE_NUMBER_SPLIT_PATTERN = /, */;
-/**
-* Extract issue numbers from a regex match against a commit message.
-*
-* @remarks
-* Truncates the input to 10,000 characters before matching to prevent
-* ReDoS on adversarial input. Strips `#` prefixes from matched numbers.
-*
-* @param pattern - The regex pattern to match (must have a capture group for issue numbers)
-* @param message - The commit message body to search
-* @returns Array of issue number strings (without `#` prefix)
-*
-* @internal
-*/
-function extractIssueNumbers(pattern, message) {
-	const safeMessage = message.slice(0, 1e4);
-	const match = pattern.exec(safeMessage);
-	if (!match?.[1]) return [];
-	return match[1].split(ISSUE_NUMBER_SPLIT_PATTERN).map((num) => num.replace("#", "").trim());
-}
-/**
-* Parse a commit message for GitHub issue references.
-*
-* Recognizes `Closes`, `Fixes`, and `Refs` keywords with various formats:
-* - `Closes #123`
-* - `Fixes: #456, #789`
-* - `Refs #101`
-*
-* @remarks
-* Each keyword category is matched independently, so a single commit
-* message can contain references in all three categories. Keywords are
-* case-insensitive and accept both singular and plural forms.
-*
-* @param commitMessage - The commit message body to parse
-* @returns Categorized issue references with numbers as strings (no `#` prefix)
-*
-* @example
-* ```typescript
-* import { parseIssueReferences } from "../utils/issue-refs.js";
-*
-* const refs = parseIssueReferences("feat: add API\n\nCloses #42\nFixes: #17, #23");
-* // refs.closes === ["42"]
-* // refs.fixes === ["17", "23"]
-* // refs.refs === []
-* ```
-*
-* @internal
-*/
-function parseIssueReferences(commitMessage) {
-	return {
-		closes: extractIssueNumbers(CLOSES_ISSUE_PATTERN, commitMessage),
-		fixes: extractIssueNumbers(FIXES_ISSUE_PATTERN, commitMessage),
-		refs: extractIssueNumbers(REFS_ISSUE_PATTERN, commitMessage)
-	};
-}
-
-//#endregion
-export { parseIssueReferences };