@crab-dev/wake 0.1.17 → 0.1.18

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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.

package/README.md

@@ -9,9 +9,13 @@ npx wake build
 ```
 
 ```js
-import { build, bundle, 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)
@@ -46,6 +50,22 @@ 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,8 +3,11 @@
 import { readFile } from 'node:fs/promises'
 import {
   build,
+  buildLibrary,
   buildDocs,
   bundle,
+  generateCssToken,
+  generateDocgen,
   startDevServer,
   startDocsDevServer,
   version,
@@ -20,6 +23,7 @@ import {
   formatBuildResult,
   formatError,
   formatFinalSummary,
+  formatGeneratorResult,
   formatServerReady,
   observeServer,
   setDashboardEndpoint,
@@ -37,6 +41,7 @@ Usage:
   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]
@@ -302,6 +307,27 @@ export async function runCli(argv = process.argv.slice(2)) {
     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')

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'
@@ -57,7 +69,7 @@ export interface BundleOptions extends ProjectOptions {
 
 export interface OutputFile {
   path: string
-  kind: 'chunk' | 'css' | 'asset' | 'html' | 'map'
+  kind: 'entry' | 'chunk' | 'css' | 'declaration' | 'asset' | 'html' | 'map'
   bytes: number
 }
 
@@ -87,6 +99,47 @@ export interface BundleResult {
   diagnostics: Diagnostic[]
 }
 
+export interface LibraryBuildOptions {
+  cwd?: string
+  entry?: string
+  signal?: AbortSignal
+}
+
+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 {
@@ -176,6 +229,9 @@ export class DevServer extends EventEmitter {
 export function version(): string
 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>
@@ -186,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.17",
+  "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",
-    "@crab-dev/css": "0.1.17",
+    "@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.17",
-    "@crab-dev/wake-darwin-x64": "0.1.17",
-    "@crab-dev/wake-linux-arm64-gnu": "0.1.17",
-    "@crab-dev/wake-linux-x64-gnu": "0.1.17",
-    "@crab-dev/wake-win32-x64-msvc": "0.1.17"
+    "@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",