@antigenic-oss/paint 0.2.2 → 0.2.4

package/README.md

@@ -48,6 +48,27 @@ bun add -g @antigenic-oss/paint
 
 Requires Node.js `>=20.9.0`.
 
+If `paint` is not found after install, add your global bin directory to `PATH`
+once:
+
+```bash
+# Bun
+echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
+
+# npm (uses npm global prefix)
+echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
+
+# pnpm
+pnpm setup
+```
+
+After install, run:
+
+```bash
+paint help
+paint start
+```
+
 Then use:
 
 ```bash

package/bin/paint.js

@@ -271,7 +271,9 @@ function ensureBuilt(forceRebuild) {
   console.log(
     forceRebuild ? 'Rebuilding pAInt…' : 'Building pAInt for first run…',
   )
-  const result = spawnSync(process.execPath, [NEXT_BIN, 'build'], {
+  // Use webpack for packaged/global runtime builds.
+  // Turbopack can fail when the app lives under node_modules.
+  const result = spawnSync(process.execPath, [NEXT_BIN, 'build', '--webpack'], {
     cwd: APP_ROOT,
     env: process.env,
     stdio: 'inherit',

package/bin/postinstall.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+const path = require('node:path')
+const fs = require('node:fs')
+const { spawnSync } = require('node:child_process')
+
+function detectRcFile() {
+  const shell = process.env.SHELL || ''
+  const home = process.env.HOME || '~'
+  const base = path.basename(shell)
+
+  if (base === 'zsh') return `${home}/.zshrc`
+  if (base === 'bash') return `${home}/.bashrc`
+  if (base === 'fish') return `${home}/.config/fish/config.fish`
+  return `${home}/.profile`
+}
+
+function shouldPrintHint() {
+  const isGlobal = process.env.npm_config_global === 'true'
+  const ua = process.env.npm_config_user_agent || ''
+  const isBun = ua.includes('bun/')
+  return isGlobal || isBun
+}
+
+function resolveNextBin(appRoot) {
+  const directPath = path.join(
+    appRoot,
+    'node_modules',
+    'next',
+    'dist',
+    'bin',
+    'next',
+  )
+  if (fs.existsSync(directPath)) {
+    return directPath
+  }
+
+  try {
+    return require.resolve('next/dist/bin/next', { paths: [appRoot] })
+  } catch {
+    return null
+  }
+}
+
+function tryWarmBuild() {
+  if (process.env.PAINT_SKIP_POSTINSTALL_BUILD === '1') {
+    return
+  }
+
+  const appRoot = path.resolve(__dirname, '..')
+  const buildIdPath = path.join(appRoot, '.next', 'BUILD_ID')
+  if (fs.existsSync(buildIdPath)) {
+    return
+  }
+
+  const nextBin = resolveNextBin(appRoot)
+  if (!nextBin) {
+    return
+  }
+
+  console.log('@antigenic-oss/paint: prebuilding runtime (webpack)...')
+  const result = spawnSync(
+    process.execPath,
+    [nextBin, 'build', '--webpack'],
+    {
+      cwd: appRoot,
+      env: process.env,
+      stdio: 'inherit',
+    },
+  )
+
+  // Keep install resilient across package managers/environments where
+  // install-time build is unsupported; first-run build remains as fallback.
+  if (result.status !== 0) {
+    console.warn(
+      '@antigenic-oss/paint: postinstall prebuild failed, will build on first `paint start`.',
+    )
+  }
+}
+
+tryWarmBuild()
+
+if (shouldPrintHint()) {
+  const rcFile = detectRcFile()
+  const exportLine = 'export PATH="$HOME/.bun/bin:$PATH"'
+  console.log('\n@antigenic-oss/paint: if `paint` is not found, run:')
+  console.log(`echo '${exportLine}' >> ${rcFile} && source ${rcFile}`)
+  console.log('Then run: paint help\n')
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antigenic-oss/paint",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Visual editor for localhost web projects with a global paint CLI",
   "license": "Apache-2.0",
   "homepage": "https://github.com/Antigenic-OSS/pAInt",
@@ -46,6 +46,7 @@
     "dev:terminal": "node ./bin/terminal-server.js",
     "dev:all": "node ./bin/terminal-server.js & node ./bin/bridge-server.js & next dev --port 4000 --turbopack",
     "bridge": "node ./bin/bridge-server.js",
+    "postinstall": "node ./bin/postinstall.js",
     "build": "next build",
     "start": "next start --port 4000",
     "lint": "biome lint .",

package/tsconfig.json

@@ -17,6 +17,7 @@
     "isolatedModules": true,
     "jsx": "react-jsx",
     "incremental": true,
+    "baseUrl": ".",
     "plugins": [
       {
         "name": "next"