@sky.ui/core 0.0.1

package/LICENSE.md

@@ -0,0 +1,139 @@
+# Sky UI Free End User License Agreement (EULA)
+
+Version 1.0  
+Effective Date: 2026-06-24
+
+This End User License Agreement ("EULA") governs the use of the free tier of Sky UI,
+including the packages published as `@sky.ui/core`, `@sky.ui/react`, `@sky.ui/vue`,
+`@sky.ui/reactivity`, `@sky.ui/utils`, `@sky.ui/mcp`, related VS Code extensions,
+their compiled distributions, documentation, examples, and related materials.
+
+Sky UI is **not** open source. Licensor does **not** grant access to source code
+through this EULA.
+
+By installing, copying, accessing, or using the Software, you agree to this EULA.
+
+## 1. Definitions
+
+"Licensor" means Desai Software.
+
+"User" means the person, company, or organization that installs or uses the
+Software.
+
+"Software" means the free-tier Sky UI component library and related materials made
+available by Licensor, including compiled package files, type definitions,
+documentation, and examples. **Software does not include source code** unless
+Licensor expressly provides it in a separate written agreement.
+
+"Project" means a website, application, SaaS product, internal tool, or other
+software product built by User using the Software.
+
+## 2. License Grant
+
+Subject to compliance with this EULA, Licensor grants User a limited,
+non-exclusive, non-transferable, non-sublicensable license to:
+
+1. install the Software from an official distribution channel authorized by Licensor;
+2. import and use the Software in User's Projects;
+3. bundle compiled output of the Software as part of User's Projects;
+4. use the Software in development, testing, staging, production, and CI/CD
+   environments.
+
+No other rights are granted.
+
+## 3. Permitted Usage
+
+User may use the Software to build commercial and non-commercial Projects.
+
+User may deploy Projects that include bundled output from the Software to end users,
+provided that end users cannot extract, install, or reuse the Software as a
+standalone component library.
+
+## 4. Restrictions
+
+User may not:
+
+1. obtain, copy, publish, distribute, sublicense, sell, rent, lease, or otherwise
+   make available the **source code** of the Software, whether from this repository,
+   package tarballs, build artifacts, or any other channel, except where expressly
+   permitted in writing by Licensor;
+2. redistribute, republish, or publicly share the Software as a standalone package
+   or UI kit;
+3. upload the Software to a public npm registry, public GitHub repository, public
+   CDN, file-sharing service, torrent, or any other public distribution channel
+   except through official channels operated or authorized by Licensor;
+4. remove or modify copyright notices, license notices, or proprietary notices;
+5. use the Software to create a directly competing component library, template
+   marketplace, UI kit, design system package, or component generator;
+6. reverse engineer, decompile, or disassemble the Software except where applicable
+   law expressly prohibits this restriction;
+7. imply that the Software is open source, MIT-licensed, or freely redistributable
+   source code.
+
+## 5. No Source Code
+
+Unless Licensor provides source code under a separate written agreement, User
+receives only compiled distributions and related published materials. User has no
+right to inspect, modify, fork, or redistribute Sky UI source code.
+
+## 6. Ownership
+
+Licensor retains all rights, title, and interest in and to the Software, including
+copyrights, trademarks, trade secrets, and other intellectual property rights.
+
+No ownership rights are transferred to User.
+
+All rights not expressly granted in this EULA are reserved by Licensor.
+
+## 7. Third-Party Dependencies
+
+The Software may depend on third-party open-source packages. Those third-party
+packages are licensed under their own license terms.
+
+This EULA applies only to Licensor's proprietary Sky UI Software and does not
+change the license terms of third-party dependencies.
+
+## 8. Feedback
+
+If User provides ideas, feedback, suggestions, bug reports, or feature requests,
+Licensor may use them without restriction and without obligation to pay User.
+
+## 9. Termination
+
+This EULA terminates automatically if User violates it.
+
+Upon termination, User must stop installing, copying, updating, and using the
+Software.
+
+## 10. No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND,
+WHETHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE.
+
+LICENSOR DISCLAIMS ALL WARRANTIES, INCLUDING MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, TITLE, NON-INFRINGEMENT, SECURITY, RELIABILITY, AND
+AVAILABILITY.
+
+## 11. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, LICENSOR WILL NOT BE LIABLE FOR ANY
+INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES,
+INCLUDING LOSS OF PROFITS, REVENUE, DATA, GOODWILL, OR BUSINESS OPPORTUNITY.
+
+LICENSOR'S TOTAL LIABILITY ARISING OUT OF OR RELATING TO THE SOFTWARE WILL NOT
+EXCEED ONE HUNDRED U.S. DOLLARS (USD $100).
+
+## 12. Governing Law
+
+This EULA is governed by the laws of India, without regard to conflict-of-law
+rules.
+
+Any disputes will be resolved in the courts located in Gujarat, India, unless
+applicable law requires otherwise.
+
+## 13. Contact
+
+For licensing questions, contact:
+
+Desai Software  
+https://gitlab.com/sky_ui/sky-ui/-/issues

