@savvy-web/changesets 0.1.0 → 0.1.1

package/esm/markdownlint.d.ts

@@ -0,0 +1,61 @@
+/**
+ * markdownlint custom rules for validating changeset file structure.
+ *
+ * Provides the same validation as the remark-lint rules but using
+ * markdownlint's micromark token API for integration with
+ * markdownlint-cli2 and the VS Code markdownlint extension.
+ *
+ * - `changeset-heading-hierarchy` (CSH001): Enforce h2 start, no h1, no depth skips
+ * - `changeset-required-sections` (CSH002): Validate section headings match known categories
+ * - `changeset-content-structure` (CSH003): Content quality validation
+ *
+ * @packageDocumentation
+ */
+
+import type { Rule } from 'markdownlint';
+
+/**
+ * markdownlint rule: changeset-content-structure (CSH003)
+ *
+ * Validates content quality in changeset files:
+ * - Sections must not be empty (h2 followed immediately by another h2 or EOF)
+ * - Code blocks must have a language identifier
+ * - List items should have meaningful content (not empty)
+ */
+export declare const ContentStructureRule: Rule;
+
+/**
+ * markdownlint rule: changeset-heading-hierarchy (CSH001)
+ *
+ * Validates heading structure in changeset files:
+ * - No h1 headings allowed
+ * - Headings must start at h2
+ * - No depth skips (e.g., h2 ... h4 is invalid)
+ */
+export declare const HeadingHierarchyRule: Rule;
+
+/**
+ * markdownlint rule: changeset-required-sections (CSH002)
+ *
+ * Validates that all h2 headings in changeset files match a known
+ * category heading from the category system. Reports unrecognized
+ * headings with the list of valid options.
+ */
+export declare const RequiredSectionsRule: Rule;
+
+/**
+ * All changeset rules as an array for markdownlint-cli2 `customRules` config.
+ *
+ * @example
+ * ```json
+ * {
+ *   "customRules": ["@savvy-web/changesets/markdownlint"]
+ * }
+ * ```
+ *
+ * @public
+ */
+declare const SilkChangesetsRules: Rule[];
+export default SilkChangesetsRules;
+
+export { }

