@mtdt/observeops-ds-spec 0.1.0 → 0.1.1

package/AGENTS.md

@@ -84,7 +84,13 @@ block is the contract violation; composing DS parts into an undocumented screen
 
 - Real component usage: `@motadata/ui` (`M*`), Floto wrappers (`Floto*`), Ant Design Vue 1.x (`a-*`),
   `_base-*` globals — Vue 2.6.
-- Colours via `var(--token)`; layout via `MRow`/`MCol`; forms via `FlotoForm` / `FlotoFormItem`.
+- Colours via `var(--token)` (CSS custom properties — they work in any CSS block). Layout via
+  `MRow`/`MCol`; forms via `FlotoForm` / `FlotoFormItem`.
+- **Structural tokens (spacing / sizing / radius / type) are LESS `@vars`, NOT CSS vars** — they only
+  resolve in a `<style lang="less" scoped>` block (`@padding-md`, `@btn-radius`, `@text-sm`, …) or via
+  Tailwind utilities (`p-4`, `gap-2`, `text-sm`). **Do NOT hardcode `px`/`rem` in a plain `<style>`
+  block** (and don't just put the token in a comment) — use `lang="less"` + the `@var`, or a Tailwind
+  class.
 - **Cite your sources:** for each part, name the DS component / recipe / token you used (e.g.
   "list-view recipe · Organisms/Table · `--page-text-color`").
 - **Storybook is the VISUAL reference, not a data source:** the live catalogue (URL in `llms.txt`)

package/README.md

@@ -71,3 +71,9 @@ reference. It is **not** a data source; do not scrape it. The specs in this pack
 
 Semver. Minor = added components/recipes/tokens · patch = fixes/clarifications · major = breaking
 spec-shape change. Pin a version to keep AI output reproducible.
+
+## Maintaining
+
+This package is generated from the design-system sources — it is not hand-maintained file-by-file.
+Maintainers: see `PUBLISHING.md` in the design-system workspace for the build → validate → publish
+flow (bump version → `scripts/build-spec-package.js` → `scripts/validate-spec.js` → `npm publish`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtdt/observeops-ds-spec",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Machine-readable spec and AI operating contract for the Motadata ObserveOps design system — components, tokens, page recipes, layout structure, and the rules an AI tool follows to build ObserveOps UI faithfully.",
   "license": "UNLICENSED",
   "main": "index.js",

package/spec.manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "@mtdt/observeops-ds-spec",
-  "version": "0.1.0",
-  "generated": "2026-06-18T16:17:51.962Z",
+  "version": "0.1.1",
+  "generated": "2026-06-18T16:40:38.658Z",
   "entry": "llms.txt",
   "contract": "AGENTS.md",
   "index": "components/index.json",
@@ -15,13 +15,13 @@
   "files": [
     {
       "path": "AGENTS.md",
-      "bytes": 6546,
-      "sha256": "d8be4b87ca70d65e97f75a8b9d8cae07be928ec2af15ed0f3b7938f4384b7069"
+      "bytes": 7025,
+      "sha256": "ab1db8b5626c0be5be3f72fbf7e11e5342c91da475d1940784e8e7070075b773"
     },
     {
       "path": "README.md",
-      "bytes": 3476,
-      "sha256": "cdae300727bcd2a9fa8177a5bbb3f406f0ece8a9e6c2e7697d31323b5232a939"
+      "bytes": 3803,
+      "sha256": "583d53d12020fc9ad9c2fc479e9430338db2d723be53ce027fe31b1fe01c3e9a"
     },
     {
       "path": "components/index.json",
@@ -356,7 +356,7 @@
     {
       "path": "package.json",
       "bytes": 1049,
-      "sha256": "e41f71682d46fcbffb236a880259b9772acf0e958eeb5330b57057b45d4b7621"
+      "sha256": "cc5ddebef1319cd800c100ebf6618cf5209b5843a761173260ba8f89df642763"
     },
     {
       "path": "tokens/README.md",
@@ -380,8 +380,8 @@
     },
     {
       "path": "tokens/purpose-map.json",
-      "bytes": 6096,
-      "sha256": "3f114a1444e4579cc67c30ae3716fbe2f452a61985f0f3dbec50f35494dd8781"
+      "bytes": 6343,
+      "sha256": "e3e38296c2e5a4c21fb127c9b9207222f20550a5efc7929347e44ec5359be0b9"
     },
     {
       "path": "tokens/semantic.dark.json",

package/tokens/purpose-map.json

@@ -57,7 +57,7 @@
     }
   },
   "structural": {
-    "$note": "LESS @vars (structural.json) — compile-time, not themed.",
+    "$note": "LESS @vars (structural.json) — compile-time, not themed. These are NOT CSS custom properties: emit them via <style lang=\"less\" scoped> (e.g. @padding-md) or Tailwind utilities (p-4, gap-2, text-sm). NEVER inline the raw px/rem value in a plain <style> block (a comment naming the token is not enough).",
     "spacing": { "@padding-lg": "24px", "@padding-md": "16px (default form gutter)", "@padding-sm": "12px", "@padding-xs": "8px" },
     "sizing": { "@input-height-base": "32px", "@btn-height": "2.1rem", "@header-height": "55px", "@nav-icon-width": "50px", "@navbar-height": "50px", "@search-height": "36px" },
     "radius": { "$note": "The DS has NO @border-radius-base — use @btn-radius for ALL general radius (cards, modals, inputs, chips), not just buttons.", "@btn-radius": "4px (the general-purpose default radius, app-wide)", "@btn-raidus-full": "150px (pill; note the source typo 'raidus' is the real token name)" },