@sky.ui.pro/react 0.0.1

package/LICENSE.md

@@ -0,0 +1,212 @@
+# Sky UI Pro Commercial License
+
+Version 1.0  
+Effective Date: 2026-06-24
+
+This Commercial License governs the use of the Pro version of Sky UI, including
+the packages published as `@sky.ui.pro/core`, `@sky.ui.pro/react`,
+`@sky.ui.pro/vue`, their source code, compiled code, documentation, examples,
+and related materials.
+
+By installing, copying, accessing, or using Sky UI Pro, you agree to this
+Commercial License.
+
+## 1. Definitions
+
+"Licensor" means Desai Software.
+
+"Customer" means the person, company, or organization that has purchased or
+received a valid license to use Sky UI Pro.
+
+"Software" means the Sky UI Pro component library, including source code,
+compiled code, package files, documentation, examples, and updates.
+
+"Subscription" means an active paid plan purchased from Licensor through
+Razorpay or another approved payment method.
+
+"Authorized Users" means Customer's employees, contractors, or team members
+who are allowed to access and use the Software on Customer's behalf.
+
+"Project" means a website, application, SaaS product, internal tool, or other
+software product built by Customer using the Software.
+
+## 2. License Grant
+
+Subject to an active Subscription and compliance with this Commercial License,
+Licensor grants Customer a limited, non-exclusive, non-transferable,
+non-sublicensable license to:
+
+1. install and use the Software;
+2. import and use the Software in Customer's Projects;
+3. bundle compiled output of the Software as part of Customer's Projects;
+4. use the Software in development, testing, staging, production, and CI/CD
+   environments;
+5. allow Authorized Users to use the Software on Customer's behalf.
+
+## 3. Permitted Usage
+
+Customer may use Sky UI Pro to build commercial and non-commercial Projects.
+
+Customer may deploy Projects that include bundled output from Sky UI Pro to
+end users, provided that end users cannot extract, install, or reuse Sky UI Pro
+as a standalone component library.
+
+Customer may use the Software for client work only if Customer's Subscription
+allows agency, freelance, or client-project usage.
+
+## 4. Restrictions
+
+Customer may not:
+
+1. sell, resell, rent, lease, sublicense, redistribute, publish, or publicly
+   share the Software as a standalone package;
+2. upload the Software to a public npm registry, public GitHub repository,
+   public CDN, file-sharing service, torrent, or any other public distribution
+   channel;
+3. share private registry tokens, GitHub access, license keys, or package
+   access with unauthorized users;
+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. bypass, disable, tamper with, or remove license validation, access control,
+   telemetry used for license enforcement, or subscription checks;
+8. use the Software after Subscription cancellation, expiration, chargeback,
+   refund, or failed payment, except as expressly allowed in writing by Licensor.
+
+## 5. Subscription and Payment
+
+Access to Sky UI Pro requires an active paid Subscription unless Licensor has
+granted written permission otherwise.
+
+If payment fails, is refunded, disputed, charged back, cancelled, or expires,
+Licensor may suspend or revoke access to the Software.
+
+Customer is responsible for keeping billing information accurate and up to date.
+
+## 6. License Keys and Access Tokens
+
+License keys, private registry tokens, GitHub tokens, activation codes, and
+download credentials are confidential.
+
+Customer must not expose these credentials in public repositories, frontend
+bundles, public logs, support tickets, screenshots, or shared documents.
+
+Customer is responsible for all activity performed using Customer's credentials.
+
+If a credential is leaked, Customer must notify Licensor and rotate the
+credential as soon as reasonably possible.
+
+## 7. Contractors and Team Members
+
+Customer may allow contractors, freelancers, employees, and team members to
+use the Software only for Customer's permitted Projects.
+
+Customer is responsible for ensuring that all Authorized Users comply with
+this Commercial License.
+
+When an Authorized User no longer works on Customer's Projects, Customer must
+remove that user's access.
+
+## 8. Updates
+
+During an active Subscription, Customer may receive updates, bug fixes, and new
+versions of the Software if Licensor makes them available.
+
+Licensor may modify, improve, deprecate, or remove features in future versions.
+
+This license does not guarantee any specific update schedule, roadmap, support
+level, or feature availability unless separately agreed in writing.
+
+## 9. Other Sky UI Packages and Third-Party Dependencies
+
+The Software may depend on free-tier Sky UI packages (`@sky.ui/core`,
+`@sky.ui/react`, `@sky.ui/vue`, and related packages). Those packages are
+proprietary and governed by the Sky UI Free EULA, not an open-source license.
+
+The Software may also include or depend on third-party open-source packages.
+Those third-party packages are licensed under their own license terms.
+
+This Commercial License applies only to Licensor's proprietary Sky UI Pro
+Software and does not change the license terms of other Sky UI packages or
+third-party dependencies.
+
+## 10. 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 Customer.
+
+All rights not expressly granted in this Commercial License are reserved by
+Licensor.
+
+## 11. Feedback
+
+If Customer provides ideas, feedback, suggestions, bug reports, or feature
+requests, Licensor may use them without restriction and without obligation to
+pay Customer.
+
+## 12. Termination
+
+This license terminates automatically if Customer violates this Commercial
+License or no longer has an active Subscription.
+
+Upon termination, Customer must stop installing, copying, updating, and using
+the Software.
+
+Customer may continue to operate already-deployed Projects only if:
+
+1. the Software is not exposed as a reusable standalone library;
+2. Customer does not continue development using the Software;
+3. Customer has not violated the redistribution, sublicensing, or bypass
+   restrictions in this license.
+
+Licensor may require Customer to remove the Software from active Projects if
+Customer materially breaches this license.
+
+## 13. 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.
+
+## 14. 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 THE AMOUNT PAID BY CUSTOMER FOR THE SOFTWARE DURING THE THREE MONTHS
+BEFORE THE CLAIM AROSE.
+
+## 15. Indemnity
+
+Customer agrees to indemnify and hold Licensor harmless from claims, damages,
+losses, liabilities, costs, and expenses arising from:
+
+1. Customer's breach of this Commercial License;
+2. Customer's unauthorized redistribution of the Software;
+3. Customer's Projects;
+4. Customer's misuse of license keys, tokens, or package access.
+
+## 16. Governing Law
+
+This Commercial License 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.
+
+## 17. Contact
+
+For licensing questions, contact:
+
+Desai Software  
+https://gitlab.com/sky_ui/sky-ui/-/issues

