@nqlib/nqui 0.3.3 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nqlib/nqui",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "A React component library with enhanced UI components and developer tools",
   "type": "module",
   "main": "./dist/nqui.cjs.js",
@@ -12,6 +12,36 @@
       "import": "./dist/nqui.es.js",
       "require": "./dist/nqui.cjs.js"
     },
+    "./carousel": {
+      "types": "./dist/entries/carousel.d.ts",
+      "import": "./dist/carousel.es.js",
+      "require": "./dist/carousel.cjs.js"
+    },
+    "./command": {
+      "types": "./dist/entries/command.d.ts",
+      "import": "./dist/command.es.js",
+      "require": "./dist/command.cjs.js"
+    },
+    "./sortable": {
+      "types": "./dist/entries/sortable.d.ts",
+      "import": "./dist/sortable.es.js",
+      "require": "./dist/sortable.cjs.js"
+    },
+    "./calendar": {
+      "types": "./dist/entries/calendar.d.ts",
+      "import": "./dist/calendar.es.js",
+      "require": "./dist/calendar.cjs.js"
+    },
+    "./sonner": {
+      "types": "./dist/entries/sonner.d.ts",
+      "import": "./dist/sonner.es.js",
+      "require": "./dist/sonner.cjs.js"
+    },
+    "./drawer": {
+      "types": "./dist/entries/drawer.d.ts",
+      "import": "./dist/drawer.es.js",
+      "require": "./dist/drawer.cjs.js"
+    },
     "./styles": {
       "import": "./dist/styles.css",
       "require": "./dist/styles.css",
@@ -51,6 +81,7 @@
   "author": "",
   "license": "MIT",
   "scripts": {
+    "postinstall": "node scripts/post-install.js",
     "dev": "vite",
     "build": "npm run build:lib",
     "build:lib": "vite build --mode library && npm run build:types && npm run build:styles && npm run copy:css",
@@ -75,12 +106,14 @@
     "test-storybook:coverage": "test-storybook --coverage"
   },
   "bin": {
-    "nqui": "./scripts/init-css.js",
+    "nqui": "./scripts/cli.js",
     "nqui-init-css": "./scripts/init-css.js",
-    "nqui-init-debug": "./scripts/init-debug-css.js"
+    "nqui-init-cursor": "./scripts/init-cursor.js",
+    "nqui-install-peers": "./scripts/install-peers.js",
+    "nqui-init-debug": "./scripts/init-debug-css.js",
+    "nqui-setup": "./scripts/post-install.js"
   },
   "dependencies": {
-    "@base-ui/react": "^1.0.0",
     "@codesandbox/sandpack-react": "^2.20.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/modifiers": "^9.0.0",
@@ -89,7 +122,6 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@hugeicons/core-free-icons": "^3.1.1",
     "@hugeicons/react": "^1.1.4",
-    "@icons-pack/react-simple-icons": "^13.8.0",
     "@radix-ui/react-avatar": "^1.1.11",
     "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-collapsible": "^1.1.12",
@@ -106,36 +138,28 @@
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@radix-ui/react-use-controllable-state": "^1.2.2",
-    "@remixicon/react": "^4.8.0",
     "@shikijs/transformers": "^3.21.0",
     "@tailwindcss/vite": "^4.1.17",
     "@tanstack/react-table": "^8.21.3",
-    "@tanstack/react-virtual": "^3.13.18",
     "@uidotdev/usehooks": "^2.4.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "html2canvas-pro": "^1.6.3",
     "input-otp": "^1.4.2",
-    "jotai": "^2.17.0",
     "lodash.throttle": "^4.1.1",
-    "lucide-react": "^0.562.0",
     "minimist": "^1.2.8",
-    "motion": "^12.24.10",
     "next-themes": "^0.4.6",
     "package": "^1.0.1",
     "postcss": "^8.4.0",
     "postcss-discard-comments": "^7.0.0",
     "postcss-import": "^16.0.0",
     "radix-ui": "^1.4.3",
-    "react": "^18.2.0",
+    "react": "^19.0.0",
     "react-day-picker": "^9.13.0",
-    "react-dom": "^18.2.0",
-    "react-resizable-panels": "^4.2.1",
+    "react-dom": "^19.0.0",
     "react-router-dom": "^7.11.0",
-    "recharts": "^2.15.4",
     "shiki": "^3.21.0",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.4.0",
@@ -144,7 +168,68 @@
     "tw-animate-css": "^1.4.0",
     "vaul": "^1.1.2"
   },
+  "peerDependencies": {
+    "@base-ui/react": "^1.0.0",
+    "@hugeicons/core-free-icons": "^3.0.0",
+    "@hugeicons/react": "^1.0.0",
+    "@dnd-kit/core": "^6.0.0",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.0.0",
+    "@tanstack/react-table": "^8.0.0",
+    "cmdk": "^1.0.0",
+    "date-fns": "^4.0.0",
+    "embla-carousel-react": "^8.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-day-picker": "^9.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "react-resizable-panels": "^4.0.0",
+    "sonner": "^2.0.0",
+    "vaul": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "cmdk": {
+      "optional": true
+    },
+    "@dnd-kit/core": {
+      "optional": true
+    },
+    "@dnd-kit/modifiers": {
+      "optional": true
+    },
+    "@dnd-kit/sortable": {
+      "optional": true
+    },
+    "@dnd-kit/utilities": {
+      "optional": true
+    },
+    "embla-carousel-react": {
+      "optional": true
+    },
+    "@tanstack/react-table": {
+      "optional": true
+    },
+    "react-day-picker": {
+      "optional": true
+    },
+    "date-fns": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
+    },
+    "vaul": {
+      "optional": true
+    },
+    "react-resizable-panels": {
+      "optional": true
+    },
+    "@base-ui/react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@base-ui/react": "^1.0.0",
     "@eslint/js": "^9.39.1",
     "@storybook/addon-docs": "^10.1.11",
     "@storybook/addon-links": "^10.1.11",
@@ -155,14 +240,15 @@
     "@storybook/testing-library": "^0.2.2",
     "@types/lodash.throttle": "^4.1.9",
     "@types/node": "^24.10.1",
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^5.1.1",
     "eslint": "^9.39.1",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "eslint-plugin-storybook": "10.1.11",
     "globals": "^16.5.0",
+    "react-resizable-panels": "^4.2.1",
     "shadcn": "^3.6.2",
     "storybook": "^10.1.11",
     "typescript": "~5.9.3",

package/scripts/cli.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * nqui CLI dispatcher. Routes subcommands to the correct script.
+ *
+ * Usage:
+ *   npx @nqlib/nqui init-css [output.css]
+ *   npx @nqlib/nqui init-cursor
+ *   npx @nqlib/nqui install-peers
+ *   npx @nqlib/nqui init-debug
+ *   npx @nqlib/nqui setup
+ */
+
+import { spawnSync } from 'child_process';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const subcommand = process.argv[2];
+
+const routes = {
+  'init-cursor': './init-cursor.js',
+  'install-peers': './install-peers.js',
+  'init-debug': './init-debug-css.js',
+  'init-debug-css': './init-debug-css.js',
+  setup: './post-install.js',
+};
+
+if (routes[subcommand]) {
+  const script = resolve(__dirname, routes[subcommand]);
+  const result = spawnSync(process.execPath, [script, ...process.argv.slice(3)], {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+  });
+  process.exit(result.status ?? 1);
+}
+
+// Default: init-css (pass all args through)
+const initCss = resolve(__dirname, 'init-css.js');
+const result = spawnSync(process.execPath, [initCss, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+});
+process.exit(result.status ?? 1);

package/scripts/help.js

@@ -11,6 +11,7 @@ ${pkg.name} v${pkg.version}
 
 Usage:
   npx nqui init-css [output.css] [options]
+  npx nqui-setup              Show post-install next steps
 
 Options:
   --js            Generate JS token file

package/scripts/init-css.js

@@ -19,6 +19,21 @@ import { generateSetupContent } from './setup-helper.js';
 import { copyNextJsExamples } from './examples.js';
 import { emit } from './pipeline/emit.js';
 
+// Guard: if first arg is a subcommand, user has old package (main bin was init-css). Redirect.
+const firstArg = process.argv[2];
+const subcommands = ['init-cursor', 'install-peers', 'init-debug', 'init-debug-css', 'setup'];
+if (subcommands.includes(firstArg)) {
+  console.error(`
+❌ Outdated @nqlib/nqui — "npx @nqlib/nqui ${firstArg}" routed to init-css.
+
+   Fix: npm install @nqlib/nqui@latest
+   Then: npx @nqlib/nqui ${firstArg}
+
+   Or run the binary directly: npm exec nqui-init-cursor
+`);
+  process.exit(1);
+}
+
 // Filter out command names from argv
 const commandNames = ['init-css', 'nqui', 'nqui-init-css'];
 const filteredArgs = process.argv.slice(2).filter(arg => !commandNames.includes(arg));

package/scripts/init-cursor.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+
+/**
+ * Injects nqui Cursor/IDE rules so AI assistants have instructions
+ * for building components correctly with @nqlib/nqui.
+ *
+ * Usage: npx nqui init-cursor
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { resolve, dirname, relative } from 'path';
+import { fileURLToPath } from 'url';
+import { FULL_PEER_LIST } from './peer-deps.js';
+import { buildInstallSkill, buildComponentsSkill } from './skill-templates.js';
+import { resolveTargetDir } from './resolve-target-dir.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cwd = process.cwd();
+const cursorDir = resolve(cwd, '.cursor');
+const rulesDir = resolve(cursorDir, 'rules');
+const rulePath = resolve(rulesDir, 'nqui-components.mdc');
+
+const fullInstallCmd = `pnpm add @nqlib/nqui ${FULL_PEER_LIST.join(' ')}`;
+const npmInstallCmd = `npm install @nqlib/nqui ${FULL_PEER_LIST.join(' ')}`;
+
+export function buildCursorRule() {
+  return `---
+description: nqui component implementation guide. Use when building UI with @nqlib/nqui.
+globs: "**/*.{ts,tsx}"
+alwaysApply: false
+---
+
+# nqui Component Guidelines
+
+When building UI with @nqlib/nqui, follow these rules so the AI builds components correctly.
+
+## Install (full: nqui + all optional peers)
+
+Run this when setting up a new project or when components fail due to missing peers:
+
+\`\`\`bash
+${fullInstallCmd}
+\`\`\`
+
+Alternative (npm): \`${npmInstallCmd}\`
+
+Or use \`npx @nqlib/nqui install-peers\` to auto-detect package manager.
+
+## Import
+
+\`\`\`tsx
+import { Button, ToggleGroup, ToggleGroupItem, Select } from "@nqlib/nqui"
+\`\`\`
+
+**CSS:** \`@import "@nqlib/nqui/styles"\` (run \`npx @nqlib/nqui init-css\` first)
+
+## CSS Setup (First-Run Fix)
+
+\`init-css\` creates \`nqui/index.css\` and \`nqui/nqui-setup.css\` in the project root. **User must manually add the import** to their main CSS file. If nqui components render without styles or user reports "CSS import issue":
+
+1. **Check** if the main CSS file has the nqui import. Main files: \`app/globals.css\` (Next.js), \`src/index.css\` (Vite), \`app/root.css\` (Remix).
+
+2. **Fix options:**
+   - **Option A (recommended):** Add \`@import "@nqlib/nqui/styles";\` near the top of the main CSS file (after \`@import "tailwindcss"\`).
+   - **Option B:** If \`nqui/nqui-setup.css\` exists, copy its contents to the very top of the main CSS file.
+
+3. **Next.js only:** Ensure \`@source\` directives exist for Tailwind v4:
+   \`\`\`css
+   @source "./**/*.{js,ts,jsx,tsx,mdx}";
+   @source "../components/**/*.{js,ts,jsx,tsx,mdx}";
+   @source "../node_modules/@nqlib/nqui/dist/**/*.js";
+   \`\`\`
+
+4. **Vite:** Simpler – just \`@import "tailwindcss";\` + \`@import "tw-animate-css";\` + \`@import "@nqlib/nqui/styles";\`
+
+If user hasn't run init-css, suggest: \`npx @nqlib/nqui init-css\` then add the import as above.
+
+## Component Selection Rules
+
+### Inline/Toolbar Selection → ToggleGroup (never RadioGroup)
+
+| Context | Use | NOT |
+|---------|-----|-----|
+| View mode (List/Grid), scale (Linear/Log), size (S/M/L) | **ToggleGroup** \`type="single" variant="segmented"\` | RadioGroup |
+| Format toolbar (Bold/Italic/Underline) | **ToggleGroup** \`type="multiple"\` | Multiple Checkboxes |
+| Toolbar actions (Undo/Redo) | **ButtonGroup** | — |
+| Single on/off (Bold, Mute) | **Toggle** | — |
+
+**Rule:** Inline/toolbar = ToggleGroup. RadioGroup only for form context (settings modal, stacked list).
+
+### Quick Decision
+
+- **ToggleGroup segmented** → 1 of N, 2–4 options, primary fill on selected
+- **ToggleGroup single** → 1 of N, neutral styling
+- **ToggleGroup multiple** → 0+ of N (bold/italic)
+- **Select** → 1 of N, 5+ options or dropdown
+- **ButtonGroup** → Actions (each click = action)
+- **RadioGroup** → Form context only
+
+## Context-First Design
+
+**Rule:** Never show Toggle/ToggleGroup/ButtonGroup floating alone. Place in realistic context:
+- Document editor: toolbar above content, \`bg-muted/30\`, \`Separator\` between groups
+- Chart/settings: label + inline controls, \`rounded-lg border bg-muted/30 p-3\`
+
+## Shared Conventions
+
+- **Control sizes:** sm=h-6, default=h-7, lg=h-8
+- **Enhanced vs Core:** Default is enhanced. Use \`CoreButton\`, \`CoreBadge\` for plain shadcn.
+- **Z-index:** Use CSS vars only, e.g. \`z-[var(--z-modal)]\`. Never hardcode \`z-10\`, \`z-50\`.
+- **Grouped controls:** ButtonGroup, ToggleGroup share container border; ToggleGroup uses item dividers.
+
+## Skills (load for install or component questions)
+
+- **Install/setup:** Load \`.cursor/skills/nqui-install/SKILL.md\` — commands to execute
+- **Components:** Load \`.cursor/skills/nqui-components/SKILL.md\` — points to \`node_modules/@nqlib/nqui/docs/components/\`
+
+For any component question, read from \`node_modules/@nqlib/nqui/docs/components/README.md\` (index) then \`nqui-<name>.md\` (specific component).
+`;
+}
+
+export function writeCursorRule(targetCwd) {
+  const cursorDir = resolve(targetCwd, '.cursor');
+  const rulesDir = resolve(cursorDir, 'rules');
+  const skillsDir = resolve(cursorDir, 'skills');
+
+  if (!existsSync(cursorDir)) mkdirSync(cursorDir, { recursive: true });
+  if (!existsSync(rulesDir)) mkdirSync(rulesDir, { recursive: true });
+
+  writeFileSync(resolve(rulesDir, 'nqui-components.mdc'), buildCursorRule(), 'utf8');
+
+  // Inject skills for install + component docs
+  const installSkillDir = resolve(skillsDir, 'nqui-install');
+  const componentsSkillDir = resolve(skillsDir, 'nqui-components');
+  if (!existsSync(installSkillDir)) mkdirSync(installSkillDir, { recursive: true });
+  if (!existsSync(componentsSkillDir)) mkdirSync(componentsSkillDir, { recursive: true });
+
+  writeFileSync(resolve(installSkillDir, 'SKILL.md'), buildInstallSkill(), 'utf8');
+  writeFileSync(resolve(componentsSkillDir, 'SKILL.md'), buildComponentsSkill(), 'utf8');
+}
+
+function main() {
+  const targetDir = resolveTargetDir(cwd);
+  const nquiPath = resolve(targetDir, 'node_modules/@nqlib/nqui');
+  const inMonorepo = existsSync(resolve(__dirname, '../docs/components/README.md'));
+  if (!existsSync(nquiPath) && !inMonorepo) {
+    console.warn('⚠️  @nqlib/nqui not found in node_modules. Rule created; install nqui for full docs path.');
+  }
+
+  const displayPath = targetDir === cwd ? '.' : relative(cwd, targetDir) || '.';
+  if (targetDir !== cwd) {
+    console.log(`📁 Monorepo: writing to ${displayPath} (open this folder in Cursor)`);
+  }
+
+  writeCursorRule(targetDir);
+  console.log(`
+✅ Cursor rules + skills installed
+
+   ${displayPath}/.cursor/rules/nqui-components.mdc
+   ${displayPath}/.cursor/skills/nqui-install/
+   ${displayPath}/.cursor/skills/nqui-components/
+
+   Open this folder in Cursor for skills to work. Docs: node_modules/@nqlib/nqui/docs/components/
+`);
+}
+
+// Only run when executed directly (npx nqui init-cursor), not when imported
+const isMain = process.argv[1]?.includes('init-cursor');
+if (isMain) main();

