@crab-dev/wake 0.1.16 → 0.1.18

package/CHANGELOG.md

@@ -1,7 +1,21 @@
 # Changelog
 
+## 0.1.18
+
+- Added native component-library ESM, CommonJS, declaration, and extracted CSS builds through `wake library build` and `buildLibrary()` without changing application builds.
+- Added strict Rust-native token and docgen generators through `wake library token`, `wake library docgen`, `generateCssToken()`, and `generateDocgen()`.
+- Added `defineTokens()` to `@crab-dev/css` for deeply immutable design tokens that can be safely evaluated across module boundaries.
+- Added stable package-prefixed CSS class names, PnP-aware static analysis, transactional library outputs, and fail-closed public type diagnostics.
+
+## 0.1.17
+
+- Added AST-driven CSS parsing shared by compilation, CSS-in-JS nesting, editor diagnostics, and semantic highlighting, removing the legacy TextMate injection grammar.
+- Added Node library bundle APIs and CLI support with incremental rebuild coverage and updated documentation.
+- Added complete CI release coverage for all seven public npm packages and GitHub-only multi-platform VSIX releases.
+
 ## 0.1.16
 
+- Added Node 20 CommonJS single-file bundles with atomic exact-outfile writes, host externals, declaration-ordered Node conditional exports, usable source-map results, and matching Rust/npm CLI support.
 - Automatically loaded Crab UI component CSS from package identity across `node_modules`, workspaces, and Yarn PnP virtual, unplugged, and zip layouts without runtime CSS imports.
 - Added issuer-scoped Yarn PnP dependency fallbacks for Components workbenches while preserving aliases, package-owned dependency versions, exports errors, and ambiguous virtual-locator rejection.
 - Preserved configured Demo accent colors independently from the neutral workbench theme.

package/README.md

@@ -9,9 +9,13 @@ npx wake build
 ```
 
 ```js
-import { build, startDevServer } from '@crab-dev/wake'
+import { build, buildLibrary, bundle, generateCssToken, generateDocgen, startDevServer } from '@crab-dev/wake'
 
 await build({ cwd: process.cwd() })
+await buildLibrary({ cwd: process.cwd(), entry: 'src/index.ts' })
+
+await generateCssToken({ cwd: process.cwd(), configPath: 'token.toml' })
+await generateDocgen({ cwd: process.cwd(), entry: 'src/button.tsx' })
 
 const server = await startDevServer({ port: 5173 })
 console.log(server.url)
@@ -27,6 +31,41 @@ The stable API also includes in-memory `bundle()`, incremental
 and server operations accept `AbortSignal`; long-lived contexts and servers
 support explicit close methods and JavaScript disposal protocols.
 