package/README.md

@@ -0,0 +1,47 @@
+# @sky.ui.pro/react
+
+Pro-tier React wrappers for Sky UI. Includes advanced components such as data tables, flow editors, and rich inputs.
+
+Requires an active Sky UI Pro subscription.
+
+## Install
+
+```bash
+npx sky.ui.pro login
+npm install @sky.ui.pro/react @sky.ui.pro/core @sky.ui/core @sky.ui/react
+```
+
+For CI/CD, set `SKY_UI_AUTH_TOKEN` before `npm ci`. See [`@sky.ui.pro/core`](https://www.npmjs.com/package/@sky.ui.pro/core) for token details.
+
+## Quick start
+
+```jsx
+import { SkyTable } from '@sky.ui.pro/react';
+
+export function App() {
+  return <SkyTable />;
+}
+```
+
+## Auto-import
+
+Use `@sky.ui.pro/react/auto-import` resolvers with `unplugin-react-components`, combined with your existing `@sky.ui/react` Vite or Webpack setup.
+
+See the [`@sky.ui/react` README](https://www.npmjs.com/package/@sky.ui/react) for plugin configuration — import Pro components from `@sky.ui.pro/react` in manual imports or extend your resolver configuration for Pro tags.
+
+## Manual imports
+
+```jsx
+import { SkyTable, SkyFlow } from '@sky.ui.pro/react';
+```
+
+## Related packages
+
+| Package | Description |
+|---------|-------------|
+| [`@sky.ui.pro/core`](https://www.npmjs.com/package/@sky.ui.pro/core) | Pro Lit components (required) |
+| [`@sky.ui/react`](https://www.npmjs.com/package/@sky.ui/react) | Free-tier React wrappers |
+
+## License
+
+[Sky UI Pro Commercial License](./LICENSE.md) — requires an active Sky UI Pro subscription.

package/dist/stub/index.js

@@ -0,0 +1,2 @@
+/** Placeholder until postinstall hydrates the full package from the private registry. */
+export default {};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@sky.ui.pro/react",
+  "version": "0.0.1",
+  "description": "Sky UI Pro React wrappers — installs full package via postinstall (online license).",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "main": "./dist/stub/index.js",
+  "exports": {
+    ".": "./dist/stub/index.js"
+  },
+  "files": [
+    "scripts/postinstall.mjs",
+    "dist/stub",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs"
+  },
+  "dependencies": {
+    "tar": "^7.4.3"
+  },
+  "peerDependencies": {
+    "@sky.ui/core": "^0.0.1",
+    "@sky.ui/react": "^0.0.1",
+    "@sky.ui.pro/core": "^0.0.1"
+  },
+  "skyUiPro": {
+    "apiBase": "https://library.sky-ui.com",
+    "artifactRegistry": "gitlab"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+/**
+ * Downloads the full @sky.ui.pro/* artifact from the Sky UI npm proxy (GitLab upstream).
+ * Install flow matches HeroUI Pro: cache restore → else license-checked download; failed auth
+ * does not remove artifacts already on disk.
+ */
+import { createWriteStream } from "node:fs";
+import { access, cp, mkdir, mkdtemp, readdir, readFile, rm } from "node:fs/promises";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { pipeline } from "node:stream/promises";
+import { extract } from "tar";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(scriptDir, "..");
+const SKY_UI_HOME = join(homedir(), ".sky.ui");
+const LEGACY_SKY_UI_HOME = join(homedir(), ".sky-ui");
+const cacheRoot = join(SKY_UI_HOME, "cache");
+const legacyCacheRoot = join(LEGACY_SKY_UI_HOME, "cache");
+
+async function exists(p) {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readJson(p) {
+  return JSON.parse(await readFile(p, "utf8"));
+}
+
+function packageSlug(name) {
+  return name.replace(/^@/, "").replace("/", "-");
+}
+
+function cacheVersionDir(root, slug, version) {
+  return join(root, slug, version);
+}
+
+async function copyDirectoryContents(src, dest) {
+  await mkdir(dest, { recursive: true });
+  for (const entry of await readdir(src, { withFileTypes: true })) {
+    await cp(join(src, entry.name), join(dest, entry.name), { recursive: true, force: true });
+  }
+}
+
+/** Drop cached versions other than the one being installed (HeroUI cache policy). */
+async function enforceCachePolicy(slug, version) {
+  const slugDir = join(cacheRoot, slug);
+  if (!(await exists(slugDir))) return;
+  for (const entry of await readdir(slugDir, { withFileTypes: true })) {
+    if (entry.name === version || entry.name === ".gitignore") continue;
+    await rm(join(slugDir, entry.name), { recursive: true, force: true });
+  }
+}
+
+async function restoreFromCache(slug, version, target) {
+  for (const root of [cacheRoot, legacyCacheRoot]) {
+    const src = cacheVersionDir(root, slug, version);
+    if (!(await exists(src))) continue;
+    const entries = await readdir(src);
+    if (entries.length === 0) continue;
+    await copyDirectoryContents(src, target);
+    return true;
+  }
+  return false;
+}
+
+async function saveToCache(slug, version, source) {
+  const dest = cacheVersionDir(cacheRoot, slug, version);
+  await rm(dest, { recursive: true, force: true });
+  await mkdir(dest, { recursive: true });
+  await copyDirectoryContents(source, dest);
+}
+
+async function resolveToken() {
+  const envCi = process.env.SKY_UI_AUTH_TOKEN?.trim();
+  if (envCi) return envCi;
+  const envPersonal = process.env.SKY_UI_PERSONAL_TOKEN?.trim();
+  if (envPersonal) return envPersonal;
+  for (const credPath of [
+    join(SKY_UI_HOME, "credentials.json"),
+    join(LEGACY_SKY_UI_HOME, "credentials.json"),
+  ]) {
+    if (!(await exists(credPath))) continue;
+    const creds = JSON.parse(await readFile(credPath, "utf8"));
+    if (typeof creds.personalToken === "string" && creds.personalToken.trim()) {
+      return creds.personalToken.trim();
+    }
+    if (typeof creds.authToken === "string" && creds.authToken.trim()) {
+      return creds.authToken.trim();
+    }
+  }
+  return null;
+}
+
+function resolveApiBase(pkg) {
+  const fromEnv = process.env.SKY_UI_API_URL?.trim();
+  if (fromEnv) return fromEnv.replace(/\/api\/?$/, "").replace(/\/$/, "");
+  const fromPkg = pkg?.skyUiPro?.apiBase?.trim();
+  if (fromPkg) return fromPkg.replace(/\/$/, "");
+  return "https://library.sky-ui.com";
+}
+
+function tarballUrl(apiBase, name, version) {
+  const base = apiBase.replace(/\/$/, "");
+  const scopePath = name.replace("/", "%2f");
+  return `${base}/npm/${scopePath}/-/${name}-${version}.tgz`;
+}
+
+function printMissingToken(name) {
+  console.warn(`
+[@sky.ui.pro] Missing install token — ${name} was not downloaded.
+
+  Local dev:
+    npx sky.ui.pro login
+    or  export SKY_UI_PERSONAL_TOKEN=sk_pt_…
+
+  CI / pipelines:
+    export SKY_UI_AUTH_TOKEN=sk_ci_…
+
+  Then re-run:  npm install ${name}
+  Docs: https://library.sky-ui.com/docs/getting-started
+`);
+}
+
+async function installFromTarball(tgzPath, slug, version) {
+  const stagingDir = await mkdtemp(join(tmpdir(), `sky.ui.pro-${slug}-${version}-`));
+  try {
+    await extract({ file: tgzPath, cwd: stagingDir, strip: 1 });
+    await copyDirectoryContents(stagingDir, pkgRoot);
+    await saveToCache(slug, version, stagingDir);
+  } finally {
+    await rm(stagingDir, { recursive: true, force: true });
+  }
+}
+
+async function main() {
+  if (process.env.SKY_UI_PRO_SKIP_POSTINSTALL === "1") return;
+
+  const pkg = await readJson(join(pkgRoot, "package.json"));
+  const { name, version } = pkg;
+  if (!name?.startsWith("@sky.ui.pro/") || !version) {
+    console.warn("[@sky.ui.pro] postinstall: invalid package.json name/version");
+    return;
+  }
+
+  const slug = packageSlug(name);
+  await enforceCachePolicy(slug, version);
+
+  if (await restoreFromCache(slug, version, pkgRoot)) {
+    console.log(`[@sky.ui.pro] Restored ${name}@${version} from cache.`);
+    return;
+  }
+
+  const token = await resolveToken();
+  if (!token) {
+    printMissingToken(name);
+    if (process.env.SKY_UI_PRO_STRICT === "1" || process.env.SKY_UI_AUTH_TOKEN) {
+      process.exit(1);
+    }
+    return;
+  }
+
+  const url = tarballUrl(resolveApiBase(pkg), name, version);
+  const res = await fetch(url, {
+    headers: { Authorization: `Bearer ${token}`, Accept: "application/octet-stream" },
+  });
+
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    console.error(`[@sky.ui.pro] Download failed (${res.status}) ${url}`);
+    if (body) console.error(body.slice(0, 500));
+    process.exit(1);
+  }
+
+  await mkdir(cacheRoot, { recursive: true });
+  const tgzPath = join(cacheRoot, `${slug}-${version}.tgz`);
+  await pipeline(res.body, createWriteStream(tgzPath));
+  await installFromTarball(tgzPath, slug, version);
+  console.log(`[@sky.ui.pro] Installed ${name}@${version}`);
+}
+
+main().catch((err) => {
+  console.error("[@sky.ui.pro] postinstall error:", err instanceof Error ? err.message : err);
+  process.exit(1);
+});