package/scripts/install-peers.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * Installs @nqlib/nqui + all required and optional peer dependencies.
+ * Use when you want full library support (Sortable, Carousel, DataTable, etc.).
+ *
+ * Usage: npx @nqlib/nqui install-peers
+ */
+
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { execSync } from 'child_process';
+import { FULL_PEER_LIST } from './peer-deps.js';
+
+const cwd = process.cwd();
+
+function detectPackageManager() {
+  if (existsSync(resolve(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(resolve(cwd, 'yarn.lock'))) return 'yarn';
+  if (existsSync(resolve(cwd, 'bun.lockb'))) return 'bun';
+  return 'npm';
+}
+
+function getInstallCmd(pkgs) {
+  const pm = detectPackageManager();
+  const list = pkgs.join(' ');
+  switch (pm) {
+    case 'pnpm':
+      return `pnpm add ${list}`;
+    case 'yarn':
+      return `yarn add ${list}`;
+    case 'bun':
+      return `bun add ${list}`;
+    default:
+      return `npm install ${list}`;
+  }
+}
+
+const pkgs = ['@nqlib/nqui', ...FULL_PEER_LIST];
+const cmd = getInstallCmd(pkgs);
+
+console.log(`\nInstalling nqui + all peer dependencies...\n  ${cmd}\n`);
+execSync(cmd, { stdio: 'inherit', cwd });

package/scripts/peer-deps.js

@@ -0,0 +1,27 @@
+/**
+ * nqui peer dependencies. Required + optional (for full library usage).
+ * Used by install-peers.js and init-cursor.js.
+ */
+
+export const REQUIRED_PEERS = [
+  '@hugeicons/react',
+  '@hugeicons/core-free-icons',
+];
+
+export const OPTIONAL_PEERS = [
+  'cmdk',
+  '@dnd-kit/core',
+  '@dnd-kit/modifiers',
+  '@dnd-kit/sortable',
+  '@dnd-kit/utilities',
+  'embla-carousel-react',
+  '@tanstack/react-table',
+  'react-day-picker',
+  'date-fns',
+  'sonner',
+  'vaul',
+  'react-resizable-panels',
+  '@base-ui/react',
+];
+
+export const FULL_PEER_LIST = [...REQUIRED_PEERS, ...OPTIONAL_PEERS];

package/scripts/post-install.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install: print next steps for nqui setup.
+ * Runs after npm/pnpm/yarn install. Also invokable via: npx nqui-setup
+ *
+ * Auto-injects Cursor rules so consumers don't need to remember init-cursor.
+ */
+
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+
+// Skip in CI to reduce noise
+if (process.env.CI === 'true' || process.env.CI === '1') process.exit(0);
+
+function detectPackageManager() {
+  const cwd = process.cwd();
+  if (existsSync(resolve(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(resolve(cwd, 'yarn.lock'))) return 'yarn';
+  if (existsSync(resolve(cwd, 'bun.lockb'))) return 'bun';
+  return 'npm';
+}
+
+function getInstallCmd(pkgs) {
+  const pm = detectPackageManager();
+  const list = pkgs.join(' ');
+  switch (pm) {
+    case 'pnpm':
+      return `pnpm add ${list}`;
+    case 'yarn':
+      return `yarn add ${list}`;
+    case 'bun':
+      return `bun add ${list}`;
+    default:
+      return `npm install ${list}`;
+  }
+}
+
+import { FULL_PEER_LIST } from './peer-deps.js';
+import { writeCursorRule } from './init-cursor.js';
+import { resolveTargetDir } from './resolve-target-dir.js';
+
+const requiredPeers = ['@hugeicons/react', '@hugeicons/core-free-icons'];
+const recommended = ['tw-animate-css', 'next-themes'];
+
+const installRequired = getInstallCmd(requiredPeers);
+const installFull = getInstallCmd(['@nqlib/nqui', ...FULL_PEER_LIST]);
+const installRecommended = getInstallCmd(recommended);
+
+const msg = `
+╔══════════════════════════════════════════════════════════════════╗
+║  nqui – Next steps                                               ║
+╚══════════════════════════════════════════════════════════════════╝
+
+1. Set up CSS (required)
+   npx @nqlib/nqui init-css
+
+2. Install peers: ${installRequired}
+   Full: npx @nqlib/nqui install-peers
+
+3. Optional: tw-animate-css, next-themes
+
+4. Cursor skills: auto-injected. Open this folder in Cursor.
+   Refresh: npx @nqlib/nqui init-cursor
+
+→ Run "npx nqui-setup" anytime to see this again.
+`;
+console.log(msg);
+
+// Auto-inject Cursor rules (writes to package that has nqui in monorepos)
+const targetDir = resolveTargetDir(process.cwd());
+writeCursorRule(targetDir);
+console.log(`   Skills written to: ${targetDir}/.cursor/\n`);

package/scripts/publish-npmjs.js

@@ -19,8 +19,19 @@ const npmrcPath = join(rootDir, '.npmrc');
 // Read package.json
 const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
 
-// Save original publishConfig
+// Save originals for restore
 const originalPublishConfig = packageJson.publishConfig;
+const originalDependencies = { ...packageJson.dependencies };
+
+// Remove workspace:* deps (npm doesn't support workspace: protocol).
+// nqcode/nqappbuilder are dev/showcase-only and not bundled in the library.
+const workspaceDeps = ['@nqlib/nqcode', '@nqlib/nqappbuilder'];
+for (const name of workspaceDeps) {
+  if (packageJson.dependencies?.[name] === 'workspace:*') {
+    delete packageJson.dependencies[name];
+    console.log(`   Removed ${name} (workspace dep)`);
+  }
+}
 
 // Override publishConfig for npmjs.com
 packageJson.publishConfig = {
@@ -99,14 +110,17 @@ try {
   }
   throw error;
 } finally {
-  // Restore original publishConfig
+  // Restore original publishConfig and dependencies
   if (originalPublishConfig) {
     packageJson.publishConfig = originalPublishConfig;
   } else {
     delete packageJson.publishConfig;
   }
+  if (originalDependencies) {
+    packageJson.dependencies = originalDependencies;
+  }
   writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
-  console.log('🔄 Restored publishConfig');
+  console.log('🔄 Restored package.json');
 
   // Restore .npmrc if it existed
   if (npmrcExists && originalNpmrc !== null) {