Changelog
All notable changes to SpiraCSS packages are documented here.
0.6.0
Version 0.6.0 adds shared source-aware markup validation and corrects lint diagnostics and generated index merging. The APIs and diagnostics below are not available in 0.5.1.
- Add source-aware HTML, WebC, JSX, TSX, Astro and Vue validation shared by CLI, optional ESLint integration and VS Code. Bundle the JavaScript parsers, Astro compiler WASM asset and third-party notices.
- Add original UTF-16 ranges, reasons, branch conditions and effective-config repair conditions for AI correction loops. Reports without source-location evidence omit positions; VS Code keeps them in output without fabricated squiggles.
- Check each source occurrence and report later unclassified tokens as
UNCLASSIFIED_CLASS_TOKEN, so new diagnostics may stop default generation. Generation alone aggregates repeated classes; allowed-input output remains compatible. - Add invocation-local parser loading, synchronous source lint, explicit
--formatand JSON source coverage and parser-operation metadata while retaining existing synchronous APIs. In-scope unknowns are failed, parser and configuration failures are blocked, and only pass is successful. - Evaluate supported finite expressions with binding scopes, branch conditions and host-specific attribute composition shared by lint and generation. Remove only optional class tokens proved irrelevant before alternative expansion; ESLint config cache identity includes naming RegExp source and flags.
- Use official synchronous Astro TSX conversion, Babel and the source map for standalone validation. Independently verified siblings remain checked around unresolved source relations, without asserting uncertain ancestry or permitting document generation.
- Allow configured dynamic ARIA in data mode without value-naming rules or forced boolean rewrites, and generate reachable known selectors. Report incomplete generation enumeration as
coverage.generationUnenumeratedSites, with a nonzero-only CLI or VS Code Output line; existing synchronous generated-file arrays carry no count. - Treat dynamic configured data values as unresolved, so results can differ from published 0.5.1. Static valid and invalid values retain naming checks.
- Keep naming, ownership, leaf Blocks, unlimited HTML design-level Block depth and SCSS scope policy unchanged. Validation covers source, not component props forwarding, slots, rendered DOM or complete language grammar.
- Document diagnostic-driven minimal repair and recommend the existing Stylelint
selector-max-type: 0rule only in component paths, retaining page and global exceptions. - Document the known 70,000-element Astro host limitation, which exceeds 45 seconds with the SpiraCSS rule disabled. Standalone completion does not establish large-input host support; see the host versions and verification boundary.
- Require Node.js
>=24.22.3 <25for the npm packages and use 24.22.3 for extension development and packaging. Align all package versions to 0.6.0. The historical 0.5.1 requirement and VS Code minimum are unchanged. Comment Links has no behavior change.
Maintenance fixes
-
Official site: update Astro to 7.4.7, which includes the fixes for dynamic tag attribute injection and image endpoint path validation.
-
Stylelint: attach selector parse and expansion-limit diagnostics to the failing source Rule, preserving repeated selectors, line-level disable directives, and ancestor or scope locations. Keep the expansion cap at 1,000.
-
Stylelint: skip empty-valued literal Sass property groups in the six structural rules. The two declaration-checking rules report that the nested declarations were not checked and ask for prefixed properties in the same owning rule, preserving all values. This does not add nested-property expansion or change existing limits for valued groups, interpolation, or whitespace variants.
-
HTML CLI: pass relevant WebC dynamic input types and finite attribute objects to the shared validator, retaining first expression parsing in the parser or host wrapper. Avoid unrelated type diagnostics and type-expression parsing.
-
HTML CLI and HTML-to-SCSS: preserve comments,
@forwardstatements, variables, and indentation when mergingindex.scss. Avoid duplicate bare@usestatements for the same URL despite quote or tab differences. Leave content and modification time unchanged when no entries are missing. Multiline statements, comments,asorwithclauses, trailing comments, and relative-URL resolution retain their existing limits. -
Remove unused internal paths and redundant write guards, and share existing selector handling without changing public APIs or configuration.
0.5.0
The component root default changes to scope-explicit. Existing projects can set generator.scssRootStyle: 'class' to retain previous root generation and root syntax lint behavior without rewriting CSS. Child-file scopes are prohibited for all settings and require manual migration. HTML lint is unchanged. Comment Links has no functional change and is version-aligned with the release.
- Stylelint: recognize
@scopecomponent roots and optional:scope/&references across the existing structural and ownership checks, without changing CSS output or specificity. - Stylelint: require scope for component roots when configured for scope; reject every
@scopein configured child Block directories, support container/layer wrappers, and explain the Sass risk and class-form repair without moving the root include or changing generated child specificity. - Stylelint: reject ambiguous nested scope ownership, prioritize explicitly configured component paths over the legacy
assets/cssexclusion, and classify child directories independently of component alias order. - HTML CLI and HTML-to-SCSS extension: add shared
generator.scssRootStyleselection (class,scope,scope-explicit), defaulting new component root SCSS toscope-explicit. Block files loaded bymeta.load-css()and selection-mode output retain class selectors; existing files are not converted. - Document the new forms, unchanged HTML rules, and Sass leading-combinator compatibility.
- Update the English/Japanese CLI and VS Code tool guides, conversion examples, and diagnostic-first AI routing for the 0.5.0 root syntax.
- Recommend
scope-explicitfor scoped SCSS compiled with Sass, while retaining optional direct scope syntax and avoiding automatic specificity-changing conversions. - VS Code extensions: exclude verification logs and compiled tests from the distributed VSIX packages.
0.4.5
@spiracss/stylelint-plugin
Changed
- Align the package version with the monorepo release. No functional changes were made to the Stylelint rules in this release.
@spiracss/html-cli
Fixed
- Prevent HTML lint and HTML-to-SCSS from timing out on quoted attributes and arbitrary custom WebC components.
- Preserve nested JSX spread expressions without corrupting opening tags, and keep source diagnostics efficient for large inputs.
VS Code extensions
spiracss-html-to-scss
- Consume the fixed
@spiracss/html-cli0.4.5implementation. - Align the extension version with the monorepo release.
spiracss-comment-links
- Align the extension version with the monorepo release.
Documentation
- Update the AI agent guide, current-release badges, and compatibility references to
0.4.5.
0.4.4
@spiracss/stylelint-plugin
Changed
- Selector parse failures are reported as errors by default while explicit severity overrides remain supported.
@spiracss/html-cli
Added
- Configurable classless HTML tag allowlists and structured diagnostics for AI-assisted lint fixes.
Changed
- Configuration and diagnostic handling are shared across HTML lint, generation, formatting, and the VS Code integration.
VS Code extensions
Changed
- Align extension packages with the
0.4.4monorepo release and the shared HTML CLI behavior.
0.4.3-beta
@spiracss/stylelint-plugin
Added
spiracss/property-placement: addmarginSideTagsoption (default:true) so tag-selector rules also followmarginSide.
Changed
spiracss/property-placement: refinemarginSideTagstag detection to count only tags in the selector chain (exclude tags only inside pseudo arguments such as:is(main)).spiracss/property-placement: add regression tests for tag/class mixed selectors,marginSide: 'bottom'with tag selectors, and non-tag unverified selector skip behavior.
@spiracss/html-cli
- Align package version with the monorepo release.
VS Code Extensions
spiracss-comment-links
- Align extension version with the monorepo release.
spiracss-html-to-scss
- Update
@spiracss/html-clidependency to^0.4.3. - Align extension version with the monorepo release.
Documentation
- Updated
spiracss/property-placementdocs (en/ja) formarginSideTagsbehavior and selector coverage notes. - Updated AI agent guide to v0.4.3-beta.
- Updated header/quickstart version badges to v0.4.3-beta.
0.4.2-beta
@spiracss/stylelint-plugin
Fixed
spiracss/class-structure: report repeated definitions of the same root Block asduplicateRootBlockwhenrootSingle: true.spiracss/class-structure: suppress duplicaterootSelectorNeedNestingwarnings whenduplicateRootBlockis already reported for the same selector.spiracss/class-structure: add explicitAuto-fixguidance for root-related diagnostics (multipleRootBlocks,duplicateRootBlock,rootSelectorMissingBlock,rootSelectorNeedNesting).
@spiracss/html-cli
- Align package version with the monorepo release.
VS Code Extensions
spiracss-comment-links
- Align extension version with the monorepo release.
spiracss-html-to-scss
- Update
@spiracss/html-clidependency to^0.4.2. - Align extension version with the monorepo release.
Documentation
- Added
duplicateRootBlock/rootSelectorNeedNestingsections to class-structure docs (en/ja). - Updated AI agent guide to v0.4.2-beta.
- Updated header/quickstart version badges to v0.4.2-beta.
0.4.1-beta
@spiracss/stylelint-plugin
Fixed
spiracss/class-structure: withrootSingle: true, top-level selectors made only ofexternal.classes/external.prefixescan no longer bypass root Block inclusion checks.spiracss/class-structure: reportduplicateRootBlockwhen the same root Block is defined multiple times in one file, and clarify nested rewrite guidance forrootSelectorNeedNesting.
@spiracss/html-cli
- Align package version with the monorepo release.
VS Code Extensions
spiracss-comment-links
- Align extension version with the monorepo release.
spiracss-html-to-scss
- Update
@spiracss/html-clidependency to^0.4.1. - Align extension version with the monorepo release.
Documentation
- Updated AI agent guide to v0.4.1-beta.
- Updated header/quickstart version badges to v0.4.1-beta.
0.4.0-beta
@spiracss/stylelint-plugin
Breaking Changes
- Stylelint v17 required: Dropped Stylelint v16 support. Users on v16 should pin
@spiracss/stylelint-plugin@0.3.x. - ESM only: Dropped CommonJS build. The package now ships ESM only.
- Node.js >= 20.19.0: Minimum Node.js version raised to match Stylelint 17.
moduleResolution: TypeScriptmoduleResolutionmust beBundler,Node16, orNodeNext(Stylelint 17 usesexportsfor type declarations).createRules()accepts config object only:createRules(path)no longer accepts a file path string. Importspiracss.config.jsand pass the config object directly, or usecreateRulesAsync(path)for path-based loading.
Changed
- Simplified
helpers.ts: removed CJS compatibility code (~80 lines),loadConfigFromPathAsyncnow uses nativeimport()directly. - Removed CJS build scripts and
tsconfig.build.cjs.json. - Build scripts converted from
.cjsto.mjs.
@spiracss/html-cli
- Align package version with the monorepo release.
VS Code Extensions
spiracss-comment-links
- Align extension version with the monorepo release.
spiracss-html-to-scss
- Update
@spiracss/html-clidependency to^0.4.0. - Align extension version with the monorepo release.
Documentation
- Updated all docs to remove CJS examples and add ESM-only configuration.
- Added v0.3 AI agent documentation for Stylelint v16 users.
- Updated AI agent guide to v0.4.0-beta.
0.3.4-beta
@spiracss/stylelint-plugin
Fixed
- Allow
@at-rootinside interaction sections for external-only root selectors (external classes only).
Documentation
- Document external-only root exceptions for
@at-root.
0.3.3-beta
@spiracss/stylelint-plugin
Fixed
- When using
createRules(), fall back toaliasRoots.componentsforcomponentsDirsifstylelint.base.paths.componentsis not set, avoidingnonComponentLinkfalse positives.
Documentation
- Update config docs and AI agent guide to document the
componentsDirsfallback.
0.3.2-beta
@spiracss/stylelint-plugin
Changed
- Treat CSS Modules
:global/:localas transparent across rules (the inner selector is linted). - Improve selector handling for
:globalwrappers (including rightmost:global(...)targets and selector lists). - Root filename checks (
rootFile) accept*.module.scssand supportchildFileCasefor files underchildDir.
@spiracss/html-cli
Added
- Improve JSX class/className extraction (string/template literals, member access).
- Add
jsxClassBindings.memberAccessAllowlistto restrict member access extraction (empty array disables it).
Changed
- Default
generator.layoutMixinsis now empty ([]) (no mixins are injected unless configured).
VS Code Extensions
spiracss-html-to-scss
- Update
@spiracss/html-clidependency to^0.3.2.
spiracss-comment-links
- Align extension version with the monorepo release.
Documentation
- Update AI agent guide and config docs for v0.3.2 (
rootFile/@relfileCase, CSS Modules notes).
0.3.1-beta
@spiracss/stylelint-plugin
Added
stylelint.rel.fileCase/stylelint.rel.childFileCaseoptions.- Accepts
*.module.scssfor child link comments (CSS Modules). stylelint.class.rootCasedefaultsstylelint.rel.fileCasewhen usingcreateRules().
Changed
- Child link checks now use
childFileCaseforchildDirtargets andfileCasefor other targets.
@spiracss/html-cli
Added
- Support
childFileCasewhen generating child SCSS filenames and@relcomments.
VS Code Extensions
spiracss-html-to-scss
- Support
childFileCasefor child SCSS generation (aligned with HTML CLI). - Update
@spiracss/html-clidependency to^0.3.1.
spiracss-comment-links
- Align extension version with the monorepo release.
Documentation
- Update
rel-commentsoption docs (fileCase/childFileCase/*.module.scss). - Update AI agent guide compatibility.
0.3.0-beta
@spiracss/stylelint-plugin
Breaking Changes
- Stylelint config restructured:
stylelint.classStructurereplaced bystylelint.base/stylelint.class, plus new per-rule sections (stylelint.placement,stylelint.pageLayer,stylelint.interactionProps,stylelint.keyframes,stylelint.pseudo,stylelint.rel). - Section renames:
interactionProperties→interactionProps,keyframesNaming→keyframes,pseudoNesting→pseudo,relComments→rel. - Comment/cache keys renamed:
stylelint.sectionCommentPatterns→stylelint.base.comments,stylelint.cacheSizes→stylelint.base.cache,sharedCommentPattern/interactionCommentPattern→comments.shared/comments.interaction. - External allowlist moved:
allowExternalClasses/allowExternalPrefixes→external.classes/external.prefixes. - New rules enabled by default:
spiracss/property-placement,spiracss/page-layer.
Added
- New rule:
spiracss/page-layer— Validates page-layer SCSS (component link comments required for child Blocks) - New rule:
spiracss/property-placement— Validates property placement (container/item/internal) based on selector role stylelint.pseudo.enabledoption
Changed
- Improved selector parsing and validation logic
- Error messages updated for clarity
- Better support for
selectorPolicy(data/class mode)
@spiracss/html-cli
Breaking Changes
- Config schema aligned with the new stylelint config: naming/external settings now read from
stylelint.base/stylelint.class(oldstylelint.classStructurekeys removed). - External allowlist renamed to
external.classes/external.prefixes.
Changed
- HTML lint and SCSS generation now use the new
externaloption shape. - Config warnings now report the naming source.
VS Code Extensions
spiracss-comment-links
- Documentation links updated to the official site.
spiracss-html-to-scss
- Config schema aligned with the new stylelint config (same breaking changes as HTML CLI).
- External allowlist renamed to
external.classes/external.prefixes.
Documentation
- Documentation updated on the official site (spiracss.jp)
- New rule documentation:
spiracss/page-layer,spiracss/property-placement - Wording update: “AI” → “AI agents” for consistency
- Rule docs updated to reflect new error messages and examples
0.2.2-beta
@spiracss/stylelint-plugin
Added
keyframes.enabledoption to disable thespiracss/keyframes-namingrule entirely
Documentation
- Add SpiraCSS Design Principles link to README
- Add Japanese documentation links to Docs section
@spiracss/html-cli
Documentation
- Add SpiraCSS Design Principles link to README
- Add Japanese documentation links to Docs section
- Improve description wording for clarity
VS Code Extensions
spiracss-comment-links
- Add SpiraCSS Design Principles link to README
- Add Japanese documentation links to Docs section
spiracss-html-to-scss
- Add SpiraCSS Design Principles link to README
- Add Japanese documentation links to Docs section
0.2.1-beta
First beta release of all SpiraCSS packages.
0.1.x (Alpha)
Experimental releases during initial development.