package/README.md

@@ -0,0 +1,113 @@
+# @sky.ui/core
+
+Lit-based web components for Sky UI. Use tags such as `<sky-button>` and `<sky-card>` in any framework, or import components directly for tree-shaken bundles.
+
+## Install
+
+```bash
+npm install @sky.ui/core
+```
+
+Peer dependencies (install as needed for the components you use): `lit`, and optionally `@lit-labs/motion`, `@lit-labs/virtualizer`, `@lit/context`, `d3`, `three`.
+
+## Quick start
+
+```js
+import { SkyButton, SkyCard } from '@sky.ui/core';
+```
+
+Register or render components in your app. In HTML:
+
+```html
+<sky-button label="Save"></sky-button>
+```
+
+Only the components you import are included in production bundles when your bundler tree-shakes ESM.
+
+## Tree-shaking
+
+- Published as **ESM** with **one file per component** (`preserveModules`).
+- Import from the package root or per-component paths (`@sky.ui/core/sky-button`).
+- Use a **production build** (`vite build`, `nuxt build`, webpack production) so unused exports are dropped. Dev servers may include more for faster HMR.
+
+## Vite
+
+```js
+import { SkyUIMainVitePlugin } from '@sky.ui/core/vite';
+
+export default {
+  plugins: [
+    // Vue: auto-import <SkyButton> / <sky-button> (requires unplugin-vue-components)
+    SkyUIMainVitePlugin(), // or SkyUIMainVitePlugin({ mode: 'vue' })
+
+    // Framework-less HTML/JS: scan for <sky-*> and inject imports
+    // SkyUIMainVitePlugin({ mode: 'auto-import' })
+
+    // Whole library: SkyUIMainVitePlugin({ mode: 'auto-import', treeShake: false })
+  ],
+};
+```
+
+**Vue auto-import:** install `unplugin-vue-components`. Options include `resolverOptions`, `dts`, and `componentsOptions`.
+
+**Resolver only:** `import { SkyUIMainResolver } from '@sky.ui/core/auto-import'`.
+
+For Vue SFC wrappers or React, use `@sky.ui/vue` or `@sky.ui/react` instead.
+
+## Webpack and Rollup
+
+**Webpack**
+
+```js
+import { SkyUIMainWebpackPlugin } from '@sky.ui/core/webpack';
+
+export default {
+  plugins: [SkyUIMainWebpackPlugin()],
+};
+```
+
+**Rollup** (returns an array — spread into `plugins`):
+
+```js
+import { SkyUIMainRollupPlugin } from '@sky.ui/core/rollup';
+
+export default {
+  plugins: [
+    ...SkyUIMainRollupPlugin(),
+    // auto-import: ...SkyUIMainRollupPlugin({ mode: 'auto-import', entryHtml: 'index.html' }),
+  ],
+};
+```
+
+## Manual and full-library imports
+
+```js
+import { SkyButton, SkyCard } from '@sky.ui/core';
+import '@sky.ui/core/sky-button';
+
+// Entire catalog
+import '@sky.ui/core/all';
+import * as Sky from '@sky.ui/core';
+```
+
+## Custom Elements Manifest
+
+After building from source, component metadata is available at `@sky.ui/core/custom-elements.json`.
+
+## Related packages
+
+| Package | Use when |
+|---------|----------|
+| [`@sky.ui/vue`](https://www.npmjs.com/package/@sky.ui/vue) | Vue 3 SFC wrappers |
+| [`@sky.ui/react`](https://www.npmjs.com/package/@sky.ui/react) | React wrappers |
+| [`@sky.ui/utils`](https://www.npmjs.com/package/@sky.ui/utils) | Utility CSS and PostCSS JIT |
+| [`@sky.ui/reactivity`](https://www.npmjs.com/package/@sky.ui/reactivity) | Lightweight reactivity and template directives |
+| [`@sky.ui.pro/core`](https://www.npmjs.com/package/@sky.ui.pro/core) | Pro-tier components |
+
+## Editor support
+
+Install the **Sky UI Components** VS Code extension for completions, hover docs, and validation in HTML, Vue, and JSX.
+
+## License
+
+[Sky UI Free EULA](./LICENSE.md) — proprietary; not open source.

package/auto-import-loader.js

@@ -0,0 +1,60 @@
+/**
+ * Webpack loader for @sky.ui/core auto-import: scans entry JS (and optional HTML) for <sky-*>
+ * and prepends the corresponding import statements. Use only on the entry file.
+ *
+ * Options: { packageName?: string, entryHtml?: string }
+ * @example
+ *   rules: [{ test: /main\.js$/, use: [{ loader: '@sky.ui/core/auto-import-loader', options: { entryHtml: 'index.html' } }] }]
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TAG_RE = /<(sky-[a-z][a-z0-9]*(?:-[a-z0-9]+)*)|['"`](sky-[a-z][a-z0-9]*(?:-[a-z0-9]+)*)['"`]/gi;
+
+function extractUsedTagNames(content, tagNamesSet) {
+  const used = new Set();
+  let m;
+  TAG_RE.lastIndex = 0;
+  while ((m = TAG_RE.exec(content)) !== null) {
+    const tag = (m[1] || m[2] || '').toLowerCase();
+    if (tagNamesSet.has(tag)) used.add(tag);
+  }
+  return used;
+}
+
+export default async function SkyUIMainAutoImportLoader(source, map, meta) {
+  const callback = this.async();
+  const options = this.getOptions() || {};
+  const packageName = options.packageName ?? '@sky.ui/core';
+  const entryHtml = options.entryHtml ?? 'index.html';
+
+  try {
+    const autoImportPath = path.resolve(__dirname, 'auto-import.js');
+    const { SKY_UI_TAG_NAMES } = await import(pathToFileURL(autoImportPath).href);
+    const tagNamesSet = SKY_UI_TAG_NAMES;
+
+    let used = extractUsedTagNames(source, tagNamesSet);
+
+    const htmlPath = path.resolve(this.context, '..', entryHtml);
+    if (fs.existsSync(htmlPath)) {
+      const html = fs.readFileSync(htmlPath, 'utf-8');
+      extractUsedTagNames(html, tagNamesSet).forEach((t) => used.add(t));
+    }
+
+    if (used.size === 0) {
+      return callback(null, source, map, meta);
+    }
+
+    const imports = [...used]
+      .sort()
+      .map((tag) => `import '${packageName}/${tag}';`)
+      .join('\n');
+    const out = `/** Auto-imported by @sky.ui/core (only used components) */\n${imports}\n\n${source}`;
+    callback(null, out, map, meta);
+  } catch (err) {
+    callback(err);
+  }
+}

package/auto-import.js

@@ -0,0 +1,93 @@
+/**
+ * Scan-based auto-import for @sky.ui/core (unplugin-vue-components).
+ * Auto-generated by scripts/generate-packages.js – do not edit the array by hand.
+ */
+
+const SKY_UI_COMPONENTS = [
+  'SkyAccordion',
+  'SkyAccordionItem',
+  'SkyAlert',
+  'SkyAppbar',
+  'SkyAvatar',
+  'SkyBadge',
+  'SkyBreadcrumb',
+  'SkyButton',
+  'SkyButtonGroup',
+  'SkyCard',
+  'SkyCarousel',
+  'SkyCheckbox',
+  'SkyChip',
+  'SkyCol',
+  'SkyCombobox',
+  'SkyCounter',
+  'SkyDialog',
+  'SkyDivider',
+  'SkyDrawer',
+  'SkyDropdown',
+  'SkyDropdownItem',
+  'SkyFlexbar',
+  'SkyFlexbox',
+  'SkyFlexcol',
+  'SkyFlexitem',
+  'SkyForm',
+  'SkyGrid',
+  'SkyIcon',
+  'SkyImage',
+  'SkyInput',
+  'SkyList',
+  'SkyListitem',
+  'SkyNavbar',
+  'SkyNavpanel',
+  'SkyNotification',
+  'SkyOtp',
+  'SkyOverlay',
+  'SkyPagination',
+  'SkyProgress',
+  'SkyRadio',
+  'SkyRadioGroup',
+  'SkyRange',
+  'SkyRow',
+  'SkySerial',
+  'SkySheet',
+  'SkySkeleton',
+  'SkySlider',
+  'SkySpeeddial',
+  'SkySpinner',
+  'SkySteps',
+  'SkySwitch',
+  'SkyTab',
+  'SkyTabButton',
+  'SkyThemeProvider',
+  'SkyThemeSwitcher',
+  'SkyTooltip',
+];
+
+const SET = new Set(SKY_UI_COMPONENTS);
+
+export function isSkyUIComponent(name) {
+  return SET.has(name);
+}
+
+/**
+ * Resolver for unplugin-vue-components (imports from @sky.ui/core custom elements).
+ * @param {{ packageName?: string }} [options]
+ */
+export function SkyUIMainResolver(options = {}) {
+  const packageName = options.packageName ?? '@sky.ui/core';
+  return (componentName) => {
+    if (!SET.has(componentName)) return;
+    return { name: componentName, from: packageName };
+  };
+}
+
+/** Kebab-case custom element tags for framework-less auto-import scanners. */
+export const SKY_UI_TAG_NAMES = new Set(
+  SKY_UI_COMPONENTS.map((name) =>
+    name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/^Sky/, 'sky-').toLowerCase(),
+  ),
+);
+
+/** Subpath import for a tag used by Vite/Rollup auto-import plugins. */
+export function getCoreImportPath(tag, packageName = '@sky.ui/core') {
+  return `${packageName}/${tag}`;
+}