@once-ui-system/core 1.8.5 → 2.0.0-alpha.1

package/dist/next/index.d.ts

@@ -0,0 +1,35 @@
+import type React from "react";
+import { type OnceUIAdapters } from "../contexts/AdapterProvider";
+import { LayoutProvider as BaseLayoutProvider } from "../contexts/LayoutProvider";
+export declare const nextAdapters: OnceUIAdapters;
+export interface NextAdapterProviderProps {
+    children: React.ReactNode;
+}
+export declare const NextAdapterProvider: React.FC<NextAdapterProviderProps>;
+/**
+ * Drop-in replacement for core's `LayoutProvider`, with the Next adapters
+ * already installed.
+ *
+ * This is the whole migration for a Next.js app on 1.8.x: change the import
+ * path for `LayoutProvider`, and `SmartLink`, `Button`/`Card`/`ToggleButton`
+ * with an `href`, `Media`, `Logo`, `MegaMenu` and `Kbar` keep routing through
+ * next/link and next/image exactly as before. No provider is added to the tree
+ * and no props change.
+ *
+ *     - import { LayoutProvider } from "@once-ui-system/core";
+ *     + import { LayoutProvider } from "@once-ui-system/core/next";
+ *
+ * Detection is deliberately not attempted. The adapters include two hooks whose
+ * implementations call different numbers of hooks — the DOM `useNavigate`
+ * returns a closure, the Next one calls `useRouter` and `useCallback` — so
+ * swapping them after mount breaks the rules of hooks. Resolution has to be
+ * settled before the first render, and a browser bundle has no synchronous way
+ * to conditionally resolve an optional module. An explicit import is the
+ * honest, bundler-independent version of the same thing.
+ *
+ * Apps that already compose `AdapterProvider` themselves can keep using
+ * `NextAdapterProvider` directly; this only removes the boilerplate for the
+ * common case.
+ */
+export declare const LayoutProvider: React.FC<React.ComponentProps<typeof BaseLayoutProvider>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AA4BlF,eAAO,MAAM,YAAY,EAAE,cAK1B,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAElE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,CAOpF,CAAC"}

package/dist/next/index.js

@@ -0,0 +1,56 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import NextImage from "next/image";
+import NextLink from "next/link";
+import { usePathname, useRouter } from "next/navigation";
+import { forwardRef, useCallback } from "react";
+import { AdapterProvider, } from "../contexts/AdapterProvider";
+import { LayoutProvider as BaseLayoutProvider } from "../contexts/LayoutProvider";
+/**
+ * Next.js adapter bindings — the ONLY runtime `next/*` imports in core
+ * outside modules/seo and server/ (enforced by framework-boundary.test.ts).
+ * Imported via the `@once-ui-system/core/next` subpath, never the root
+ * barrel, so non-Next bundlers never resolve `next/*`. This module becomes
+ * the seed of `@once-ui-system/nextjs` in 2.0 Phase 4.
+ */
+const NextAdapterLink = forwardRef(({ href, children, ...props }, ref) => (_jsx(NextLink, { href: href, ref: ref, ...props, children: children })));
+NextAdapterLink.displayName = "NextAdapterLink";
+const NextAdapterImage = ({ width, height, ...props }) => (_jsx(NextImage, { width: width, height: height, ...props }));
+const useNextNavigate = () => {
+    const router = useRouter();
+    return useCallback((href) => router.push(href), [router]);
+};
+export const nextAdapters = {
+    Link: NextAdapterLink,
+    Image: NextAdapterImage,
+    usePathname,
+    useNavigate: useNextNavigate,
+};
+export const NextAdapterProvider = ({ children }) => (_jsx(AdapterProvider, { adapters: nextAdapters, children: children }));
+/**
+ * Drop-in replacement for core's `LayoutProvider`, with the Next adapters
+ * already installed.
+ *
+ * This is the whole migration for a Next.js app on 1.8.x: change the import
+ * path for `LayoutProvider`, and `SmartLink`, `Button`/`Card`/`ToggleButton`
+ * with an `href`, `Media`, `Logo`, `MegaMenu` and `Kbar` keep routing through
+ * next/link and next/image exactly as before. No provider is added to the tree
+ * and no props change.
+ *
+ *     - import { LayoutProvider } from "@once-ui-system/core";
+ *     + import { LayoutProvider } from "@once-ui-system/core/next";
+ *
+ * Detection is deliberately not attempted. The adapters include two hooks whose
+ * implementations call different numbers of hooks — the DOM `useNavigate`
+ * returns a closure, the Next one calls `useRouter` and `useCallback` — so
+ * swapping them after mount breaks the rules of hooks. Resolution has to be
+ * settled before the first render, and a browser bundle has no synchronous way
+ * to conditionally resolve an optional module. An explicit import is the
+ * honest, bundler-independent version of the same thing.
+ *
+ * Apps that already compose `AdapterProvider` themselves can keep using
+ * `NextAdapterProvider` directly; this only removes the boilerplate for the
+ * common case.
+ */
+export const LayoutProvider = ({ children, ...props }) => (_jsx(NextAdapterProvider, { children: _jsx(BaseLayoutProvider, { ...props, children: children }) }));
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAGL,eAAe,GAEhB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAElF;;;;;;GAMG;AAEH,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CACrC,KAAC,QAAQ,IAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAM,KAAK,YACtC,QAAQ,GACA,CACZ,CACF,CAAC;AACF,eAAe,CAAC,WAAW,GAAG,iBAAiB,CAAC;AAEhD,MAAM,gBAAgB,GAAgC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACrF,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAM,KAAK,GAAI,CACvD,CAAC;AAEF,MAAM,eAAe,GAAG,GAA6B,EAAE;IACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,WAAW,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,gBAAgB;IACvB,WAAW;IACX,WAAW,EAAE,eAAe;CAC7B,CAAC;AAMF,MAAM,CAAC,MAAM,mBAAmB,GAAuC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CACvF,KAAC,eAAe,IAAC,QAAQ,EAAE,YAAY,YAAG,QAAQ,GAAmB,CACtE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,cAAc,GAA8D,CAAC,EACxF,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,EAAE,CAAC,CACJ,KAAC,mBAAmB,cAClB,KAAC,kBAAkB,OAAK,KAAK,YAAG,QAAQ,GAAsB,GAC1C,CACvB,CAAC"}