package/esm/remark.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Consolidated remark plugins for changeset validation and CHANGELOG transformation.
+ *
+ * Re-exports all lint rules and transform plugins from a single entry point.
+ *
+ * @packageDocumentation
+ */
+
+import { Plugin } from 'unified';
+import { Plugin as Plugin_2 } from 'unified-lint-rule';
+import { Root } from 'mdast';
+
+export declare const ContentStructureRule: Plugin_2<Root, unknown>;
+
+/**
+ * Extract inline contributor attributions and aggregate them into
+ * a summary paragraph at the end of each version block.
+ */
+export declare const ContributorFootnotesPlugin: Plugin<[], Root>;
+
+/**
+ * Remove duplicate list items within each h3 section.
+ *
+ * Items are compared by their plain text content. If a list becomes
+ * empty after deduplication, it is removed from the tree.
+ */
+export declare const DeduplicateItemsPlugin: Plugin<[], Root>;
+
+export declare const HeadingHierarchyRule: Plugin_2<Root, unknown>;
+
+/**
+ * Convert inline issue links to reference-style links with definitions
+ * at the end of each version block.
+ */
+export declare const IssueLinkRefsPlugin: Plugin<[], Root>;
+
+/**
+ * Merge duplicate h3 sections within each version block.
+ *
+ * Groups sections by heading text (case-insensitive via `fromHeading`),
+ * keeps the first occurrence, and splices content from duplicates into it.
+ */
+export declare const MergeSectionsPlugin: Plugin<[], Root>;
+
+/**
+ * Remove empty sections and empty lists from the document.
+ */
+export declare const NormalizeFormatPlugin: Plugin<[], Root>;
+
+/**
+ * Reorder h3 sections within each version block by category priority.
+ */
+export declare const ReorderSectionsPlugin: Plugin<[], Root>;
+
+export declare const RequiredSectionsRule: Plugin_2<Root, unknown>;
+
+/**
+ * Preset combining all changeset lint rules for convenient consumption.
+ *
+ * @example
+ * ```typescript
+ * import { SilkChangesetPreset } from "\@savvy-web/changesets/remark";
+ * import remarkParse from "remark-parse";
+ * import { unified } from "unified";
+ *
+ * const processor = unified().use(remarkParse);
+ * for (const rule of SilkChangesetPreset) {
+ *   processor.use(rule);
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const SilkChangesetPreset: readonly [Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>];
+
+/**
+ * Ordered array of all transform plugins in the correct execution order.
+ *
+ * @remarks
+ * Plugin ordering is significant:
+ * 1. `MergeSectionsPlugin` -- merge duplicate h3 headings (must run before reorder)
+ * 2. `ReorderSectionsPlugin` -- sort sections by category priority
+ * 3. `DeduplicateItemsPlugin` -- remove duplicate list items
+ * 4. `ContributorFootnotesPlugin` -- aggregate contributor attributions
+ * 5. `IssueLinkRefsPlugin` -- convert inline issue links to reference-style
+ * 6. `NormalizeFormatPlugin` -- final cleanup (remove empty sections/lists)
+ *
+ * @public
+ */
+export declare const SilkChangesetTransformPreset: readonly [Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>];
+
+export { }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/changesets",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"private": false,
 	"description": "Custom changelog formatter and markdown processing pipeline for the Silk Suite. Provides structured changeset sections, remark-based validation and transformation, and an Effect CLI.",
 	"keywords": [
@@ -29,31 +29,35 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"types": "./index.d.ts",
-			"import": "./index.js"
+			"types": "./esm/index.d.ts",
+			"import": "./esm/index.js",
+			"require": "./cjs/index.cjs"
 		},
 		"./changelog": {
-			"types": "./changelog.d.ts",
-			"import": "./changelog.js"
+			"types": "./esm/changelog.d.ts",
+			"import": "./esm/changelog.js",
+			"require": "./cjs/changelog.cjs"
 		},
 		"./markdownlint": {
-			"types": "./markdownlint.d.ts",
-			"import": "./markdownlint.js"
+			"types": "./esm/markdownlint.d.ts",
+			"import": "./esm/markdownlint.js",
+			"require": "./cjs/markdownlint.cjs"
 		},
 		"./remark": {
-			"types": "./remark.d.ts",
-			"import": "./remark.js"
+			"types": "./esm/remark.d.ts",
+			"import": "./esm/remark.js",
+			"require": "./cjs/remark.cjs"
 		}
 	},
 	"bin": {
-		"savvy-changesets": "./bin/savvy-changesets.js"
+		"savvy-changesets": "./esm/bin/savvy-changesets.js"
 	},
 	"dependencies": {
 		"@changesets/get-github-info": "^0.7.0",
 		"@effect/cli": "^0.73.2",
-		"@effect/platform": "^0.94.4",
+		"@effect/platform": "^0.94.5",
 		"@effect/platform-node": "^0.104.1",
-		"effect": "^3.19.16",
+		"effect": "^3.19.17",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",
 		"remark-gfm": "^4.0.1",
@@ -72,28 +76,18 @@
 			"optional": false
 		}
 	},
+	"scripts": {
+		"postinstall": "savvy-changesets init --check"
+	},
 	"files": [
 		"!changesets.api.json",
 		"!tsconfig.json",
 		"!tsdoc.json",
-		"160.js",
-		"234.js",
-		"245.js",
-		"273.js",
-		"60.js",
-		"689.js",
 		"LICENSE",
 		"README.md",
-		"bin/savvy-changesets.js",
-		"changelog.d.ts",
-		"changelog.js",
-		"index.d.ts",
-		"index.js",
-		"markdownlint.d.ts",
-		"markdownlint.js",
+		"cjs",
+		"esm",
 		"package.json",
-		"remark.d.ts",
-		"remark.js",
 		"tsdoc-metadata.json"
 	]
 }