@crossworks/app-build 0.232.112 → 0.232.122

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/app-build",
-  "version": "0.232.112",
+  "version": "0.232.122",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -8,13 +8,15 @@
     ".": "./src/index.ts"
   },
   "dependencies": {
+    "@mantle/share-ui": "npm:@crossworks/share-ui@0.232.122",
     "@tailwindcss/oxide": "^4.3.3",
     "esbuild": "^0.28.1",
-    "tailwindcss": "^4.3.3",
     "lucide-react": "^1.25.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "@mantle/share-ui": "npm:@crossworks/share-ui@0.232.112"
+    "tailwindcss": "^4.3.3",
+    "@mantle/config": "0.0.1",
+    "@mantle/std": "0.0.1"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",

package/scripts/build-runtime.ts

@@ -8,6 +8,7 @@
 import { existsSync } from 'node:fs';
 import * as path from 'node:path';
 import { buildRuntime } from '../src/build-runtime.ts';
+import { env } from '@mantle/config';
 
 /**
  * Where to write. Each Next app serves its own copy — the ACAO:* runtime has
@@ -36,8 +37,8 @@ import { buildRuntime } from '../src/build-runtime.ts';
  */
 const appArg = process.argv[2]?.trim();
 const appDir = path.resolve(process.cwd(), appArg ?? '.');
-const outDir = process.env.APP_RUNTIME_OUT
-  ? path.resolve(process.env.APP_RUNTIME_OUT)
+const outDir = env('APP_RUNTIME_OUT')
+  ? path.resolve(env('APP_RUNTIME_OUT'))
   : path.join(appDir, 'public/app-runtime');
 
 // Tripwire for the failure above: a Next app always has a `public/`, so its
@@ -45,7 +46,7 @@ const outDir = process.env.APP_RUNTIME_OUT
 // about to be written somewhere nothing serves. Fail loudly here rather than
 // print a cheerful success line pointing into node_modules. Skipped when
 // APP_RUNTIME_OUT names the destination outright.
-if (!process.env.APP_RUNTIME_OUT && !existsSync(path.join(appDir, 'public'))) {
+if (!env('APP_RUNTIME_OUT') && !existsSync(path.join(appDir, 'public'))) {
   console.error(
     `app-runtime: ${appDir} has no public/ directory, so it is not an app.\n` +
       `Run this from the app directory (paths resolve from the cwd), or pass an ` +

package/src/build-runtime.ts

@@ -126,7 +126,7 @@ export type RuntimeManifest = {
 
 /**
  * Build the shared runtime into `outDir` and return the manifest. The caller is
- * responsible for where `outDir` lives (apps/web/public/app-runtime) and for the
+ * responsible for where `outDir` lives (server/web/public/app-runtime) and for the
  * public URL prefix (`/app-runtime/`).
  */
 export async function buildRuntime(

package/src/index.ts

@@ -15,6 +15,7 @@ import { fileURLToPath } from 'node:url';
 import esbuild, { type BuildOptions, type Message, type Plugin } from 'esbuild';
 import { buildAppCss } from './css';
 import { KIT } from './kit';
+import { errorMessage } from '@mantle/std';
 
 /** Specifiers provided by the shared runtime via the iframe import map — marked
  *  external so they stay as bare imports in the app bundle. The react family is
@@ -330,7 +331,7 @@ export async function buildApp(
       warnings: [
         ...result.warnings,
         {
-          text: `app CSS compile failed (${err instanceof Error ? err.message : String(err)}); the app will rely on the host stylesheet`,
+          text: `app CSS compile failed (${errorMessage(err)}); the app will rely on the host stylesheet`,
           location: null,
         },
       ],
@@ -392,7 +393,7 @@ async function buildAppInner(source: AppSource): Promise<BuildResult> {
     }
     return {
       ok: false,
-      errors: [{ text: err instanceof Error ? err.message : String(err), location: null }],
+      errors: [{ text: errorMessage(err), location: null }],
       warnings: [],
       esbuildVersion: ESBUILD_VERSION,
     };

package/src/kit.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import { KIT } from './kit';
 
-// The @host kit module is a string mirror of packages/web-ui/src/app-bridge/protocol.ts (formerly apps/web/lib/app-bridge)
+// The @host kit module is a string mirror of packages/web-ui/src/app-bridge/protocol.ts (formerly server/web/lib/app-bridge)
 // (the sandbox can't import host code, so the shapes are duplicated by design).
 // These are drift tripwires: if a bridge kind is renamed or dropped on either
 // side, the app-facing API silently stops matching what the host answers.

package/src/kit.ts

@@ -3,7 +3,7 @@
  * app's `@/components/ui/*`, `@/lib/utils`, and `@host` imports to these sources
  * (served from memory by kitPlugin), so generated apps look native (same theme
  * tokens) and talk to the host over the bridge — with NO dependency on the
- * apps/web source tree or its node_modules at build time. React is bundled into
+ * server/web source tree or its node_modules at build time. React is bundled into
  * each app (each iframe is its own isolated document).
  *
  * These are SOURCE STRINGS (TSX/TS), not live modules. They are compiled ONCE
@@ -11,7 +11,7 @@
  * via the iframe import map — apps mark `react`/`@host`/`@/components/ui/*`
  * external rather than re-bundling them. Keep them dependency-light (only `react`
  * + `react-dom/client` in @host) and theme-token-only (never hardcode colours),
- * matching apps/web/CLAUDE.md.
+ * matching server/web/CLAUDE.md.
  */
 
 /** `cn` — minimal class joiner (no clsx/tailwind-merge dep). Generated apps
@@ -148,7 +148,7 @@ export function Separator({ className, orientation = 'horizontal', ...p }) {
  * host resolves them server-side. `__mount` (used by the generated entry) wires
  * the React root, an error boundary, the ready signal, and auto-resize.
  *
- * Mirrors apps/web/lib/app-bridge/protocol.ts — keep the message shapes in sync.
+ * Mirrors server/web/lib/app-bridge/protocol.ts — keep the message shapes in sync.
  */
 const HOST = `
 import * as React from 'react';

package/src/runtime-exports.ts

@@ -24,12 +24,13 @@
 import { readFile } from 'node:fs/promises';
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { env } from '@mantle/config';
 
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 
 /** In order of trust: explicit override, package-relative, cwd convention. */
 export function manifestCandidates(): string[] {
-  const override = process.env.MANTLE_APP_RUNTIME_MANIFEST;
+  const override = env('MANTLE_APP_RUNTIME_MANIFEST');
   return [
     ...(override ? [override] : []),
     // packages/app-build/src → <root>/server/web/public/app-runtime/manifest.json