package/dist/package.json

@@ -1,6 +1,18 @@
 {
   "name": "@once-ui-system/core",
-  "version": "1.8.5",
+  "version": "2.0.0-alpha.1",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "files": [
+    "dist",
+    "ai",
+    "agent",
+    "AGENTS.md",
+    "scripts/init-agent.js",
+    "scripts/validate-ai-code.js"
+  ],
   "description": "Once UI for Next.js NPM package",
   "keywords": [
     "once-ui",
@@ -99,6 +111,11 @@
       "import": "./dist/server/index.js",
       "require": "./dist/server/index.js"
     },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "require": "./dist/next/index.js"
+    },
     "./ai/manifest.json": "./ai/manifest.json",
     "./ai/spec.json": "./ai/spec.json",
     "./ai/catalog.json": "./ai/catalog.json",
@@ -106,20 +123,33 @@
     "./ai/rules.compact.md": "./ai/rules.compact.md",
     "./ai/rules.md": "./ai/rules.md",
     "./ai/recipes.md": "./ai/recipes.md",
+    "./ai/layouts.md": "./ai/layouts.md",
     "./ai/tasks/*": "./ai/tasks/*",
     "./ai/components/*": "./ai/components/*",
     "./ai/examples/*": "./ai/examples/*",
     "./ai/examples/blocks/*": "./ai/examples/blocks/*",
-    "./AGENTS.md": "./AGENTS.md"
+    "./AGENTS.md": "./AGENTS.md",
+    "./data": {
+      "types": "./dist/modules/data/index.d.ts",
+      "import": "./dist/modules/data/index.js",
+      "require": "./dist/modules/data/index.js"
+    },
+    "./code": {
+      "types": "./dist/modules/code/index.d.ts",
+      "import": "./dist/modules/code/index.js",
+      "require": "./dist/modules/code/index.js"
+    },
+    "./media": {
+      "types": "./dist/modules/media/index.d.ts",
+      "import": "./dist/modules/media/index.js",
+      "require": "./dist/modules/media/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
     "@floating-ui/react-dom": "^2.1.9",
     "clsx": "^2.1.1",
-    "compressorjs": "^1.3.0",
-    "date-fns": "^4.4.0",
-    "prismjs": "^1.30.0",
-    "react-icons": "^5.7.0",
-    "recharts": "^3.10.1"
+    "date-fns": "^4.4.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -127,8 +157,23 @@
     "next": ">=13.0.0"
   },
   "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "sass": {
+      "optional": true
+    },
     "sharp": {
       "optional": true
+    },
+    "recharts": {
+      "optional": true
+    },
+    "prismjs": {
+      "optional": true
+    },
+    "compressorjs": {
+      "optional": true
     }
   }
 }

