@cross-css/native-darwin-arm64 0.2.0 → 0.3.0

package/README.md

@@ -1,3 +1,42 @@
-# `@cross-css/native`
+# @cross-css/native
+
+Native Node.js bindings for XCSS parsing, analysis, and scoped CSS generation.
+Consumers do not need Rust or Sass installed; platform packages provide binaries.
+
+```js
+import { Compiler, inspect } from '@cross-css/native'
+const compiler = new Compiler()
+compiler.setFile('button.xcss', 1, '.button { padding: --space * 2; }')
+const result = compiler.compile('button.xcss')
+if (!result.success) throw new Error(JSON.stringify(result.diagnostics))
+const artifact = result.artifacts.find(item => item.moduleId === 'button.xcss')
+console.log(artifact.css, artifact.classes, artifact.sourceMap)
+```
+
+Use normalized, project-relative module IDs and increasing revisions. File updates
+reuse other parse trees. `removeFile(id, revision)` retains the deletion revision
+so stale updates cannot resurrect files. Host adapters load files and resolve
+imports; the native compiler performs no filesystem access.
+
+`inspect(source).imports` returns injection/composition specifiers. Supply
+`setResolution(importer, specifier, targetOrNull)` for each. All project files
+should be loaded to support globally unique injection resolution.
+
+`compile(entry, minify?, bundle?)` returns success, artifacts, and diagnostics.
+Default artifacts are per-module scoped CSS with class mappings, custom-property
+names, original-source maps, native imports, composition stylesheet dependencies,
+and source dependencies. Bundling combines only composition dependencies and
+rebases their assets to the entry. Injection dependencies contribute definitions
+only. Diagnostics carry stable codes, severity, module ID, byte span, related
+locations, and one-based UTF-16 line/column positions. Errors return no artifacts.
+
+`index.d.ts` is generated from napi-rs binding metadata during the native build.
+# Editor queries
+
+Version 0.3.0 also exports `LanguageService` and `languageServiceCapabilities()`.
+The service accepts the same versioned in-memory updates as `Compiler`, with file
+URIs supported as identities. `document(uri)` returns diagnostics and semantic
+tokens; `definition`, `references`, and `hover` accept zero-based UTF-16 positions.
+These APIs do not compile CSS or read files. See the repository's
+[language-service contract](https://github.com/IvanKobtsev/XCSS/blob/main/docs/language-service.md).
 
-Internal native Node.js bindings for the XCSS compiler. Most users should install `@cross-css/vite-plugin` instead; it selects this package and the correct precompiled platform binary automatically.

package/package.json

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