polyxd 0.2.2 → 0.4.0

package/NOTICE

@@ -135,6 +135,51 @@ Upstream: https://github.com/adobe/spectrum-tokens
 
 Vendored under `packages/ds-spectrum/scripts/sources/`, with the upstream licence file beside it.
 
+## Logos
+
+Twelve packs ship their design system's official logo, unaltered, as `logo.svg`
+(Bootstrap and Radix also ship the owner's white version as `logo-white.svg`),
+downloaded from the owner's own site, repository or brand page. Where a design
+system has no mark of its own (Polaris, Spectrum, Primer), the pack ships its
+company's logo. Each is used only to identify the design system a pack is
+modelled on, beside its name. The logos are trademarks of their owners, not
+Polyxd's, and are not covered by Polyxd's licence:
+
+- Material 3 (`@polyxd/ds-material3`) — Google LLC
+- Carbon (`@polyxd/ds-carbon`) — IBM Corp.
+- Fluent 2 (`@polyxd/ds-fluent`) — Microsoft Corporation
+- Polaris (`@polyxd/ds-polaris`) — the Shopify logo, Shopify Inc.
+- Spectrum 2 (`@polyxd/ds-spectrum`) — the Adobe logo, Adobe Inc.
+- Primer (`@polyxd/ds-primer`) — the GitHub logo, GitHub, Inc.
+- shadcn/ui (`@polyxd/ds-shadcn`) — shadcn
+- Ant Design (`@polyxd/ds-antd`) — Ant Group
+- Bootstrap (`@polyxd/ds-bootstrap`) — the Bootstrap team
+- Chakra UI (`@polyxd/ds-chakra`) — Chakra Systems Inc.
+- Mantine (`@polyxd/ds-mantine`) — Vitaly Rtishchev
+- Radix UI (`@polyxd/ds-radix`) — WorkOS
+
+Google, IBM, Microsoft, Shopify, Adobe and GitHub restrict the use of their
+logos without permission; each pack's manifest (`logo`) and README record the
+source and the owner's guidelines. GOV.UK's crown and logotype are protected and
+may not be used by a service that is not on GOV.UK, so `@polyxd/ds-govuk` ships
+no logo and is named in words only.
+
+The twelve template packs' `logo.svg` files are Polyxd's own marks, drawn from
+each template's tokens.
+
+## Template packs
+
+Twelve packs are original Polyxd templates, not readings of any design system:
+`@polyxd/ds-sketch`, `@polyxd/ds-wireframe`, `@polyxd/ds-editorial`,
+`@polyxd/ds-brutalist`, `@polyxd/ds-glass`, `@polyxd/ds-terminal`,
+`@polyxd/ds-pastel`, `@polyxd/ds-civic`, `@polyxd/ds-finance`,
+`@polyxd/ds-health`, `@polyxd/ds-neon` and `@polyxd/ds-mono`. Every value in
+them was chosen for the template, they vendor nothing, and they are Apache-2.0
+like the rest of Polyxd. The typefaces some of them name (Caveat, Patrick Hand,
+Fraunces, Nunito, JetBrains Mono, Space Grotesk) are under the SIL Open Font
+License and are loaded from Google Fonts by the page that uses them, never
+distributed here.
+
 ## Specification
 
 ### A2UI

package/README.md

@@ -4,8 +4,11 @@
 npx polyxd pack ./src/tokens.css     # a Polyxd pack from your design system's tokens
 npx polyxd check ./ds-acme/manifest.json
 POLYXD_STUDIO_KEY=… npx polyxd studio push ./ --to https://studio.polyxd.com/api/w/acme
+npx polyxd dev ./screens             # preview the documents in a folder as you edit them
 ```
 
 `pack` reads your CSS custom properties (or a DTCG JSON file), maps what it can onto Polyxd's semantic token contract, and writes a pack plus a mapping file recording every guess. It reports what's still missing and any of your own colour pairs that fail contrast. `check` validates a pack against the contract. `studio push` sends a token package (packed with npm, so private registries never matter), a tarball or a single token file to Polyxd Studio as a new version of your design system; made for a CI step on every release, with an API key from Studio's Team page.
 
+`dev` watches a folder of documents and serves a page that renders the selected one with the real renderer in any built-in pack (or yours, with `--pack`), light or dark, phone to desktop, with the static check, the document, its data and the actions it dispatches beside it; it reloads in place on save. `--verify` adds a button that runs the full verifier when `@polyxd/verifier` is installed.
+
 [How it guesses](https://polyxd.com/docs/your-design-system/) · [Polyxd](https://polyxd.com) · [Source](https://github.com/visualfart/polyxd)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polyxd",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "The polyxd command: make a Polyxd design-system pack from your own tokens, and check it against the contract",
   "license": "Apache-2.0",
   "type": "module",
@@ -14,7 +14,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@polyxd/ds-kit": "^0.2.2"
+    "@polyxd/ds-kit": "^0.4.0"
   },
   "repository": {
     "type": "git",