package/dist/scripts/init-agent.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * Scaffold agent harness pointers in a consumer project.
+ * Usage: npx once-ui-init-agent [--force] [--dry-run]
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const PACKAGE_ROOT = path.join(__dirname, "..");
+const MARKER_START = "<!-- once-ui-agent-harness:start -->";
+const MARKER_END = "<!-- once-ui-agent-harness:end -->";
+
+const PROJECT_AGENTS_SECTION = `${MARKER_START}
+## Once UI codegen harness
+
+Before generating Once UI code, load the harness from your installed package (not full doc pages):
+
+1. Read \`node_modules/@once-ui-system/core/ai/manifest.json\`
+2. Load bootstrap: \`ai/rules.compact.md\` + \`ai/catalog.json\`
+3. Match intent via \`ai/tasks/index.json\` → fetch task bundle + component slices
+4. Validate: \`npx once-ui-validate-ai-code path/to/file.tsx\`
+
+npm exports: \`@once-ui-system/core/ai/manifest.json\`
+
+Remote fallback: https://docs.once-ui.com/ai/manifest.json
+${MARKER_END}
+`;
+
+function parseArgs(argv) {
+  return {
+    force: argv.includes("--force"),
+    dryRun: argv.includes("--dry-run"),
+  };
+}
+
+function findProjectRoot(startDir = process.cwd()) {
+  let dir = path.resolve(startDir);
+
+  while (true) {
+    const pkgPath = path.join(dir, "package.json");
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        if (pkg.name !== "@once-ui-system/core") {
+          return dir;
+        }
+      } catch {
+        // keep walking
+      }
+    }
+
+    const parent = path.dirname(dir);
+    if (parent === dir) {
+      break;
+    }
+    dir = parent;
+  }
+
+  return path.resolve(startDir);
+}
+
+function upsertMarkedSection(existing, section, force) {
+  if (existing.includes(MARKER_START) && existing.includes(MARKER_END)) {
+    if (!force) {
+      return { content: existing, changed: false, reason: "AGENTS.md already contains Once UI harness section" };
+    }
+
+    const start = existing.indexOf(MARKER_START);
+    const end = existing.indexOf(MARKER_END) + MARKER_END.length;
+    return {
+      content: `${existing.slice(0, start)}${section}${existing.slice(end)}`,
+      changed: true,
+    };
+  }
+
+  if (existing.trim().length === 0) {
+    return {
+      content: `# AGENTS.md\n\n${section}\n`,
+      changed: true,
+    };
+  }
+
+  return {
+    content: `${existing.trimEnd()}\n\n${section}\n`,
+    changed: true,
+  };
+}
+
+function writeFile(root, relativePath, content, { dryRun, force }) {
+  const target = path.join(root, relativePath);
+  const exists = fs.existsSync(target);
+
+  if (exists && !force) {
+    const current = fs.readFileSync(target, "utf8");
+    if (current === content) {
+      return { path: target, status: "unchanged" };
+    }
+    return { path: target, status: "skipped", reason: "already exists (use --force)" };
+  }
+
+  if (dryRun) {
+    return { path: target, status: "would-write" };
+  }
+
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(target, content, "utf8");
+  return { path: target, status: exists ? "updated" : "created" };
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const projectRoot = findProjectRoot();
+  const cursorRuleTemplate = fs.readFileSync(
+    path.join(PACKAGE_ROOT, "agent", "once-ui-codegen.mdc"),
+    "utf8",
+  );
+
+  const agentsPath = path.join(projectRoot, "AGENTS.md");
+  let agentsContent = "";
+  if (fs.existsSync(agentsPath)) {
+    agentsContent = fs.readFileSync(agentsPath, "utf8");
+  }
+
+  const agentsResult = upsertMarkedSection(agentsContent, PROJECT_AGENTS_SECTION, options.force);
+  const results = [];
+
+  if (agentsResult.changed) {
+    results.push(
+      writeFile(projectRoot, "AGENTS.md", agentsResult.content, options),
+    );
+  } else {
+    results.push({
+      path: agentsPath,
+      status: "unchanged",
+      reason: agentsResult.reason,
+    });
+  }
+
+  results.push(
+    writeFile(projectRoot, ".cursor/rules/once-ui-codegen.mdc", cursorRuleTemplate, options),
+  );
+
+  console.log(`Once UI agent harness setup (${options.dryRun ? "dry run" : "applied"})`);
+  console.log(`Project root: ${projectRoot}`);
+  for (const result of results) {
+    const suffix = result.reason ? ` (${result.reason})` : "";
+    console.log(`- ${result.status}: ${path.relative(projectRoot, result.path)}${suffix}`);
+  }
+
+  if (!options.dryRun) {
+    console.log("\nNext: open a .tsx file and ask your agent to build Once UI — it should load the harness from node_modules/@once-ui-system/core/ai/");
+  }
+}
+
+main();