@savvy-web/silk-effects 9.6.0 → 10.0.0

package/changesets/api/dependency-table.js

@@ -12,10 +12,10 @@ import { collapseDependencyRows, parseDependencyTable, serializeDependencyTable,
 * @remarks
 * The typical workflow for processing dependency tables is:
 *
-* 1. **Parse** an mdast `Table` node into typed {@link DependencyTableRow} objects
+* 1. **Parse** an `@effected/markdown` `Table` node into typed {@link DependencyTableRow} objects
 * 2. **Collapse** duplicate rows (same package updated multiple times) into single entries
 * 3. **Sort** rows by dependency type, then alphabetically by package name
-* 4. **Serialize** back to an mdast `Table` node or directly to a markdown string
+* 4. **Serialize** back to an `@effected/markdown` `Table` node or directly to a markdown string
 *
 * The {@link DependencyTable.aggregate} method combines the collapse and sort
 * steps into a single call, which is the most common usage pattern.
@@ -28,9 +28,9 @@ import { collapseDependencyRows, parseDependencyTable, serializeDependencyTable,
 * ```typescript
 * import { DependencyTable } from "\@savvy-web/changesets";
 * import type { DependencyTableRow } from "\@savvy-web/changesets";
-* import type { Table } from "mdast";
+* import type { Table } from "\@effected/markdown";
 *
-* // Given an mdast Table node from a parsed CHANGELOG
+* // Given an \@effected/markdown Table node from a parsed CHANGELOG
 * declare const tableNode: Table;
 *
 * // Parse into typed rows
@@ -39,7 +39,7 @@ import { collapseDependencyRows, parseDependencyTable, serializeDependencyTable,
 * // Collapse duplicates and sort by type, then name
 * const aggregated: DependencyTableRow[] = DependencyTable.aggregate(rows);
 *
-* // Serialize back to an mdast Table node for further AST manipulation
+* // Serialize back to an \@effected/markdown Table node for further AST manipulation
 * const outputNode: Table = DependencyTable.serialize(aggregated);
 *
 * // Or serialize directly to a markdown string
@@ -70,7 +70,7 @@ var DependencyTable = class {
 	/* v8 ignore next -- private constructor prevents direct instantiation */
 	constructor() {}
 	/**
-	* Parse an mdast `Table` node into typed dependency table rows.
+	* Parse an `@effected/markdown` `Table` node into typed dependency table rows.
 	*
 	* @remarks
 	* Extracts the text content from each table cell and maps it to the
@@ -78,23 +78,23 @@ var DependencyTable = class {
 	* treated as the header and skipped. Rows that do not have the expected
 	* number of columns are ignored.
 	*
-	* @param tableNode - An mdast `Table` node from a parsed markdown AST
+	* @param tableNode - An `@effected/markdown` `Table` node from a parsed markdown tree
 	* @returns Array of {@link DependencyTableRow} objects, one per data row
 	*/
 	static parse(tableNode) {
 		return parseDependencyTable(tableNode);
 	}
 	/**
-	* Serialize typed dependency table rows into an mdast `Table` node.
+	* Serialize typed dependency table rows into an `@effected/markdown` `Table` node.
 	*
 	* @remarks
-	* Produces a well-formed mdast `Table` with a header row
+	* Produces a well-formed `@effected/markdown` `Table` with a header row
 	* (`Dependency | Type | Action | From | To`) followed by one data row
-	* per input entry. The resulting node can be inserted into a remark AST
+	* per input entry. The resulting node can be inserted into a kit tree
 	* for further processing or stringification.
 	*
 	* @param rows - Array of {@link DependencyTableRow} objects to serialize
-	* @returns An mdast `Table` node ready for AST insertion
+	* @returns An `@effected/markdown` `Table` node ready for tree insertion
 	*/
 	static serialize(rows) {
 		return serializeDependencyTable(rows);
@@ -104,7 +104,7 @@ var DependencyTable = class {
 	*
 	* @remarks
 	* Convenience method that combines {@link DependencyTable.serialize} with
-	* remark stringification. Produces a GFM-compatible markdown table string.
+	* the canonical `@effected/markdown` emitter. Produces a GFM-compatible markdown table string.
 	*
 	* @param rows - Array of {@link DependencyTableRow} objects to render
 	* @returns A markdown string containing the formatted table

package/changesets/api/linter.js

@@ -1,29 +1,34 @@
-import { ContentStructureRule } from "../remark/rules/content-structure.js";
-import { DependencyTableFormatRule } from "../remark/rules/dependency-table-format.js";
-import { HeadingHierarchyRule } from "../remark/rules/heading-hierarchy.js";
-import { RequiredSectionsRule } from "../remark/rules/required-sections.js";
-import { UncategorizedContentRule } from "../remark/rules/uncategorized-content.js";
+import { parseKitMarkdown } from "../utils/markdown-emit.js";
+import { contentStructure } from "../rules/content-structure.js";
+import { dependencyTableFormat } from "../rules/dependency-table-format.js";
+import { headingHierarchy } from "../rules/heading-hierarchy.js";
+import { requiredSections } from "../rules/required-sections.js";
+import { uncategorizedContent } from "../rules/uncategorized-content.js";
 import { stripFrontmatter } from "../utils/strip-frontmatter.js";
-import remarkGfm from "remark-gfm";
-import remarkParse from "remark-parse";
-import { unified } from "unified";
 import { readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
-import remarkStringify from "remark-stringify";
 
 // src/changesets/api/linter.ts
 /**
 * Class-based API wrapper for changeset linting.
 *
-* Provides a static class interface that runs all five remark-lint rules
+* Provides a static class interface that runs all five kit-node lint rules
 * against changeset markdown files and returns structured diagnostics.
 *
 * @internal
 */
+/** The five changeset lint rules, in reporting order. */
+const RULES = [
+	headingHierarchy,
+	requiredSections,
+	contentStructure,
+	dependencyTableFormat,
+	uncategorizedContent
+];
 /**
 * Static class for linting changeset markdown files.
 *
-* Runs the five remark-lint rules (heading-hierarchy, required-sections,
+* Runs the five `@effected/markdown` kit-node lint rules (heading-hierarchy, required-sections,
 * content-structure, dependency-table-format, uncategorized-content) against
 * changeset markdown and returns structured {@link LintMessage} diagnostics.
 *
@@ -136,15 +141,14 @@ var ChangesetLinter = class ChangesetLinter {
 	* @returns Array of {@link LintMessage} diagnostics (empty if the content is valid)
 	*/
 	static validateContent(content, filePath = "<input>") {
-		const body = stripFrontmatter(content);
-		return unified().use(remarkParse).use(remarkGfm).use(remarkStringify).use(HeadingHierarchyRule).use(RequiredSectionsRule).use(ContentStructureRule).use(DependencyTableFormatRule).use(UncategorizedContentRule).processSync(body).messages.map((msg) => ({
+		const root = parseKitMarkdown(stripFrontmatter(content));
+		return RULES.flatMap((rule) => rule(root).map((finding) => ({
 			file: filePath,
-			/* v8 ignore next 3 -- ruleId/line/column fallbacks; remark-lint always provides these */
-			rule: msg.ruleId ?? msg.source ?? "unknown",
-			line: msg.line ?? 1,
-			column: msg.column ?? 1,
-			message: msg.message
-		}));
+			rule: finding.rule,
+			line: finding.position.start.line,
+			column: finding.position.start.column,
+			message: finding.message
+		})));
 	}
 	/**
 	* Validate all changeset `.md` files in a directory.

package/changesets/api/transformer.js

@@ -1,34 +1,36 @@
-import { emitMarkdown } from "../utils/markdown-emit.js";
-import { ContributorFootnotesPlugin } from "../remark/plugins/contributor-footnotes.js";
-import { MaintenanceNotePlugin } from "../remark/plugins/maintenance-note.js";
-import { SilkChangesetTransformPreset } from "../remark/presets.js";
-import remarkGfm from "remark-gfm";
-import remarkParse from "remark-parse";
-import { unified } from "unified";
+import { emitKitMarkdown, parseKitMarkdown } from "../utils/markdown-emit.js";
+import { aggregateDependencyTables } from "../transforms/aggregate-dependency-tables.js";
+import { contributorFootnotes } from "../transforms/contributor-footnotes.js";
+import { deduplicateItems } from "../transforms/deduplicate-items.js";
+import { issueLinkRefs } from "../transforms/issue-link-refs.js";
+import { maintenanceNote } from "../transforms/maintenance-note.js";
+import { mergeSections } from "../transforms/merge-sections.js";
+import { normalizeFormat } from "../transforms/normalize-format.js";
+import { reorderSections } from "../transforms/reorder-sections.js";
 import { readFileSync, writeFileSync } from "node:fs";
 
 // src/changesets/api/transformer.ts
 /**
 * Class-based API wrapper for changelog transformation.
 *
-* Provides a static class interface that runs all remark transform
-* plugins against CHANGELOG markdown content as the post-processing
-* layer of the three-layer pipeline.
+* Provides a static class interface that runs the `@effected/markdown`
+* kit-node changelog transforms against CHANGELOG markdown content as the
+* post-processing layer of the three-layer pipeline.
 *
 * @internal
 */
 /**
 * Static class for post-processing CHANGELOG.md files.
 *
-* Implements the third layer of the three-layer pipeline by running
-* the {@link SilkChangesetTransformPreset} plugins (currently seven) in a
-* fixed order to clean up, normalize, and enhance changelog output produced
-* by the formatter layer.
+* Implements the third layer of the three-layer pipeline by running seven
+* `@effected/markdown` kit-node transforms in a fixed order to clean up,
+* normalize, and enhance changelog output produced by the formatter layer:
+* aggregate dependency tables, merge duplicate sections, reorder sections by
+* category priority, deduplicate list items, aggregate contributor thanks,
+* convert issue references to reference links, and normalize formatting. An
+* optional maintenance-note transform runs last.
 *
 * @remarks
-* See {@link SilkChangesetTransformPreset} for the ordered plugin list and
-* the rationale behind each plugin's position.
-*
 * The transformer operates on the full CHANGELOG.md content (all versions),
 * not just the latest release block. It is idempotent -- running it multiple
 * times produces the same output.
@@ -77,7 +79,7 @@ import { readFileSync, writeFileSync } from "node:fs";
 * }
 * ```
 *
-* @see {@link Categories} for the priority order used by ReorderSectionsPlugin
+* @see {@link Categories} for the priority order used when reordering sections
 * @see {@link ChangesetLinter} for the pre-validation layer (layer 1)
 * @see {@link Changelog} for the formatter layer (layer 2)
 *
@@ -87,15 +89,14 @@ var ChangelogTransformer = class ChangelogTransformer {
 	/* v8 ignore next -- private constructor prevents direct instantiation */
 	constructor() {}
 	/**
-	* Transform CHANGELOG markdown content by running the
-	* {@link SilkChangesetTransformPreset} plugins.
+	* Transform CHANGELOG markdown content by running the kit-node
+	* changelog transforms.
 	*
 	* @remarks
-	* The input is parsed with `remark-parse` and `remark-gfm` (for table
-	* support), processed through every plugin in {@link SilkChangesetTransformPreset}
-	* in order, and emitted back to markdown through the canonical
-	* `@effected/markdown` stringifier. The operation is synchronous and
-	* idempotent.
+	* The input is parsed into `@effected/markdown` nodes (GFM dialect, author
+	* spellings canonicalized), folded through every transform in order, and
+	* emitted back to markdown through the canonical `@effected/markdown`
+	* stringifier. The operation is synchronous and idempotent.
 	*
 	* @param content - Raw CHANGELOG markdown string (may contain multiple
 	*   version blocks, GFM tables, footnotes, and reference links)
@@ -104,19 +105,23 @@ var ChangelogTransformer = class ChangelogTransformer {
 	*   sections merged, reordered, deduplicated, and normalized
 	*/
 	static transformContent(content, options) {
-		const processor = unified().use(remarkParse).use(remarkGfm);
-		for (const plugin of SilkChangesetTransformPreset) if (plugin === ContributorFootnotesPlugin && options?.thanks !== void 0) processor.use(ContributorFootnotesPlugin, { thanks: options.thanks });
-		else processor.use(plugin);
-		if (options?.maintenance) processor.use(MaintenanceNotePlugin, options.maintenance);
-		const parsed = processor.parse(content);
-		const transformed = processor.runSync(parsed);
-		return emitMarkdown(transformed);
+		const pipeline = [
+			aggregateDependencyTables,
+			mergeSections,
+			reorderSections,
+			deduplicateItems,
+			contributorFootnotes(options?.thanks !== void 0 ? { thanks: options.thanks } : void 0),
+			issueLinkRefs,
+			normalizeFormat
+		];
+		if (options?.maintenance) pipeline.push(maintenanceNote(options.maintenance));
+		return emitKitMarkdown(pipeline.reduce((root, transform) => transform(root), parseKitMarkdown(content)));
 	}
 	/**
 	* Transform a CHANGELOG file in-place.
 	*
 	* @remarks
-	* Reads the file synchronously, runs all transform plugins via
+	* Reads the file synchronously, runs all transforms via
 	* {@link ChangelogTransformer.transformContent}, and writes the result
 	* back to the same path. The file is overwritten atomically (single
 	* `writeFileSync` call).

package/changesets/categories/index.js

@@ -217,7 +217,7 @@ const CATEGORIES = [
 ];
 /**
 * Set of all valid section heading strings (case-insensitive lookup).
-* Used by Layer 1 (remark-lint) to validate changeset headings.
+* Used by the kit lint rules (Layer 1) to validate changeset headings.
 */
 const headingToCategory = new Map(CATEGORIES.map((cat) => [cat.heading.toLowerCase(), cat]));
 /**

package/changesets/categories/types.js

@@ -8,8 +8,8 @@ import { Schema } from "effect";
 * Section categories define how changes are grouped and ordered in release
 * notes and CHANGELOGs. Each category maps conventional commit types to a
 * display heading with a priority for ordering. Categories are used across
-* all three processing layers: remark-lint pre-validation (Layer 1),
-* changelog formatting (Layer 2), and remark-transform post-processing
+* all three processing layers: kit lint-rule pre-validation (Layer 1),
+* changelog formatting (Layer 2), and kit transform post-processing
 * (Layer 3).
 *
 * @see {@link CATEGORIES} for the predefined list of 13 section categories

package/changesets/changelog/getDependencyReleaseLine.js

@@ -21,7 +21,7 @@ import { Effect } from "effect";
 * consuming package's `package.json` fields (`dependencies`,
 * `devDependencies`, `peerDependencies`, `optionalDependencies`) via
 * the {@link inferDependencyType} helper. Downstream, the heading is
-* consumed by `AggregateDependencyTablesPlugin`, which locates and
+* consumed by the aggregate-dependency-tables transform, which locates and
 * merges per-package dependency tables during changelog assembly.
 *
 * ### Dependency type inference

package/changesets/changelog/index.js

@@ -61,8 +61,8 @@ import { Effect } from "effect";
 *
 * `GitHubService.layer` satisfies the requirements of both `getReleaseLine` and
 * `getDependencyReleaseLine`, which each need only `GitHubService`. Markdown
-* parsing is not a layer: the formatters call the remark pipeline's
-* `parseMarkdown` / `stringifyMarkdown` functions directly.
+* parsing is not a layer: the formatters call `parseKitMarkdown` /
+* `emitKitMarkdown` from `utils/markdown-emit.ts` directly.
 *
 * @internal
 */

package/changesets/constants.js

@@ -12,7 +12,7 @@ const DOCS_BASE = "https://github.com/savvy-web/systems/blob/main/packages/silk-
 * @remarks
 * Keyed by rule code (`CSH001`--`CSH005`). Each value is a full URL
 * pointing to the rule's documentation page on GitHub. Used by the
-* remark-lint plugins to attach documentation links to diagnostic
+* lint rules to attach documentation links to diagnostic
 * messages.
 *
 * @internal

package/changesets/errors.js

@@ -135,7 +135,7 @@ const MarkdownParseErrorBase = Data.TaggedError("MarkdownParseError");
 * Markdown parsing failure.
 *
 * @remarks
-* Raised when a markdown file cannot be parsed into an AST by the unified/remark
+* Raised when a markdown file cannot be parsed into an AST by the @effected/markdown
 * pipeline. Carries optional source file location information (line, column)
 * for diagnostic display.
 *

package/changesets/index.js

@@ -13,21 +13,7 @@ import { GitHubInfoSchema, IssueNumberSchema, UrlOrMarkdownLinkSchema, UsernameS
 import changelogFunctions, { makeChangelogFunctions } from "./changelog/index.js";
 import { Changelog } from "./api/changelog.js";
 import { DependencyTable } from "./api/dependency-table.js";
-import { ContentStructureRule } from "./remark/rules/content-structure.js";
-import { DependencyTableFormatRule } from "./remark/rules/dependency-table-format.js";
-import { HeadingHierarchyRule } from "./remark/rules/heading-hierarchy.js";
-import { RequiredSectionsRule } from "./remark/rules/required-sections.js";
-import { UncategorizedContentRule } from "./remark/rules/uncategorized-content.js";
 import { ChangesetLinter } from "./api/linter.js";
-import { ContributorFootnotesPlugin } from "./remark/plugins/contributor-footnotes.js";
-import { MaintenanceNotePlugin } from "./remark/plugins/maintenance-note.js";
-import { AggregateDependencyTablesPlugin } from "./remark/plugins/aggregate-dependency-tables.js";
-import { DeduplicateItemsPlugin } from "./remark/plugins/deduplicate-items.js";
-import { IssueLinkRefsPlugin } from "./remark/plugins/issue-link-refs.js";
-import { MergeSectionsPlugin } from "./remark/plugins/merge-sections.js";
-import { NormalizeFormatPlugin } from "./remark/plugins/normalize-format.js";
-import { ReorderSectionsPlugin } from "./remark/plugins/reorder-sections.js";
-import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 import { ChangelogTransformer } from "./api/transformer.js";
 import { vanillaChangelogFunctions } from "./changelog/vanilla.js";
 import { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest } from "./services/config-inspector.js";
@@ -45,16 +31,15 @@ import { CommitHashSchema, VersionTypeSchema } from "./schemas/git.js";
 import { ChangesetSchema, ChangesetSummarySchema, DependencyTypeSchema, DependencyUpdateSchema } from "./schemas/changeset.js";
 import { CoexistingChangesetSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema } from "./schemas/deps-regen.js";
 import { AppliedReleaseEntrySchema, AppliedReleaseSchema, BumpTypeSchema, ChangesetPreviewSchema, PendingChangesetSchema, PreviewReleaseSchema, VersionFileUpdateRecordSchema } from "./schemas/release-plan.js";
-import { ContentStructureRule as ContentStructureRule$1 } from "./markdownlint/rules/content-structure.js";
-import { DependencyTableFormatRule as DependencyTableFormatRule$1 } from "./markdownlint/rules/dependency-table-format.js";
-import { HeadingHierarchyRule as HeadingHierarchyRule$1 } from "./markdownlint/rules/heading-hierarchy.js";
-import { RequiredSectionsRule as RequiredSectionsRule$1 } from "./markdownlint/rules/required-sections.js";
-import { UncategorizedContentRule as UncategorizedContentRule$1 } from "./markdownlint/rules/uncategorized-content.js";
+import { ContentStructureRule } from "./markdownlint/rules/content-structure.js";
+import { DependencyTableFormatRule } from "./markdownlint/rules/dependency-table-format.js";
+import { HeadingHierarchyRule } from "./markdownlint/rules/heading-hierarchy.js";
+import { RequiredSectionsRule } from "./markdownlint/rules/required-sections.js";
+import { UncategorizedContentRule } from "./markdownlint/rules/uncategorized-content.js";
 import SilkChangesetsRules from "./markdownlint/index.js";
 
 // src/changesets/index.ts
 var changesets_exports = /* @__PURE__ */ __exportAll({
-	AggregateDependencyTablesPlugin: () => AggregateDependencyTablesPlugin,
 	AppliedReleaseEntrySchema: () => AppliedReleaseEntrySchema,
 	AppliedReleaseSchema: () => AppliedReleaseSchema,
 	BranchAnalysisSchema: () => BranchAnalysisSchema,
@@ -79,12 +64,8 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	CommitHashSchema: () => CommitHashSchema,
 	ConfigInspector: () => ConfigInspector,
 	ConfigurationError: () => ConfigurationError,
-	ContentStructureRule: () => ContentStructureRule,
-	ContributorFootnotesPlugin: () => ContributorFootnotesPlugin,
-	DeduplicateItemsPlugin: () => DeduplicateItemsPlugin,
 	DependencyActionSchema: () => DependencyActionSchema,
 	DependencyTable: () => DependencyTable,
-	DependencyTableFormatRule: () => DependencyTableFormatRule,
 	DependencyTableRowSchema: () => DependencyTableRowSchema,
 	DependencyTableSchema: () => DependencyTableSchema,
 	DependencyTableTypeSchema: () => DependencyTableTypeSchema,
@@ -98,26 +79,21 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	GitHubInfoSchema: () => GitHubInfoSchema,
 	GitHubService: () => GitHubService,
 	GlobSchema: () => GlobSchema,
-	HeadingHierarchyRule: () => HeadingHierarchyRule,
 	HookReplayError: () => HookReplayError,
 	InspectedConfigSchema: () => InspectedConfigSchema,
-	IssueLinkRefsPlugin: () => IssueLinkRefsPlugin,
 	IssueNumberSchema: () => IssueNumberSchema,
 	JsonPathSchema: () => JsonPathSchema,
 	LegacyVersionFileConfigSchema: () => LegacyVersionFileConfigSchema,
 	LegacyVersionFilesSchema: () => LegacyVersionFilesSchema,
-	MaintenanceNotePlugin: () => MaintenanceNotePlugin,
 	MaintenanceReasonSchema: () => MaintenanceReasonSchema,
 	MaintenanceTriggerSchema: () => MaintenanceTriggerSchema,
 	MarkdownParseError: () => MarkdownParseError,
-	MarkdownlintContentStructureRule: () => ContentStructureRule$1,
-	MarkdownlintDependencyTableFormatRule: () => DependencyTableFormatRule$1,
-	MarkdownlintHeadingHierarchyRule: () => HeadingHierarchyRule$1,
-	MarkdownlintRequiredSectionsRule: () => RequiredSectionsRule$1,
-	MarkdownlintUncategorizedContentRule: () => UncategorizedContentRule$1,
-	MergeSectionsPlugin: () => MergeSectionsPlugin,
+	MarkdownlintContentStructureRule: () => ContentStructureRule,
+	MarkdownlintDependencyTableFormatRule: () => DependencyTableFormatRule,
+	MarkdownlintHeadingHierarchyRule: () => HeadingHierarchyRule,
+	MarkdownlintRequiredSectionsRule: () => RequiredSectionsRule,
+	MarkdownlintUncategorizedContentRule: () => UncategorizedContentRule,
 	NonEmptyString: () => NonEmptyString,
-	NormalizeFormatPlugin: () => NormalizeFormatPlugin,
 	PackageScopeSchema: () => PackageScopeSchema,
 	PackagesRecordSchema: () => PackagesRecordSchema,
 	PendingChangesetSchema: () => PendingChangesetSchema,
@@ -128,16 +104,11 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	RegenResultSchema: () => RegenResultSchema,
 	ReleasePlanError: () => ReleasePlanError,
 	ReleasePlanner: () => ReleasePlanner,
-	ReorderSectionsPlugin: () => ReorderSectionsPlugin,
 	RepoSchema: () => RepoSchema,
-	RequiredSectionsRule: () => RequiredSectionsRule,
 	ResolvedPackageScopeSchema: () => ResolvedPackageScopeSchema,
 	ResolvedVersionFileSchema: () => ResolvedVersionFileSchema,
 	SectionCategorySchema: () => SectionCategorySchema,
-	SilkChangesetPreset: () => SilkChangesetPreset,
-	SilkChangesetTransformPreset: () => SilkChangesetTransformPreset,
 	SilkChangesetsRules: () => SilkChangesetsRules,
-	UncategorizedContentRule: () => UncategorizedContentRule,
 	UrlOrMarkdownLinkSchema: () => UrlOrMarkdownLinkSchema,
 	UsernameSchema: () => UsernameSchema,
 	VERSION_RE: () => VERSION_RE,
@@ -165,4 +136,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	vanillaChangelogFunctions: () => vanillaChangelogFunctions
 });
 
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, HookReplayError, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
+export { AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, DependencyActionSchema, DependencyTable, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HookReplayError, InspectedConfigSchema, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule as MarkdownlintContentStructureRule, DependencyTableFormatRule as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule as MarkdownlintRequiredSectionsRule, UncategorizedContentRule as MarkdownlintUncategorizedContentRule, NonEmptyString, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, RepoSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetsRules, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };

package/changesets/markdownlint/rules/content-structure.js

@@ -33,7 +33,7 @@ function hasContentBetween(tokens, currentIdx, nextIdx) {
 *    `content` token before the next prefix or end of list.
 *
 * @remarks
-* This rule mirrors the remark-lint rule `remarkLintContentStructure` but uses
+* This rule mirrors the kit rule `contentStructure` in `src/changesets/rules/content-structure.ts` but uses
 * markdownlint's micromark token API so it can run inside markdownlint-cli2 and
 * the VS Code markdownlint extension.
 *
@@ -45,7 +45,7 @@ function hasContentBetween(tokens, currentIdx, nextIdx) {
 * ```
 *
 * @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH003.md | CSH003 rule documentation}
-* @see `src/remark/rules/content-structure.ts` for the corresponding remark-lint rule
+* @see `src/changesets/rules/content-structure.ts` for the corresponding kit-node rule
 *
 * @public
 */

package/changesets/markdownlint/rules/heading-hierarchy.js

@@ -15,7 +15,7 @@ import { getHeadingLevel } from "./utils.js";
 *    (h2 then h3, not h2 then h4).
 *
 * @remarks
-* This rule mirrors the remark-lint rule `remarkLintHeadingHierarchy` but uses
+* This rule mirrors the kit rule `headingHierarchy` in `src/changesets/rules/heading-hierarchy.ts` but uses
 * markdownlint's micromark token API so it can run inside markdownlint-cli2 and
 * the VS Code markdownlint extension.
 *
@@ -27,7 +27,7 @@ import { getHeadingLevel } from "./utils.js";
 * ```
 *
 * @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH001.md | CSH001 rule documentation}
-* @see `src/remark/rules/heading-hierarchy.ts` for the corresponding remark-lint rule
+* @see `src/changesets/rules/heading-hierarchy.ts` for the corresponding kit-node rule
 *
 * @public
 */

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

@@ -16,7 +16,7 @@ import { getHeadingLevel, getHeadingText } from "./utils.js";
 * (`src/categories/index.ts`). This rule inspects `atxHeading` micromark
 * tokens and extracts their text via the {@link getHeadingText} utility.
 *
-* This rule mirrors the remark-lint rule `remarkLintRequiredSections` but uses
+* This rule mirrors the kit rule `requiredSections` in `src/changesets/rules/required-sections.ts` but uses
 * markdownlint's micromark token API so it can run inside markdownlint-cli2 and
 * the VS Code markdownlint extension.
 *
@@ -28,7 +28,7 @@ import { getHeadingLevel, getHeadingText } from "./utils.js";
 * ```
 *
 * @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH002.md | CSH002 rule documentation}
-* @see `src/remark/rules/required-sections.ts` for the corresponding remark-lint rule
+* @see `src/changesets/rules/required-sections.ts` for the corresponding kit-node rule
 *
 * @public
 */

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

@@ -16,7 +16,7 @@ import { getHeadingLevel } from "./utils.js";
 * triggers an error. This ensures that changeset content is always grouped
 * under a recognized category heading.
 *
-* This rule mirrors the remark-lint rule `remarkLintUncategorizedContent` but
+* This rule mirrors the kit rule `uncategorizedContent` in `src/changesets/rules/uncategorized-content.ts` but
 * uses markdownlint's micromark token API so it can run inside
 * markdownlint-cli2 and the VS Code markdownlint extension.
 *
@@ -28,7 +28,7 @@ import { getHeadingLevel } from "./utils.js";
 * ```
 *
 * @see {@link https://github.com/savvy-web/systems/blob/main/packages/silk-effects/docs/rules/CSH004.md | CSH004 rule documentation}
-* @see `src/remark/rules/uncategorized-content.ts` for the corresponding remark-lint rule
+* @see `src/changesets/rules/uncategorized-content.ts` for the corresponding kit-node rule
 *
 * @public
 */

package/changesets/markdownlint/rules/utils.js

@@ -5,8 +5,8 @@ import { RULE_DOCS } from "../../constants.js";
 * Get the heading level (1-6) from an `atxHeading` or `setextHeading` token.
 *
 * @remarks
-* remark-parse normalizes setext headings to plain depth-1/2 heading nodes,
-* so the remark siblings of these rules see them as ordinary headings. The
+* `@effected/markdown` normalizes setext headings to plain depth-1/2 heading nodes,
+* so the kit siblings of these rules see them as ordinary headings. The
 * micromark extractors must agree, or the two engines disagree about the
 * same file (the issue #367 class of drift).
 *
@@ -33,9 +33,9 @@ const BACKSLASH_ESCAPE_RE = /\\([!-/:-@[-`{-~])/g;
 * Resolve CommonMark backslash escapes in raw micromark source text.
 *
 * @remarks
-* Every rule in this directory has a sibling remark implementation that reads
-* the parsed mdast tree, where the parser has already resolved escapes, via
-* `mdast-util-to-string`. Micromark tokens instead carry RAW source. Comparing
+* Every rule in this directory has a sibling kit implementation that reads
+* the parsed `@effected/markdown` tree, where the parser has already resolved escapes, via
+* `Mdast.toText`. Micromark tokens instead carry RAW source. Comparing
 * raw text against a value the parsed form would produce makes the two
 * implementations of one documented rule disagree about the same file
 * (issue #367).
@@ -54,7 +54,7 @@ function unescapeMarkdown(raw) {
 *
 * @remarks
 * Escape-resolved, so a heading compares equal to the same heading as the
-* remark rules see it. `getHeadingLevel` needs no equivalent — it counts
+* the kit rules see it. `getHeadingLevel` needs no equivalent — it counts
 * sequence characters rather than reading text.
 *
 * @param heading - The `atxHeading` or `setextHeading` micromark token

package/changesets/rules/content-structure.js

@@ -0,0 +1,44 @@
+import { RULE_DOCS } from "../constants.js";
+import { finding } from "./types.js";
+import { MarkdownVisitor, Mdast } from "@effected/markdown";
+
+// src/changesets/rules/content-structure.ts
+/**
+* Lint rule: changeset-content-structure (CSH003).
+*
+* @remarks
+* Kit rule. Flags empty h2 sections, code fences
+* without a language, and empty list items. Findings are emitted in three
+* passes (headings, code, list items) to match the markdownlint rule's order.
+*
+* @internal
+*/
+const RULE = "changeset-content-structure";
+/**
+* Validate section and block content quality.
+*
+* @internal
+*/
+const contentStructure = (root) => {
+	const findings = [];
+	root.children.forEach((node, index) => {
+		if (node.type !== "heading" || node.depth !== 2) return;
+		const next = root.children[index + 1];
+		if (!next || next.type === "heading" && next.depth === 2) findings.push(finding(RULE, `Empty section: heading has no content before the next section or end of file. Add a list of changes (e.g., "- Added feature X") under this heading, or remove the empty heading. See: ${RULE_DOCS.CSH003}`, node));
+	});
+	const codes = [];
+	const items = [];
+	for (const event of MarkdownVisitor.walk(root)) {
+		if (event._tag !== "Enter") continue;
+		const node = event.node;
+		if (node.type === "code" && !node.lang) codes.push(finding(RULE, `Code block is missing a language identifier. Add a language after the opening fence (e.g., \`\`\`ts, \`\`\`json, \`\`\`bash). See: ${RULE_DOCS.CSH003}`, node));
+		else if (node.type === "listItem" && !Mdast.toText(node).trim()) items.push(finding(RULE, `Empty list item. Each list item must contain descriptive text (e.g., "- Fixed login timeout issue"). See: ${RULE_DOCS.CSH003}`, node));
+	}
+	return [
+		...findings,
+		...codes,
+		...items
+	];
+};
+
+export { contentStructure };