@sky.ui.ultra/core 0.0.58 → 0.0.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +120 -120
  2. package/dist/stub/index.js +2 -2
  3. package/package.json +3 -3
package/README.md CHANGED
@@ -1,120 +1,120 @@
1
- # @sky.ui.ultra/core
2
-
3
- Ultra-tier Lit web components for Sky UI. Extends the free and pro catalogs with advanced data, visualization, and workflow components.
4
-
5
- Requires an active Sky UI Ultra subscription. Install alongside `@sky.ui/core` when your app uses both tiers.
6
-
7
- ## Install
8
-
9
- ```bash
10
- npx sky.ui.ultra login
11
- npx sky.ui.ultra install
12
- ```
13
-
14
- Or install manually, then hydrate:
15
-
16
- ```bash
17
- npm install "@sky.ui.ultra/core"
18
- npx sky.ui.ultra install --framework=core
19
- ```
20
-
21
- > Quote scoped names (`"@sky.ui/…"`) — required in PowerShell. See [powershell-scoped-packages.md](https://gitlab.com/sky_ui/sky-ui/-/blob/main/docs/powershell-scoped-packages.md).
22
-
23
- For CI/CD:
24
-
25
- ```bash
26
- SKY_UI_AUTH_TOKEN=sk_ci_… npx sky.ui.ultra install --yes --framework=core
27
- ```
28
-
29
- Manage tokens on your [Sky UI account](https://sky-ui.com/account). No `.npmrc` file is required.
30
-
31
- | Token | Use |
32
- |-------|-----|
33
- | Personal (`sk_pt_…`) | Local development and MCP |
34
- | CI/CD (`sk_ci_…`) | Pipelines (`SKY_UI_AUTH_TOKEN`) |
35
-
36
- Peer dependencies include `@sky.ui/core` and `@sky.ui.pro/core`, plus the same runtime peers as free Core after hydration (`lit`, `@lit-labs/motion`, `@lit-labs/virtualizer`, `@lit/context`, `d3`, `three`). Runtime peers are required so Vite does not stub them as empty modules.
37
-
38
- ## Quick start
39
-
40
- ```js
41
- import { SkyTable, SkyFlow } from '@sky.ui.ultra/core';
42
- ```
43
-
44
- ```html
45
- <sky-table></sky-table>
46
- ```
47
-
48
- Import only the Ultra components you use for tree-shaken production bundles.
49
-
50
- Per-component paths are also supported:
51
-
52
- ```js
53
- import '@sky.ui.ultra/core/sky-table';
54
- ```
55
-
56
- ## CAD Kit (explicit opt-in)
57
-
58
- `sky-model-viewer` remains in the normal Core package. Its 130+ MB CAD runtime is downloaded only when your application explicitly imports the CAD entry point:
59
-
60
- ```js
61
- import '@sky.ui.ultra/core/sky-model-viewer';
62
- import '@sky.ui.ultra/core/sky-model-viewer/cad-kit';
63
- ```
64
-
65
- When you use an Ultra Vite, Webpack, or Rollup plugin, simply run your normal `npm run dev` or build command after adding the import. The plugin scans local source before module resolution and fetches the matching CAD payload only for that explicit import. The access token stays in the Node build process; the payload is verified against the private registry integrity value before it is installed. Set `autoHydrateCadKit: false` in the plugin options for locked-down environments, then use `npx sky.ui.ultra install` as the manual fallback. Installing `@sky.ui.ultra/core`, `@sky.ui.ultra/vue`, or `@sky.ui.ultra/react` alone does not download it.
66
-
67
- Use `@sky.ui.ultra/core/sky-model-viewer/cad-kit/single-thread` when your deployment does not use cross-origin isolation.
68
-
69
- ## Auto-import resolvers
70
-
71
- `SkyUIUltraMainVitePlugin` alone stacks **free + Pro + Ultra** Main resolvers and per-file kebab `<sky-*>` CE auto-import. You do not need a separate Free/Pro core plugin.
72
-
73
- ## Bundler plugins (Vite, Webpack, Rollup)
74
-
75
- Ultra packages mirror the free-tier plugin surface. Bundler plugins auto-import components and **validate your access token at build/dev time** (no runtime checks in shipped apps).
76
-
77
- **Vite** (`@sky.ui.ultra/core/vite`):
78
-
79
- ```js
80
- import { SkyUIUltraMainVitePlugin } from '@sky.ui.ultra/core/vite';
81
-
82
- export default {
83
- plugins: [
84
- ...SkyUIUltraMainVitePlugin({
85
- mode: 'vue', // or 'auto-import' for entry HTML/JS scan (+ CE per-file)
86
- }),
87
- ],
88
- };
89
- ```
90
-
91
- **Webpack** (`@sky.ui.ultra/core/webpack`): `SkyUIUltraMainWebpackPlugin()`
92
-
93
- **Rollup** (`@sky.ui.ultra/core/rollup`): `SkyUIUltraMainRollupPlugin({ mode: 'auto-import' })`
94
-
95
- Vue / React Ultra wrappers expose the same three bundlers at `@sky.ui.ultra/vue/vite|webpack|rollup` and `@sky.ui.ultra/react/vite|webpack|rollup`.
96
-
97
- For resolver-only setup, use `@sky.ui.ultra/core/auto-import` with `unplugin-vue-components`, alongside [`@sky.ui/core`](https://www.npmjs.com/package/@sky.ui/core) bundler plugins for free components.
98
-
99
- ## Framework wrappers
100
-
101
- | Package | Description |
102
- |---------|-------------|
103
- | [`@sky.ui.ultra/vue`](https://www.npmjs.com/package/@sky.ui.ultra/vue) | Vue 3 SFC wrappers |
104
- | [`@sky.ui.ultra/react`](https://www.npmjs.com/package/@sky.ui.ultra/react) | React wrappers |
105
-
106
- Free-tier equivalents: [`@sky.ui/vue`](https://www.npmjs.com/package/@sky.ui/vue), [`@sky.ui/react`](https://www.npmjs.com/package/@sky.ui/react).
107
-
108
- ## Custom Elements Manifest
109
-
110
- Component metadata is published at `@sky.ui.ultra/core/custom-elements.json`.
111
-
112
- ## Updates window
113
-
114
- Annual plans include one year of updates. You keep using versions released during your active window even after it ends; renew to receive newer releases.
115
-
116
- ## License
117
-
118
- [Sky UI Ultra Commercial License](https://unpkg.com/@sky.ui.ultra/core/LICENSE.md) — requires an active Sky UI Ultra subscription.
119
-
120
- Documentation: [sky-ui.com](https://sky-ui.com)
1
+ # @sky.ui.ultra/core
2
+
3
+ Ultra-tier Lit web components for Sky UI. Extends the free and pro catalogs with advanced data, visualization, and workflow components.
4
+
5
+ Requires an active Sky UI Ultra subscription. Install alongside `@sky.ui/core` when your app uses both tiers.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npx sky.ui.ultra login
11
+ npx sky.ui.ultra install
12
+ ```
13
+
14
+ Or install manually, then hydrate:
15
+
16
+ ```bash
17
+ npm install "@sky.ui.ultra/core"
18
+ npx sky.ui.ultra install --framework=core
19
+ ```
20
+
21
+ > Quote scoped names (`"@sky.ui/…"`) — required in PowerShell. See [powershell-scoped-packages.md](https://gitlab.com/sky_ui/sky-ui/-/blob/main/docs/powershell-scoped-packages.md).
22
+
23
+ For CI/CD:
24
+
25
+ ```bash
26
+ SKY_UI_AUTH_TOKEN=sk_ci_… npx sky.ui.ultra install --yes --framework=core
27
+ ```
28
+
29
+ Manage tokens on your [Sky UI account](https://sky-ui.com/account). No `.npmrc` file is required.
30
+
31
+ | Token | Use |
32
+ |-------|-----|
33
+ | Personal (`sk_pt_…`) | Local development and MCP |
34
+ | CI/CD (`sk_ci_…`) | Pipelines (`SKY_UI_AUTH_TOKEN`) |
35
+
36
+ Peer dependencies include `@sky.ui/core` and `@sky.ui.pro/core`, plus the same runtime peers as free Core after hydration (`lit`, `@lit-labs/motion`, `@lit-labs/virtualizer`, `@lit/context`, `d3`, `three`). Runtime peers are required so Vite does not stub them as empty modules.
37
+
38
+ ## Quick start
39
+
40
+ ```js
41
+ import { SkyTable, SkyFlow } from '@sky.ui.ultra/core';
42
+ ```
43
+
44
+ ```html
45
+ <sky-table></sky-table>
46
+ ```
47
+
48
+ Import only the Ultra components you use for tree-shaken production bundles.
49
+
50
+ Per-component paths are also supported:
51
+
52
+ ```js
53
+ import '@sky.ui.ultra/core/sky-table';
54
+ ```
55
+
56
+ ## CAD Kit (explicit opt-in)
57
+
58
+ `sky-model-viewer` remains in the normal Core package. Its 130+ MB CAD runtime is downloaded only when your application explicitly imports the CAD entry point:
59
+
60
+ ```js
61
+ import '@sky.ui.ultra/core/sky-model-viewer';
62
+ import '@sky.ui.ultra/core/sky-model-viewer/cad-kit';
63
+ ```
64
+
65
+ When you use an Ultra Vite, Webpack, or Rollup plugin, simply run your normal `npm run dev` or build command after adding the import. The plugin scans local source before module resolution and fetches the matching CAD payload only for that explicit import. The access token stays in the Node build process; the payload is verified against the private registry integrity value before it is installed. Set `autoHydrateCadKit: false` in the plugin options for locked-down environments, then use `npx sky.ui.ultra install` as the manual fallback. Installing `@sky.ui.ultra/core`, `@sky.ui.ultra/vue`, or `@sky.ui.ultra/react` alone does not download it.
66
+
67
+ Use `@sky.ui.ultra/core/sky-model-viewer/cad-kit/single-thread` when your deployment does not use cross-origin isolation.
68
+
69
+ ## Auto-import resolvers
70
+
71
+ `SkyUIUltraMainVitePlugin` alone stacks **free + Pro + Ultra** Main resolvers and per-file kebab `<sky-*>` CE auto-import. You do not need a separate Free/Pro core plugin.
72
+
73
+ ## Bundler plugins (Vite, Webpack, Rollup)
74
+
75
+ Ultra packages mirror the free-tier plugin surface. Bundler plugins auto-import components and **validate your access token at build/dev time** (no runtime checks in shipped apps).
76
+
77
+ **Vite** (`@sky.ui.ultra/core/vite`):
78
+
79
+ ```js
80
+ import { SkyUIUltraMainVitePlugin } from '@sky.ui.ultra/core/vite';
81
+
82
+ export default {
83
+ plugins: [
84
+ ...SkyUIUltraMainVitePlugin({
85
+ mode: 'vue', // or 'auto-import' for entry HTML/JS scan (+ CE per-file)
86
+ }),
87
+ ],
88
+ };
89
+ ```
90
+
91
+ **Webpack** (`@sky.ui.ultra/core/webpack`): `SkyUIUltraMainWebpackPlugin()`
92
+
93
+ **Rollup** (`@sky.ui.ultra/core/rollup`): `SkyUIUltraMainRollupPlugin({ mode: 'auto-import' })`
94
+
95
+ Vue / React Ultra wrappers expose the same three bundlers at `@sky.ui.ultra/vue/vite|webpack|rollup` and `@sky.ui.ultra/react/vite|webpack|rollup`.
96
+
97
+ For resolver-only setup, use `@sky.ui.ultra/core/auto-import` with `unplugin-vue-components`, alongside [`@sky.ui/core`](https://www.npmjs.com/package/@sky.ui/core) bundler plugins for free components.
98
+
99
+ ## Framework wrappers
100
+
101
+ | Package | Description |
102
+ |---------|-------------|
103
+ | [`@sky.ui.ultra/vue`](https://www.npmjs.com/package/@sky.ui.ultra/vue) | Vue 3 SFC wrappers |
104
+ | [`@sky.ui.ultra/react`](https://www.npmjs.com/package/@sky.ui.ultra/react) | React wrappers |
105
+
106
+ Free-tier equivalents: [`@sky.ui/vue`](https://www.npmjs.com/package/@sky.ui/vue), [`@sky.ui/react`](https://www.npmjs.com/package/@sky.ui/react).
107
+
108
+ ## Custom Elements Manifest
109
+
110
+ Component metadata is published at `@sky.ui.ultra/core/custom-elements.json`.
111
+
112
+ ## Updates window
113
+
114
+ Annual plans include one year of updates. You keep using versions released during your active window even after it ends; renew to receive newer releases.
115
+
116
+ ## License
117
+
118
+ [Sky UI Ultra Commercial License](https://unpkg.com/@sky.ui.ultra/core/LICENSE.md) — requires an active Sky UI Ultra subscription.
119
+
120
+ Documentation: [sky-ui.com](https://sky-ui.com)
package/dist/stub/index.js CHANGED
@@ -1,2 +1,2 @@
1
- /** Placeholder until sky.ui.ultra CLI hydrates the full package from the private registry. */
2
- export default {};
1
+ /** Placeholder until sky.ui.ultra CLI hydrates the full package from the private registry. */
2
+ export default {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sky.ui.ultra/core",
3
- "version": "0.0.58",
3
+ "version": "0.0.59",
4
4
  "description": "Sky UI Ultra web components — run npx sky.ui.ultra install after npm install.",
5
5
  "keywords": [
6
6
  "sky-ui",
@@ -28,8 +28,8 @@
28
28
  "CHANGELOG.md"
29
29
  ],
30
30
  "peerDependencies": {
31
- "@sky.ui/core": "^0.0.58",
32
- "@sky.ui.pro/core": "^0.0.58",
31
+ "@sky.ui/core": "^0.0.59",
32
+ "@sky.ui.pro/core": "^0.0.59",
33
33
  "lit": ">=3 <4"
34
34
  },
35
35
  "peerDependenciesMeta": {