Release Token Tools 0.1.0

public/README.md

@@ -0,0 +1,45 @@
+# Token Tools
+
+Edit, validate and export design tokens locally in the browser. Token Tools supports plain W3C-style nested JSON and a local multi-set wrapper using `$sets` plus ordered `$themes`.
+
+## Features
+
+- Bounded nested JSON editor and a focused path/type/value editor.
+- Set composition with later-set overrides and theme previews.
+- `{path.to.token}` alias resolution, missing-target errors, cycle detection and type warnings.
+- Color, dimension, typography, shadow, number, string and boolean validation.
+- W3C-style JSON, CSS custom properties, Sass, Android XML and Swift/UIKit exports.
+- Target-safe string escaping, identifier-collision detection and a loss report that never silently drops unsupported composite semantics.
+- Offline PWA and shared system/light/dark Toolbox shell.
+
+## Document shape
+
+A plain nested object is treated as the `default` set. For themes:
+
+```json
+{
+  "$sets": { "core": {}, "dark": {} },
+  "$themes": { "light": ["core"], "dark": ["core", "dark"] }
+}
+```
+
+Each token uses `$type` and `$value`; group `$type` values are inherited. This is a practical W3C-style interchange, while `$sets` and `$themes` are an application wrapper rather than a claim of W3C standardization.
+
+## Limits
+
+Documents are capped at 1 MiB, depth 64 and 10,000 tokens (with a 50,000 JSON-node parsing bound). Malformed wrappers, unknown declared types and token/group shape conflicts fail explicitly. No imported value is executed. Android and Swift composite output needs project conventions, so unsupported values are omitted with explicit losses.
+
+## Development
+
+```sh
+npm ci
+npm run check
+npm run test:browser
+npm run package:release -- --force
+```
+
+The deterministic release is `release/token-tools-0.1.0.zip` with a SHA-256 sidecar. Node.js 22+ and npm 11 are required.
+
+## Licence
+
+GPL-3.0-or-later.