@naturaldesign/dev 0.0.0-stage → 0.0.12

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@naturaldesign/dev",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.12",
+  "type": "module",
+  "description": "Dev-only plugin for Natural Design: stamps JSX with its source, indexes the project's components and renders them, so Natural Design can show and edit a project's real components. Run `npx @naturaldesign/dev init` in a Next or Vite project.",
+  "bin": {
+    "naturaldesign-dev": "dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./babel": {
+      "types": "./dist/types/babel.d.ts",
+      "default": "./dist/babel.cjs"
+    },
+    "./vite": {
+      "types": "./dist/types/vite.d.ts",
+      "default": "./dist/vite.mjs"
+    },
+    "./loader": {
+      "types": "./dist/types/loader.d.ts",
+      "default": "./dist/loader.cjs"
+    },
+    "./next": {
+      "types": "./src/next.d.ts",
+      "default": "./src/next.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "bun build src/loader.ts --outfile dist/loader.cjs --target node --format cjs && bun build src/babel.ts --outfile dist/babel.cjs --target node --format cjs && bun build src/vite.ts --outfile dist/vite.mjs --target node --format esm && bun build src/index.ts --outfile dist/index.mjs --target node --format esm && bun build src/cli.ts --outfile dist/cli.mjs --target node --format esm --banner '#!/usr/bin/env node' && chmod +x dist/cli.mjs && tsc src/index.ts src/vite.ts src/babel.ts src/loader.ts --declaration --emitDeclarationOnly --skipLibCheck --module esnext --moduleResolution bundler --target es2022 --types node --outDir dist/types",
+    "test": "bun test",
+    "pretest": "bun run build",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@babel/parser": "7.29.2",
+    "magic-string": "^0.30.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "files": [
+    "dist",
+    "src/next.cjs",
+    "src/next.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "natural-design",
+    "vite-plugin",
+    "nextjs",
+    "design-tool",
+    "components"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "types": "./dist/types/index.d.ts"
+}

package/src/next.cjs

@@ -0,0 +1,34 @@
+// Next.js: `import { withNaturalDesign } from '@naturaldesign/dev/next'` then `export default withNaturalDesign(nextConfig, options)`.
+// Adds the loader for webpack and Turbopack in `next dev` only: source, owner and call-site stamps, render-registry
+// registration in 'use client' files, and component descriptors in .next/natural/index/. `options` go to the loader
+// as-is (root, exclude, calls, owners, register, index, indexFolders), so they must stay JSON (Turbopack serialises them).
+// Plain CommonJS so both `require` and ESM named imports work.
+'use strict'
+const path = require('node:path')
+
+function loaderPath() {
+  try { return require.resolve('@naturaldesign/dev/loader') } catch { return path.join(__dirname, '..', 'dist', 'loader.cjs') }
+}
+
+function withNaturalDesign(config = {}, options = {}) {
+  // Production builds carry no stamps: the config goes back untouched.
+  if (process.env.NODE_ENV === 'production') return config
+  const loader = loaderPath()
+  const rule = { test: /\.[jt]sx$/, exclude: /node_modules/, enforce: 'pre', use: [{ loader, options }] }
+  const previous = config.webpack
+  const turbopackRules = Object.assign({}, (config.turbopack && config.turbopack.rules) || {})
+  for (const glob of ['*.tsx', '*.jsx']) if (!turbopackRules[glob]) turbopackRules[glob] = { loaders: [{ loader, options }], as: glob }
+  return Object.assign({}, config, {
+    turbopack: Object.assign({}, config.turbopack || {}, { rules: turbopackRules }),
+    webpack(webpackConfig, context) {
+      if (context.dev) {
+        webpackConfig.module = webpackConfig.module || {}
+        webpackConfig.module.rules = [rule].concat(webpackConfig.module.rules || [])
+      }
+      return previous ? previous(webpackConfig, context) : webpackConfig
+    },
+  })
+}
+
+module.exports = { withNaturalDesign, default: withNaturalDesign }
+module.exports.withNaturalDesign = withNaturalDesign

package/src/next.d.ts

@@ -0,0 +1,18 @@
+// Types for `@naturaldesign/dev/next` (next.cjs). The config stays whatever Next config it was given.
+export interface NaturalDesignNextOptions {
+  root?: string
+  /** Component names that must not receive data-nd-call. */
+  exclude?: string[]
+  /** Call-site stamps on component elements (default true). */
+  calls?: boolean
+  /** Owner stamps on host elements (default true). */
+  owners?: boolean
+  /** Register 'use client' components with the render registry (default true). */
+  register?: boolean
+  /** Write component descriptors to .next/natural/index (default true). */
+  index?: boolean
+  /** Folders the index covers, relative to the root. */
+  indexFolders?: string[]
+}
+export declare function withNaturalDesign<T extends object>(config?: T, options?: NaturalDesignNextOptions): T
+export default withNaturalDesign