@cross-css/native-darwin-arm64 0.3.3 → 0.5.0

package/README.md

@@ -95,3 +95,33 @@ Invalid/recovered selectors, unsupported functional selectors, unresolved parent
 and selectors in injection definitions whose call-site context is unknown have
 no exact score. Other valid selector-list members remain queryable. This API does
 not expand injection calls or provide lint thresholds or editor hover UI.
+
+## Shared utilities
+
+`Compiler.compile(entry)` returns an optional `utilities` artifact alongside
+module artifacts. It contains `css`, `sourceMap`, `sourceDependencies`, and mapped
+`rules`. Hosts should deliver that CSS once alongside consuming modules.
+`Compiler.compileUtilities(entries)` returns the deduplicated utility union for
+several entry modules. Recompute the union after source updates or removals.
+Bundled compilation includes utility CSS directly in the module artifact.
+
+## Source formatting
+
+`formatSource(source, options?)` formats XCSS without compiling CSS, resolving
+imports, or reading files. It returns `{ text, diagnostics }`: `text` is absent
+when syntax is invalid, and the original source must be left unchanged. Semantic
+errors such as unresolved references do not prevent formatting. Diagnostic ranges
+are zero-based UTF-16 positions in the original input.
+
+Options are `tabWidth` (1–16, default 2), `useTabs` (default false),
+`printWidth` (1–1000, default 80), and `endOfLine` (`lf` or `crlf`, default
+`lf`). Formatting adds a final newline to nonempty output. `@raw` bodies and
+nodes preceded by `/* prettier-ignore */` remain verbatim, even when their line
+endings differ from the requested layout. Unknown at-rules remain opaque.
+
+The Rust API is `xcss_format::format(source, &FormatOptions)`. The formatter
+uses Malva's Raffia-based CSS printer and an XCSS document printer. CSS golden
+fixtures are pinned to Prettier 3.6.2; exhaustive Prettier equivalence is not
+guaranteed. XCSS headers and expressions use compatible layout conventions.
+Opaque fragments deliberately retain their original spelling; comments are
+preserved byte-for-byte. There is no CLI formatting command in this release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cross-css/native-darwin-arm64",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Precompiled XCSS native binding for darwin/arm64",
   "license": "MIT",
   "author": "Ivan Kobtsev",