@zeyos/zx 2.1.0

package/docs/llms.txt

@@ -0,0 +1,45 @@
+# Zx
+
+> Zx is the dependency-free, vanilla-JavaScript UI component library for ZeyOS business
+> applications. ES2022 modules, WAI-ARIA-accessible native
+> controls, semantic `--zx-*` design tokens with light/dark/density theming, and lifecycle-safe
+> components. Source modules run directly in the browser; a build step emits ESM, IIFE-global,
+> gx-compatibility, and CSS bundles. Zero runtime dependencies.
+
+Instantiate every component as `new Component(target, options)` where `target` is an Element, a
+selector string, or `null` (the component creates and owns its root, retrieved via `.toElement()`).
+Subscribe with `.on(type, fn)` or an `on<type>` option; handlers receive a `CustomEvent` whose
+`.detail` is an object. Call `.destroy()` to clean up. The same API is available as ESM named
+exports and as `window.zx.*`.
+
+## Documentation
+- [Documentation site](../website/docs.html): getting started, every component with a live demo and its JavaScript source, and the application layouts. Machine index: [website/llms.txt](../website/llms.txt).
+- [README](../README.md): what Zx is, quick start (ESM + global script), component index, theming, browser support, gx compat.
+- [API reference](llms.md): per-component constructor options, methods, and events for all 30+ components plus the core helpers.
+- [Skill](../.claude/skills/zx/SKILL.md): task-oriented guide — mental model, recipes, ZeyOS HTTP client, theming, gotchas, commands.
+- [Changelog](../CHANGELOG.md): what changed in each release, including behaviour changes an upgrade has to account for.
+- [Migration guide](../MIGRATION.md): gx→zx class map, script-tag replacement, deliberate behavior changes, unsupported legacy APIs.
+- [Contributor contract](../AGENTS.md): conventions for editing component source (token rules, render-time state, listeners, ARIA/APG).
+
+## Components
+- Inputs: `button()`, `buttonGroup()`, `badge()`/`badgeGroup()`, `CheckButton`, `Toggle`, `Search`, `Select` (APG combobox; `filter: false|'local'|async`), `Checklist`, `TagPicker`, `NumberField`, `Rating`, `Slider`, `copyButton()`/`CopyInput`, `DatePicker`, `MonthPicker`, `TimePicker`, `Datebox`/`DateTimeBox`, `DateRangePicker`/`DateRangeBox`, `Timebox`.
+- Overlays: `Message` (toasts/inline/progress), `Modal`, `Dialog` (+ `alert`/`confirm`/`prompt` Promises), `Dropdown`, `MenuButton`, `ContextMenu` (right-click; `selector` for per-row menus), `Tooltip`/`tooltip()`/`describe()`.
+- Data: `Table` (sortable, selectable, sticky header, opt-in inline cell/row editing via `editMode`), `DataFilter`, `Pagination` (+ pure `paginationRange()`), `TreeView` (APG tree), `Finder` (Miller columns).
+- Forms: `Form`, `Fieldset`, `Field` (type registry), `ValueList`, `MultiValueEditor`, `FieldUpload`, `Permission`.
+- Layout: `stack()`/`grid()`/`aspect()` (spacing, an intrinsically reflowing grid, a fixed-ratio box), `Groupbox`, `Panel` (header/footer action buttons), `MasterPanel`, `Tabbox` (`variant: 'divided'|'bracket'|'line'|'segmented'`), `NavigationBar`, `Toolbar` (APG toolbar with overflow menu), `SplitView`, `Stepper`, `Breadcrumb`, `emptyState()`.
+- Feedback: `spinner()` (unknown duration), `ProgressBar` (known share; determinate or indeterminate), `InlineLoading` (a wait resolving into its outcome in place), `skeleton()`/`skeletonText()`/`skeletonTable()` (placeholders shaped like the content; `aria-hidden`, set `aria-busy` on the region).
+- Core: `Component`, `h`/`icon`, `position`, `breakpoints`/`breakpointOf`/`matchBreakpoint`/`onBreakpoint` (named width bands, observed on an element or the window), `Http`/`zeyosService`, i18n, date utils, `defineElements` (declarative `<zx-*>` custom elements).
+- Helpers: `formatNumber`/`formatCurrency`/`formatPercent`/`formatFileSize`/`formatRelativeTime` (locale-aware, cached `Intl`), `debounce`/`throttle`, `groupBy`/`sortBy`/`uniqueBy`, `escapeRegExp`/`highlightMatch`, `storage()` (namespaced JSON, degrades to memory), `toCsv`/`downloadBlob`/`copyToClipboard`, `truncate()`/`isTruncated()` (line clamp with the full value on hover).
+
+## Theming
+Load `zx.css` once; set `data-zx-theme` (`light`|`dark`|`auto`) and `data-zx-density` (`cozy`|`compact`) on any ancestor. Define a product theme by overriding semantic `--zx-color-*` / `--zx-control-*` tokens under `[data-zx-theme="name"]`. Never use tier-1 palette tokens or raw color literals in application CSS.
+
+## Talking to ZeyOS
+Use the dedicated ZeyOS client library **`@zeyos/client`** (`npm install @zeyos/client`) for ZeyOS business data: `createZeyosClient({ platform, auth })`, typed `client.api.list/get/create/update<Resource>` over the full OpenAPI surface, `normalizeListResult`. It replaces the legacy `gx.zeyos.Client`/`gx.zeyos.Request`. See the `website/layouts/zeyos-invoices.layout.js` layout for a Zx-components-on-@zeyos/client reference. Zx also ships a minimal `Http`/`zeyosService` for ad-hoc in-app `remotecall`, but `@zeyos/client` is the recommended default.
+
+## Installing
+`npm install @zeyos/zx`. Entry points: `.` (components), `./zeyos` (ZeyOS binding), `./compat`
+(gx namespace), `./zx.css` (styles), `./global` (classic script tag). Docs: https://zx.zeyos.com
+
+## Commands
+`npm run serve` (no-build documentation at http://127.0.0.1:8321/website/docs.html) · `npm test` (unit + token lint) · `npm run build` (dist bundles).

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@zeyos/zx",
+  "version": "2.1.0",
+  "description": "Dependency-free, accessible UI component library for ZeyOS business applications.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://zx.zeyos.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeyos/zx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zeyos/zx/issues"
+  },
+  "keywords": [
+    "zeyos",
+    "ui",
+    "components",
+    "design-system",
+    "accessibility",
+    "wai-aria",
+    "vanilla-js",
+    "erp"
+  ],
+  "sideEffects": [
+    "*.css",
+    "./dist/zx.global.js",
+    "./dist/zx.global.min.js",
+    "./dist/zx-compat.global.js",
+    "./dist/zx-compat.global.min.js"
+  ],
+  "exports": {
+    ".": "./dist/zx.esm.js",
+    "./zeyos": "./dist/zx-zeyos.esm.js",
+    "./compat": "./dist/zx-compat.esm.js",
+    "./global": "./dist/zx.global.js",
+    "./compat-global": "./dist/zx-compat.global.js",
+    "./zx.css": "./dist/zx.css",
+    "./zx.min.css": "./dist/zx.min.css",
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/zx.esm.js",
+  "module": "./dist/zx.esm.js",
+  "style": "./dist/zx.css",
+  "files": [
+    "dist",
+    "docs/llms.md",
+    "docs/llms.txt",
+    "docs/api.json",
+    "CHANGELOG.md",
+    "README.md",
+    "MIGRATION.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "serve": "node tools/serve.js",
+    "serve:site": "SERVE_ROOT=site node tools/serve.js",
+    "build": "node tools/build.js",
+    "build:site": "node tools/build-api.js && node tools/build-site.js",
+    "test": "node --test && node tests/lint-tokens.js",
+    "prepublishOnly": "npm test && npm run build",
+    "build:api": "node tools/build-api.js"
+  },
+  "devDependencies": {
+    "esbuild": "latest"
+  }
+}