+Node-hosted tools can request an exact CommonJS artifact without Web output:
+
+```js
+await bundle({
+  entry: 'src/extension.ts',
+  outfile: 'dist/extension.js',
+  platform: 'node',
+  format: 'cjs',
+  target: 'node20',
+  external: ['vscode'],
+})
+```
+
+`platform: 'node'` defaults to CommonJS and `node20`, so `format` and `target`
+can be omitted. `bundle()` returns a dedicated result whose `code` is always a
+string. With `sourceMap: true`, `sourceMap` is returned in memory; when
+`outfile` is present Wake also writes `<outfile>.map`, exposes
+`sourceMapFile`, and appends the matching `sourceMappingURL`.
+
+Component packages can generate design-token TypeScript without a Node-based
+generator by running `wake library token` or calling `generateCssToken()`. The
+generator supports recursive package imports in Yarn PnP and `node_modules`,
+rejects missing references and cycles, and atomically writes only the output
+declared by `build.output`.
+
+`wake library build` and `buildLibrary()` emit `esm/index.mjs`,
+`cjs/index.cjs`, `declarations/index.d.ts`, and optional `css/index.css` from
+the native library graph. Outputs are staged and committed together; unsafe
+public type inference or static-style failures preserve the previous build.
+
+Component API metadata can be generated without `react-docgen` by running
+`wake library docgen` or calling `generateDocgen()`. Entry resolution follows
+the CLI override, package configuration, then the default export from
+`src/index.ts`; failures leave the previous `public/docgen.json` untouched.
+
 Full documentation:
 
 - [Node.js API](https://github.com/hotlif/wake/blob/canary/docs/reference/node-api.mdx)

package/bin/terminal.mjs

@@ -87,6 +87,16 @@ export function formatBuildResult(ui, result, label = 'Built', extra = '') {
   return lines
 }
 
+export function formatGeneratorResult(ui, result, label) {
+  const bytes = (result.files || []).reduce((sum, file) => sum + Number(file.bytes || 0), 0)
+  return [
+    `  ${ui.ok('✓')}  ${ui.bold(label)} ${ui.accent(`in ${humanDuration(result.durationMs)}`)}`,
+    `     ${(result.files || []).length} ${ui.dim('files')} ${ui.dim('·')} ${ui.accent(humanBytes(bytes))}`,
+    `     ${ui.dim('Output')}  ${ui.accent(result.outputFile)}`,
+    '',
+  ]
+}
+
 export function formatServerReady(ui, url, metrics) {
   const lines = [
     `  ${ui.ok('✓')}  ${ui.bold('Development server ready')}`,

package/bin/wake.mjs

@@ -3,10 +3,15 @@
 import { readFile } from 'node:fs/promises'
 import {
   build,
+  buildLibrary,
   buildDocs,
+  bundle,
+  generateCssToken,
+  generateDocgen,
   startDevServer,
   startDocsDevServer,
   version,
+  WakeError,
 } from '../index.mjs'
 import { parse, tokenize } from '../experimental.mjs'
 import {
@@ -18,6 +23,7 @@ import {
   formatBuildResult,
   formatError,
   formatFinalSummary,
+  formatGeneratorResult,
   formatServerReady,
   observeServer,
   setDashboardEndpoint,
@@ -32,6 +38,10 @@ const HELP = `Wake ${version()}
 Usage:
   wake [--ui auto|tui|plain] [--no-color] <command>
   wake build [entry] [--outdir DIR] [--cache] [--sourcemap]
+  wake bundle <entry> --outfile FILE [--platform browser|node] [--format iife|cjs]
+              [--target node20] [--external PACKAGE] [--minify] [--sourcemap]
+              [--cache] [--config FILE]
+  wake library token [project] [--config token.toml]
   wake dev [root] [--entry FILE] [--host HOST] [--port PORT] [--open]
   wake docs build [root] [--mode site|components] [--outdir DIR] [--base PATH]
   wake docs dev [root] [--mode site|components] [--host HOST] [--port PORT] [--open]
@@ -45,15 +55,24 @@ Options:
   --format    Human or JSON output for parse/tokenize (default: auto)
 `
 
-function takeOption(args, name) {
+function takeOption(args, name, usage = false) {
   const index = args.indexOf(name)
   if (index === -1) return undefined
-  if (index + 1 >= args.length) throw new Error(`${name} requires a value`)
+  if (index + 1 >= args.length) {
+    const message = `${name} requires a value`
+    throw usage ? usageError(message) : new Error(message)
+  }
   const [value] = args.splice(index + 1, 1)
   args.splice(index, 1)
   return value
 }
 
+function usageError(message) {
+  const error = new WakeError('WAKE_CONFIG', message)
+  error.exitCode = 2
+  return error
+}
+
 function takeFlag(args, name) {
   const index = args.indexOf(name)
   if (index === -1) return false
@@ -61,6 +80,15 @@ function takeFlag(args, name) {
   return true
 }
 
+function takeOptions(args, name, usage = false) {
+  const values = []
+  for (;;) {
+    const value = takeOption(args, name, usage)
+    if (value === undefined) return values
+    values.push(value)
+  }
+}
+
 function commonOptions(args) {
   return {
     configPath: takeOption(args, '--config'),
@@ -78,6 +106,13 @@ function validateChoice(value, name, choices) {
   return value
 }
 
+function validateBundleChoice(value, name, choices) {
+  if (!choices.includes(value)) {
+    throw usageError(`${name} must be one of: ${choices.join(', ')}`)
+  }
+  return value
+}
+
 function ensureStaticMode(uiMode) {
   if (uiMode === 'tui') {
     throw new Error('--ui tui is only available for dev and docs dev')
@@ -245,6 +280,54 @@ export async function runCli(argv = process.argv.slice(2)) {
     return 0
   }
 
+  if (command === 'bundle') {
+    ensureStaticMode(uiMode)
+    const options = { configPath: takeOption(args, '--config', true) }
+    options.outfile = takeOption(args, '--outfile', true)
+    const platform = takeOption(args, '--platform', true)
+    if (platform !== undefined) {
+      options.platform = validateBundleChoice(platform, '--platform', ['browser', 'node'])
+    }
+    const format = takeOption(args, '--format', true)
+    if (format !== undefined) {
+      options.format = validateBundleChoice(format, '--format', ['iife', 'cjs'])
+    }
+    options.target = takeOption(args, '--target', true)
+    options.external = takeOptions(args, '--external', true)
+    options.minify = takeFlag(args, '--minify')
+    options.sourceMap = takeFlag(args, '--sourcemap')
+    options.cache = takeFlag(args, '--cache')
+    options.entry = args.shift()
+    if (!options.entry || !options.outfile) {
+      throw usageError('bundle requires one entry and --outfile FILE')
+    }
+    if (args.length) throw usageError(`unknown bundle arguments: ${args.join(' ')}`)
+    printLines(formatBanner(ui, 'bundle', version()))
+    printResult(ui, await bundle(options), 'Bundled')
+    return 0
+  }
+
+  if (command === 'library') {
+    ensureStaticMode(uiMode)
+    const action = args.shift()
+    if (action !== 'build' && action !== 'token' && action !== 'docgen') {
+      throw usageError('library requires build, token, or docgen')
+    }
+    const options = action === 'token'
+      ? { configPath: takeOption(args, '--config', true) }
+      : { entry: takeOption(args, '--entry', true) }
+    if (args[0]) options.cwd = args.shift()
+    if (args.length) throw usageError(`unknown library ${action} arguments: ${args.join(' ')}`)
+    printLines(formatBanner(ui, `library ${action}`, version()))
+    if (action === 'build') {
+      printResult(ui, await buildLibrary(options), 'Built library')
+      return 0
+    }
+    const result = action === 'token' ? await generateCssToken(options) : await generateDocgen(options)
+    printLines(formatGeneratorResult(ui, result, action === 'token' ? 'Tokens generated' : 'Docgen generated'))
+    return 0
+  }
+
   if (command === 'dev') {
     const options = commonOptions(args)
     options.entry = takeOption(args, '--entry')
@@ -342,5 +425,5 @@ try {
   const noColor = process.argv.includes('--no-color')
   const ui = createUi(!noColor && supportsColor())
   printLines(formatError(ui, error))
-  process.exitCode = 1
+  process.exitCode = error.exitCode || 1
 }

package/index.cjs

@@ -25,6 +25,21 @@ async function bundle(options) {
   return invoke(native.bundle(JSON.stringify(value), signal))
 }
 
+async function buildLibrary(options) {
+  const [value, signal] = splitOptions(options)
+  return invoke(native.buildLibrary(JSON.stringify(value), signal))
+}
+
+async function generateCssToken(options) {
+  const [value, signal] = splitOptions(options)
+  return invoke(native.generateCssToken(JSON.stringify(value), signal))
+}
+
+async function generateDocgen(options) {
+  const [value, signal] = splitOptions(options)
+  return invoke(native.generateDocgen(JSON.stringify(value), signal))
+}
+
 class BuildContext {
   #native
   #closed = false
@@ -197,8 +212,11 @@ module.exports = {
   DevServer,
   WakeError,
   build,
+  buildLibrary,
   buildDocs,
   bundle,
+  generateCssToken,
+  generateDocgen,
   createBuildContext,
   startDevServer,
   startDocsDevServer,

package/index.d.ts

@@ -8,6 +8,18 @@ export type WakeErrorCode =
   | 'WAKE_CANCELLED'
   | 'WAKE_UNSUPPORTED_PLATFORM'
   | 'WAKE_INTERNAL'
+  | 'WAKE_TOKEN_IO'
+  | 'WAKE_TOKEN_CONFIG'
+  | 'WAKE_TOKEN_IMPORT'
+  | 'WAKE_TOKEN_CYCLE'
+  | 'WAKE_TOKEN_REF'
+  | 'WAKE_DOCGEN_IO'
+  | 'WAKE_DOCGEN_CONFIG'
+  | 'WAKE_DOCGEN_ENTRY'
+  | 'WAKE_DOCGEN_TYPE'
+  | 'WAKE_LIBRARY_BUILD'
+  | 'WAKE_LIBRARY_TYPE'
+  | 'WAKE_LIBRARY_OUTPUT'
 
 export interface Diagnostic {
   severity: 'error' | 'warning' | 'note' | 'help'
@@ -39,9 +51,25 @@ export interface BuildOptions extends ProjectOptions {
   sourceMap?: boolean
 }
 
+export type BundlePlatform = 'browser' | 'node'
+export type BundleFormat = 'iife' | 'cjs'
+export type NodeTarget = `node${number}` | `node${number}.${number}`
+
+export interface BundleOptions extends ProjectOptions {
+  entry?: string
+  outfile?: string
+  platform?: BundlePlatform
+  format?: BundleFormat
+  target?: NodeTarget
+  external?: string[]
+  minify?: boolean
+  sourceMap?: boolean
+  cache?: boolean
+}
+
 export interface OutputFile {
   path: string
-  kind: 'chunk' | 'css' | 'asset' | 'html'
+  kind: 'entry' | 'chunk' | 'css' | 'declaration' | 'asset' | 'html' | 'map'
   bytes: number
 }
 
@@ -57,26 +85,79 @@ export interface BuildResult {
   diagnostics: Diagnostic[]
 }
 
-export interface BundleResult extends BuildResult {
+export interface BundleResult {
+  success: true
+  moduleCount: number
+  updatedModuleCount: number
+  cachedModuleCount: number
+  durationMs: number
+  outputFile?: string
   code: string
-  outputDir?: undefined
+  sourceMap?: string
+  sourceMapFile?: string
+  files: OutputFile[]
+  diagnostics: Diagnostic[]
 }
 
-export type DocsMode = 'site' | 'components'
+export interface LibraryBuildOptions {
+  cwd?: string
+  entry?: string
+  signal?: AbortSignal
+}
 
-export interface DocsRoute {
-  id: string
-  file: string
-  title: string
-  description: string
-  group: string
-  groupOrder: number
-  order: number
-  slug: string
-  status: string
-  draft: boolean
-  headings: Array<{ depth: number; title: string; id: string }>
+export interface LibraryBuildResult extends BuildResult {
+  outputDir: string
+  esmEntry: string
+  cjsEntry: string
+  declarationEntry: string
+  cssEntry?: string
 }
+
+export interface GenerateCssTokenOptions {
+  cwd?: string
+  configPath?: string
+  signal?: AbortSignal
+}
+
+export interface GenerateCssTokenResult {
+  success: true
+  durationMs: number
+  outputFile: string
+  files: OutputFile[]
+}
+
+export interface GenerateDocgenOptions {
+  cwd?: string
+  entry?: string
+  signal?: AbortSignal
+}
+
+export interface GenerateDocgenResult {
+  success: true
+  durationMs: number
+  entry: string
+  outputFile: string
+  files: OutputFile[]
+}
+
+export type DocsMode = 'site' | 'components'
+
+  export interface DocsRoute {
+    id: string
+    file: string
+    title: string
+    description: string
+    kind: 'overview' | 'tutorial' | 'guide' | 'reference' | 'component'
+    group: string
+    groupId: string
+    section: string
+    sectionId: string
+    slug: string
+    status: string
+    draft: boolean
+    hidden: boolean
+    headings: Array<{ depth: number; title: string; id: string }>
+  }
 export interface DocsDemo {
   id: string
   title: string
@@ -146,8 +227,11 @@ export class DevServer extends EventEmitter {
 }
 
 export function version(): string
-export function bundle(options: BuildOptions): Promise<BundleResult>
+export function bundle(options: BundleOptions): Promise<BundleResult>
 export function build(options?: BuildOptions): Promise<BuildResult>
+export function buildLibrary(options?: LibraryBuildOptions): Promise<LibraryBuildResult>
+export function generateCssToken(options?: GenerateCssTokenOptions): Promise<GenerateCssTokenResult>
+export function generateDocgen(options?: GenerateDocgenOptions): Promise<GenerateDocgenResult>
 export function createBuildContext(options?: BuildOptions): Promise<BuildContext>
 export function startDevServer(options?: DevServerOptions): Promise<DevServer>
 export function buildDocs(options?: DocsBuildOptions): Promise<DocsBuildResult>
@@ -158,8 +242,11 @@ declare const wake: {
   DevServer: typeof DevServer
   WakeError: typeof WakeError
   build: typeof build
+  buildLibrary: typeof buildLibrary
   buildDocs: typeof buildDocs
   bundle: typeof bundle
+  generateCssToken: typeof generateCssToken
+  generateDocgen: typeof generateDocgen
   createBuildContext: typeof createBuildContext
   startDevServer: typeof startDevServer
   startDocsDevServer: typeof startDocsDevServer

package/index.mjs

@@ -5,8 +5,11 @@ export const {
   DevServer,
   WakeError,
   build,
+  buildLibrary,
   buildDocs,
   bundle,
+  generateCssToken,
+  generateDocgen,
   createBuildContext,
   startDevServer,
   startDocsDevServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crab-dev/wake",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Wake native web build tools for Node.js",
   "license": "MIT OR Apache-2.0",
   "repository": {
@@ -64,7 +64,7 @@
     "@crab-dev/rc-text-edit": "^0.0.1",
     "@crab-dev/rc-tooltip": "^0.0.2",
     "@crab-dev/rc-tree": "^0.1.2",
-    "@linaria/core": "^8.1.1",
+    "@crab-dev/css": "0.1.18",
     "lucide-react": "^1.23.0"
   },
   "peerDependencies": {
@@ -72,11 +72,11 @@
     "react-dom": "^19.2.8"
   },
   "optionalDependencies": {
-    "@crab-dev/wake-darwin-arm64": "0.1.16",
-    "@crab-dev/wake-darwin-x64": "0.1.16",
-    "@crab-dev/wake-linux-arm64-gnu": "0.1.16",
-    "@crab-dev/wake-linux-x64-gnu": "0.1.16",
-    "@crab-dev/wake-win32-x64-msvc": "0.1.16"
+    "@crab-dev/wake-darwin-arm64": "0.1.18",
+    "@crab-dev/wake-darwin-x64": "0.1.18",
+    "@crab-dev/wake-linux-arm64-gnu": "0.1.18",
+    "@crab-dev/wake-linux-x64-gnu": "0.1.18",
+    "@crab-dev/wake-win32-x64-msvc": "0.1.18"
   },
   "publishConfig": {
     "access": "public",