sheetom 0.1.0-rc.9 → 0.1.0

package/docs/api.md

@@ -42,13 +42,17 @@ readable and mutable. Assigning any `CSSRule.cssText` is a successful no-op.
 
 `serialize()` is the SheetOM extension that emits reparsable CSS from current
 state. This can differ deliberately from browser-facing `cssText` when CSS
-Syntax end-of-input recovery preserved malformed source text.
+Syntax end-of-input recovery preserved malformed source text. It remains
+resilient when CSS text cannot exactly encode an imperative pending-shorthand
+state and emits an opt-in `UNREPRESENTABLE_PENDING_SHORTHAND` diagnostic.
+`serializeStrict()` throws `SheetOMSerializationError` for that state instead.
 
 | Surface | Contract |
 | --- | --- |
 | `CSSStyleDeclaration.cssText` | Browser-compatible observable declarations, including recovery quirks. |
 | `CSSRule.cssText` | Browser-compatible observable text for the current rule. |
 | `CSSStyleSheet.serialize()` | Deterministic Reparsable Stylesheet Serialization with repairs confined to their declaration or rule. |
+| `CSSStyleSheet.serializeStrict()` | Exact-only reparsable serialization; rejects states CSS text cannot faithfully represent. |
 
 “Reparsable” guarantees syntactic reparse, no declaration/rule leakage, and
 preservation of SheetOM’s valid semantic state. It is not URL sanitization,
@@ -94,6 +98,37 @@ throws `TypeError`. Invalid priorities, unsupported names, invalid grammars,
 and embedded priority tokens are atomic no-ops. Diagnostics are optional and
 never change those return values or mutations.
 
+For compilers that have several mutations for one block, SheetOM adds
+`applyMutations(operations)`. It crosses the engine boundary once while
+executing the same ordered declaration state transitions:
+
+```ts
+const results = rule.style.applyMutations([
+  { kind: "set", property: "padding", value: "8px 16px" },
+  { kind: "set", property: "width", value: "20px; color: red" },
+  { kind: "remove", property: "padding-left" },
+]);
+
+// results[0] => { kind: "set", accepted: true, diagnostic: null }
+// results[1] => { kind: "set", accepted: false, diagnostic: { ... } }
+// results[2] => { kind: "remove", value: "16px" }
+```
+
+Results correspond by index. A set is `accepted: true` when `setProperty`
+would apply it, including an accepted no-op or empty-value removal. Rejections
+are atomic for that operation and return a diagnostic even when the sheet
+diagnostic queue is disabled. When diagnostics are enabled, the same object is
+also queued and can be drained once after the batch. Removes return the prior
+observable value exactly like `removeProperty()`.
+
+The batch itself is ordered, not globally atomic. A Resource Budget error
+throws at the same operation as sequential calls and retains earlier commits.
+The complete operation array is shape-checked before mutation and deliberately
+requires string properties/priorities and string-or-null values rather than
+performing arbitrary WebIDL coercion. Group operations by
+`CSSStyleDeclaration`; do not concatenate them into CSS text, because that
+would change duplicate, priority, invalid-recovery and removal semantics.
+
 Parser support for modern or implementation-dependent grammar is described by
 the release-versioned Value Capability Corpus. SheetOM uses checked-in
 validators synchronously and never launches or contacts a browser at runtime.
@@ -151,11 +186,12 @@ read-only until a standards-defined mutable interface is implemented.
 
 Required WebIDL arguments throw `TypeError`. Parse and hierarchy failures use
 `DOMException` names matching browser APIs. `takeDiagnostics()` drains
-SheetOM-only warnings when diagnostics were enabled; otherwise it returns an
-empty array. `SheetOMDiagnostic.code` is the exported
-`SheetOMDiagnosticCode` string union. The optional queue retains each complete
-input string until it is drained; callers handling untrusted or unusually large
-inputs should disable diagnostics or drain the queue promptly.
+SheetOM-only mutation and serialization warnings when diagnostics were enabled;
+otherwise it returns an empty array. `SheetOMDiagnostic.code` is the exported
+`SheetOMDiagnosticCode` string union. Serialization recovery diagnostics expose
+`conflictingLonghands`; mutation diagnostics retain their complete input string
+until drained. Callers handling untrusted or unusually large inputs should
+disable diagnostics or drain the queue promptly.
 
 SheetOM does not implement DOM association, style-sheet collections, cascade,
 selector matching, resolved/computed values, layout, fetching, or sanitizing.

package/engine-abi.json

@@ -1,5 +1,5 @@
 {
-  "abiVersion": 1,
-  "sheetomVersion": "0.1.0-rc.9",
-  "syntaxEngineSetSha256": "2af7ec76ba46a3f20f74a90172a708afab5dcb20f45b658a4d975caed76dc855"
+  "abiVersion": 3,
+  "sheetomVersion": "0.1.0",
+  "syntaxEngineSetSha256": "31990c26ede4e17c3a8941027f92b2be96a167984d0ab6529e724c3d6126be50"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheetom",
-  "version": "0.1.0-rc.9",
+  "version": "0.1.0",
   "description": "A browser-compatible mutable CSSOM for JavaScript runtimes",
   "keywords": [
     "css",
@@ -48,19 +48,19 @@
     "SECURITY.md"
   ],
   "optionalDependencies": {
-    "@sheetom/native-darwin-arm64": "0.1.0-rc.9",
-    "@sheetom/native-darwin-x64": "0.1.0-rc.9",
-    "@sheetom/native-linux-arm-gnueabihf": "0.1.0-rc.9",
-    "@sheetom/native-linux-arm-musleabihf": "0.1.0-rc.9",
-    "@sheetom/native-linux-arm64-gnu": "0.1.0-rc.9",
-    "@sheetom/native-linux-arm64-musl": "0.1.0-rc.9",
-    "@sheetom/native-linux-ppc64-gnu": "0.1.0-rc.9",
-    "@sheetom/native-linux-s390x-gnu": "0.1.0-rc.9",
-    "@sheetom/native-linux-x64-gnu": "0.1.0-rc.9",
-    "@sheetom/native-linux-x64-musl": "0.1.0-rc.9",
-    "@sheetom/native-win32-arm64-msvc": "0.1.0-rc.9",
-    "@sheetom/native-win32-ia32-msvc": "0.1.0-rc.9",
-    "@sheetom/native-win32-x64-msvc": "0.1.0-rc.9"
+    "@sheetom/native-darwin-arm64": "0.1.0",
+    "@sheetom/native-darwin-x64": "0.1.0",
+    "@sheetom/native-linux-arm-gnueabihf": "0.1.0",
+    "@sheetom/native-linux-arm-musleabihf": "0.1.0",
+    "@sheetom/native-linux-arm64-gnu": "0.1.0",
+    "@sheetom/native-linux-arm64-musl": "0.1.0",
+    "@sheetom/native-linux-ppc64-gnu": "0.1.0",
+    "@sheetom/native-linux-s390x-gnu": "0.1.0",
+    "@sheetom/native-linux-x64-gnu": "0.1.0",
+    "@sheetom/native-linux-x64-musl": "0.1.0",
+    "@sheetom/native-win32-arm64-msvc": "0.1.0",
+    "@sheetom/native-win32-ia32-msvc": "0.1.0",
+    "@sheetom/native-win32-x64-msvc": "0.1.0"
   },
   "scripts": {
     "build": "tsdown",