@astryx-vue/lab 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 astryx-vue contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @astryx-vue/lab
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vue 3 ports of the Astryx lab components (`@astryxdesign/lab`). This is an unofficial port, not affiliated with Meta.
+
+**This package is canary-only.** Its `package.json` carries `"publishConfig": { "tag": "canary" }` plus `"astryxVue": { "canaryOnly": true }`, so it publishes to the npm `canary` dist-tag only — there is no stable release. Lab components are experiments: their props and markup can change or disappear in any canary build.
+
+## Install
+
+```bash
+pnpm add @astryx-vue/lab@canary @astryx-vue/core vue
+```
+
+Each component imports its own stylesheet, so a bundler that understands `import './x.css'` is enough. If you prefer loading everything at once, import the package stylesheet once:
+
+```js
+import '@astryx-vue/lab/lab.css'
+```
+
+Or pick single files: `@astryx-vue/lab/styles/stat.css`, `.../log-stream.css`, and so on.
+
+## Components
+
+| Component | What it is |
+| --- | --- |
+| `Stat` | KPI/metric display: label, big tabular value, optional sentiment-aware delta, description, trend slot. |
+| `CircularProgress` | Ring-shaped progress indicator, determinate or indeterminate. |
+| `InfoTip` | Small "i" button that reveals a tooltip on hover, keyboard focus, and tap. |
+| `SVGIcon` | CSS-variable-driven SVG icon with variations (linear, bold, twotone, bulk, broken), path roles, and mask-based gaps. |
+| `LogStream` | Streaming log viewer with level accents, expandable detail rows, follow-scroll tailing, and a terminal variant. |
+| `ListInput` | Editable records with custom input columns, validation, and reordering. |
+| `MobileTokenizer` | Touch-friendly multi-select with search and creation in a bottom sheet. |
+| `TransferList` | Dual-panel selection with search, grouping, and reordering. |
+
+## Documentation
+
+See the [Lab documentation](https://astryx-vue.pages.dev/lab/) for bilingual guides, prop tables, and interactive examples.

package/css.d.ts

@@ -0,0 +1,3 @@
+declare const stylesheet: string
+
+export default stylesheet