@tinycld/bootstrap 1.1.0 → 2.0.0

package/dist/link-package.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { confirm, isCancel, log, spinner } from '@clack/prompts';
 import pc from 'picocolors';
-import { bootstrapTooling } from "./bootstrap-tooling.js";
+import { assembleWorkspace } from "./assemble-workspace.js";
 import { looksLikeWorkspaceRoot } from "./layout.js";
 /**
  * Add `slug` to `<workspaceDir>/package.json` `workspaces[]` if it isn't already
@@ -29,14 +29,15 @@ export function ensureMember(workspaceDir, slug) {
  * symlink and the root `postinstall` runs the generator.
  *
  * Two shapes, distinguished by whether `workspaceDir` is already a workspace root:
- *   - attach: `workspaceDir` already holds the workspace meta-repo (its
+ *   - attach: `workspaceDir` is already an assembled workspace root (its
  *     package.json name is `@tinycld/workspace`). No assembly — just ensure the
  *     member and install. The existing root package.json is left untouched.
  *   - bootstrap: `workspaceDir` is a fresh wrapper that only contains the
- *     scaffolded `<slug>/` so far. Assemble the workspace *around* it — write the
- *     workspace manifest and clone app + core via `bootstrapTooling` — then
- *     ensure the new member and install. The `postinstall` (`cd app && …`) only
- *     succeeds once `app/` exists, which is why we assemble before installing.
+ *     scaffolded `<slug>/` so far. Assemble the workspace *around* it —
+ *     `assembleWorkspace` generates the root scaffolding and clones app + core
+ *     (no workspace meta-repo) — then ensure the new member and install. The
+ *     `postinstall` (`cd app && …`) only succeeds once `app/` exists, which is
+ *     why we assemble before installing.
  *
  * Returns true if the user chose to link (even if a subprocess failed — the
  * error is already logged, and we don't want to follow up with manual steps
@@ -50,7 +51,7 @@ export async function offerLinkPackage({ slug, workspaceDir, mode, assemble = re
     const needsClone = !looksLikeWorkspaceRoot(workspaceDir);
     if (mode === 'prompt') {
         const message = needsClone
-            ? `Clone the tinycld workspace (app + core) and link ${pc.bold(slug)} now?`
+            ? `Assemble the tinycld workspace (app + core) and link ${pc.bold(slug)} now?`
             : `Link ${pc.bold(slug)} into the workspace now?`;
         const answer = await confirm({ message, initialValue: true });
         if (isCancel(answer) || answer !== true)
@@ -83,11 +84,11 @@ export async function offerLinkPackage({ slug, workspaceDir, mode, assemble = re
 /**
  * Assemble the workspace skeleton at `dir`: write the workspace manifest and
  * clone app + core (honoring `TINYCLD_REPO_BASE` for keyless/HTTPS envs).
- * `bootstrapTooling` is synchronous and throws on failure (unknown member, etc.);
+ * `assembleWorkspace` is synchronous and throws on failure (unknown member, etc.);
  * `offerLinkPackage` wraps the call so the error surfaces in the spinner.
  */
 function realAssemble(dir) {
-    bootstrapTooling({ root: dir, repoBase: process.env.TINYCLD_REPO_BASE });
+    assembleWorkspace({ root: dir, repoBase: process.env.TINYCLD_REPO_BASE });
 }
 function realInstall(cwd) {
     const r = spawnSync('npm', ['install'], { cwd, stdio: 'pipe', encoding: 'utf8' });

package/dist/link-package.js.map

@@ -1 +1 @@
-{"version":3,"file":"link-package.js","sourceRoot":"","sources":["../src/link-package.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"link-package.js","sourceRoot":"","sources":["../src/link-package.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tinycld/bootstrap",
-    "version": "1.1.0",
+    "version": "2.0.0",
     "description": "Scaffolder for @tinycld feature packages",
     "type": "module",
     "license": "MIT",
@@ -19,7 +19,8 @@
         "access": "public"
     },
     "scripts": {
-        "build": "tsc",
+        "clean": "rm -rf dist",
+        "build": "npm run clean && tsc",
         "dev": "tsx src/index.ts",
         "lint": "biome check .",
         "lint:fix": "biome check --write .",

package/templates/shared/.github/workflows/ci.yml

@@ -18,30 +18,29 @@ jobs:
     name: Typecheck & Unit
     runs-on: ubuntu-latest
     steps:
-      # 1. The workspace meta-repo becomes the job root.
-      - uses: actions/checkout@v5
-        with:
-          repository: tinycld/workspace
-          ref: main
-          path: ws
-      # 2. This PR's code, checked out into the member slot.
+      # 1. This PR's code, checked out into the member slot.
       - uses: actions/checkout@v5
         with:
           path: ws/${{ env.PACKAGE }}
+      # 2. Pin a Node that satisfies bootstrap's engines.node (>=24) so the
+      #    assemble step below doesn't depend on whatever ubuntu-latest ships.
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      # 3. Assemble the workspace root: writes package.json + tinycld.packages.ts
+      #    from bootstrap's embedded templates, clones app + core as siblings.
+      #    The PR's PACKAGE dir is already there and is skipped.
+      - name: Assemble workspace (app + core)
+        working-directory: ws
+        run: TINYCLD_REPO_BASE=https://github.com/tinycld npx @tinycld/bootstrap@latest --assemble-only
+      # 4. Now switch to the version the assembled workspace pins (ws/.node-version
+      #    is written by the assemble step above).
       - uses: actions/setup-node@v5
         with:
           node-version-file: ws/.node-version
-          cache: npm
-          cache-dependency-path: ws/package-lock.json
       - uses: actions/setup-go@v6
         with:
           go-version-file: ws/.go-version
-      # 3. Clone app + core (the PR's PACKAGE is already checked out into its
-      #    slot; bootstrap --tooling skips dirs that already exist). A sibling
-      #    only needs app + core + itself to typecheck + unit-test.
-      - name: Assemble workspace (app + core)
-        working-directory: ws
-        run: TINYCLD_REPO_BASE=https://github.com/tinycld npx @tinycld/bootstrap@latest --tooling
       - name: Install (workspace root)
         working-directory: ws
         run: npm install
@@ -53,25 +52,24 @@ jobs:
     name: E2E
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-        with:
-          repository: tinycld/workspace
-          ref: main
-          path: ws
       - uses: actions/checkout@v5
         with:
           path: ws/${{ env.PACKAGE }}
+      # Pin a Node that satisfies bootstrap's engines.node (>=24) so the
+      # assemble step below doesn't depend on whatever ubuntu-latest ships.
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+      - name: Assemble workspace (app + core)
+        working-directory: ws
+        run: TINYCLD_REPO_BASE=https://github.com/tinycld npx @tinycld/bootstrap@latest --assemble-only
+      # Switch to the version the assembled workspace pins.
       - uses: actions/setup-node@v5
         with:
           node-version-file: ws/.node-version
-          cache: npm
-          cache-dependency-path: ws/package-lock.json
       - uses: actions/setup-go@v6
         with:
           go-version-file: ws/.go-version
-      - name: Assemble workspace (app + core)
-        working-directory: ws
-        run: TINYCLD_REPO_BASE=https://github.com/tinycld npx @tinycld/bootstrap@latest --tooling
       - name: Install (workspace root)
         working-directory: ws
         run: npm install

package/templates/shared/README.md

@@ -17,9 +17,10 @@ linked by a single `npm install` at the root.
 # In a fresh workspace directory, clone this package into a member slot…
 git clone git@github.com:tinycld/{{PKG_SLUG}}.git
 
-# …then pull in the rest of the workspace tooling (app + core + the root
-# package.json / lockfile). bootstrap --tooling skips dirs that already exist.
-npx @tinycld/bootstrap@latest --tooling
+# …then assemble the rest of the workspace (app + core + the workspace
+# package.json / tinycld.packages.ts). bootstrap --assemble-only skips
+# dirs that already exist.
+npx @tinycld/bootstrap@latest --assemble-only
 
 # Link every member with one install at the WORKSPACE ROOT (never inside a
 # member — siblings have no node_modules of their own; deps hoist to the root).
@@ -49,11 +50,11 @@ There is no `biome.json` in this repo — biome lives only in the app shell and
 ## CI
 
 `.github/workflows/ci.yml` runs typecheck, unit tests, and e2e on every push to
-`main` and every PR. It checks out `tinycld/workspace` as the job root, drops
-this PR's code into its member slot, assembles `app` + `core` via
-`@tinycld/bootstrap --tooling`, installs at the workspace root, and runs
-`tinycld-pkg check` / `tinycld-pkg test:e2e` — exactly what a developer runs
-locally.
+`main` and every PR. It checks out this PR's code into a member slot, assembles
+the rest of the workspace (`app` + `core` + the workspace `package.json` and
+coordination files) via `npx @tinycld/bootstrap --assemble-only`, installs at
+the workspace root, and runs `tinycld-pkg check` / `tinycld-pkg test:e2e` —
+exactly what a developer runs locally.
 
 ## Package anatomy
 

package/templates/workspace/.go-version

@@ -0,0 +1 @@
+1.25.0

package/templates/workspace/.node-version

@@ -0,0 +1 @@
+25

package/templates/workspace/tests/expo-clipboard-stub.ts

@@ -0,0 +1,20 @@
+// Test-only stub for expo-clipboard. The real package transitively
+// imports expo-modules-core, which has too many side effects to load
+// under a Node test environment (it touches several globals expected
+// to be set up by Metro/RN). Tests get a minimal in-memory shim that
+// records the last-written text and returns it on read.
+
+let text = ''
+
+export async function setStringAsync(s: string): Promise<void> {
+    text = s
+}
+
+export async function getStringAsync(): Promise<string> {
+    return text
+}
+
+// Test-only escape hatch: reset the in-memory clipboard between tests.
+export function __resetClipboardTextForTest(): void {
+    text = ''
+}

package/templates/workspace/tests/expo-router-stub.ts

@@ -0,0 +1,48 @@
+// Test-only stub for expo-router. The real package's CJS entry
+// (build/index.js) does `require("./global")` at module top, which
+// Node's CJS resolver can't satisfy when the calling file is reached
+// through a sibling-symlink path (Vite SSR's preserveSymlinks=false
+// means imports under packages/@tinycld/<sibling>/... resolve via the
+// sibling's real filesystem location, where node_modules don't reach
+// expo-router).
+//
+// Tests that need to load a real screen, hook, or side-effect module
+// from a sibling package import this stub instead. It surfaces the
+// minimal API actually used at module-top by sibling source — the
+// `router` object plus a few component shells. Tests that care about
+// hook behavior should still mock those hooks individually with
+// vi.mock; this stub only exists so the module graph can finish
+// loading.
+
+import { vi } from 'vitest'
+
+const noop = () => {}
+const ComponentStub = () => null
+
+export const router = {
+    push: vi.fn(noop),
+    replace: vi.fn(noop),
+    back: vi.fn(noop),
+    canGoBack: vi.fn(() => true),
+    setParams: vi.fn(noop),
+    navigate: vi.fn(noop),
+    dismissAll: vi.fn(noop),
+    dismiss: vi.fn(noop),
+}
+
+export const Link = ComponentStub
+export const Stack = Object.assign(ComponentStub, { Screen: ComponentStub })
+export const Tabs = Object.assign(ComponentStub, { Screen: ComponentStub })
+export const Slot = ComponentStub
+export const Redirect = ComponentStub
+export const Drawer = Object.assign(ComponentStub, { Screen: ComponentStub })
+
+export const useRouter = () => router
+export const usePathname = () => '/'
+export const useSegments = () => []
+export const useLocalSearchParams = () => ({})
+export const useGlobalSearchParams = () => ({})
+export const useFocusEffect = (_cb: () => void) => {}
+export const useNavigation = () => ({})
+export const useRootNavigationState = () => ({ key: 'test' })
+export const Href = undefined

package/templates/workspace/tests/lucide-react-native-stub.cjs

@@ -0,0 +1,73 @@
+// Test-only stub for `lucide-react-native`. The real bundle pulls
+// in `react-native-svg`, whose source uses TypeScript syntax that
+// Vitest's transformer doesn't apply to node_modules. We don't
+// render icons in unit tests anyway — assertions about icon
+// rendering belong in Playwright.
+//
+// Implemented as CJS (.cjs) so we can use a Proxy on module.exports.
+// Any named-icon import (ExternalLink, AlertTriangle, …) yields the
+// same harmless component stub. Tests that genuinely need a real
+// icon should reach for vi.mock locally; this stub only exists so
+// the module graph can finish loading from sibling source under
+// packages/@tinycld/<sibling>/... where the real bundle would crash.
+//
+// Vitest's ES↔CJS interop reads named exports from Object.keys() on
+// the CJS module.exports, so the Proxy's `get` trap alone isn't
+// enough — ESM `import { Heading1 } from '...'` requires Heading1 to
+// appear as an own property. We pre-populate the dictionary with
+// every Lucide identifier referenced from the codebase so static
+// imports resolve to the Stub function; the Proxy handles any
+// additional dynamic lookups (a defensive fallback).
+
+const Stub = () => null
+
+// Lucide icon names referenced by import statements anywhere in the
+// codebase. Add new names here when a new icon is imported. The list
+// is overinclusive on purpose: a missing entry would surface as an
+// `undefined` named import in tests that try to render the icon,
+// which is harder to diagnose than an unused name.
+const NAMES = [
+    'AlertCircle', 'AlertTriangle', 'AlignCenter', 'AlignJustify', 'AlignLeft', 'AlignRight',
+    'Archive', 'ArrowDown', 'ArrowDownToLine', 'ArrowLeft', 'ArrowRight', 'ArrowUp',
+    'AtSign', 'Bell', 'BellOff', 'Bold', 'Book', 'BookOpen', 'Bot', 'Box', 'Calendar',
+    'Camera', 'Check', 'CheckCircle', 'CheckSquare', 'ChevronDown', 'ChevronLeft',
+    'ChevronRight', 'ChevronUp', 'Circle', 'Clipboard', 'Clock', 'Cloud', 'CloudOff',
+    'Code', 'Code2', 'Columns', 'Copy', 'CornerDownLeft', 'Cpu', 'CreditCard', 'Crop',
+    'Database', 'Download', 'Edit', 'Edit2', 'Edit3', 'ExternalLink', 'Eye', 'EyeOff',
+    'File', 'FileText', 'Files', 'Filter', 'Flag', 'Folder', 'FolderOpen', 'Forward',
+    'Globe', 'GraduationCap', 'Grid', 'HardDrive', 'Hash', 'Headphones', 'Heading1',
+    'Heading2', 'Heading3', 'Heading4', 'Heading5', 'Heading6', 'HelpCircle', 'Highlighter',
+    'Home', 'Image', 'Inbox', 'Info', 'Italic', 'Key', 'Keyboard', 'Languages', 'Layout',
+    'Link', 'Link2', 'List', 'ListChecks', 'ListOrdered', 'Loader', 'Lock', 'LogIn',
+    'LogOut', 'Mail', 'MailOpen', 'Map', 'Maximize', 'Maximize2', 'MenuIcon', 'Menu',
+    'MessageCircle', 'MessageSquare', 'Mic', 'MicOff', 'Minimize', 'Minimize2', 'Minus',
+    'MonitorSmartphone', 'MoreHorizontal', 'MoreVertical', 'Move', 'Music', 'Package',
+    'Palette', 'Paperclip', 'Pause', 'Pencil', 'Phone', 'PieChart', 'Pin', 'PinOff',
+    'Play', 'Plus', 'PlusCircle', 'Pointer', 'Power', 'Printer', 'Quote', 'RefreshCcw',
+    'RefreshCw', 'Replace', 'ReplaceAll', 'Reply', 'ReplyAll', 'RotateCcw', 'Save', 'Search', 'Send', 'Server',
+    'Settings', 'Settings2', 'Share', 'Share2', 'Shield', 'ShieldCheck', 'Shuffle',
+    'Sidebar', 'Slack', 'SlidersHorizontal', 'Smartphone', 'Smile', 'Sparkles',
+    'Speaker', 'Square', 'Star', 'Strikethrough', 'Subscript', 'Sun', 'Superscript',
+    'Table', 'Tag', 'Terminal', 'TestTube', 'Trash', 'Trash2', 'TrendingDown',
+    'TrendingUp', 'Triangle', 'Type', 'Underline', 'Undo', 'Unlock', 'Upload',
+    'User', 'UserCheck', 'UserPlus', 'Users', 'Video', 'VideoOff', 'Volume', 'Volume2',
+    'VolumeX', 'Wifi', 'WifiOff', 'WrapText', 'X', 'XCircle', 'XSquare', 'Zap',
+    'ZoomIn', 'ZoomOut',
+]
+
+const exports = { default: Stub }
+for (const name of NAMES) {
+    exports[name] = Stub
+}
+exports.__esModule = true
+
+module.exports = new Proxy(exports, {
+    get(target, prop) {
+        if (typeof prop === 'symbol') return Reflect.get(target, prop)
+        if (prop in target) return target[prop]
+        // Unknown icon name: return the Stub anyway so dynamic
+        // lookups don't crash. Static `import { Foo }` will already
+        // have been resolved against `target` above.
+        return Stub
+    },
+})

package/templates/workspace/tests/tinycld.packages.test.ts

@@ -0,0 +1,54 @@
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { getPackages, resetPackagesCache } from '../tinycld.packages'
+
+// Build a fake workspace tree and point getPackages at it via TINYCLD_WS_ROOT.
+function makeWorkspace(): string {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'tcld-ws-'))
+    // core member: package.json name @tinycld/core, NO manifest.ts
+    fs.mkdirSync(path.join(root, 'core'), { recursive: true })
+    fs.writeFileSync(
+        path.join(root, 'core', 'package.json'),
+        JSON.stringify({ name: '@tinycld/core' })
+    )
+    // feature member: contacts with manifest.ts + named package.json
+    fs.mkdirSync(path.join(root, 'contacts'), { recursive: true })
+    fs.writeFileSync(path.join(root, 'contacts', 'manifest.ts'), 'export default {}')
+    fs.writeFileSync(
+        path.join(root, 'contacts', 'package.json'),
+        JSON.stringify({ name: '@tinycld/contacts' })
+    )
+    // app shell: package.json name "app", NO manifest.ts
+    fs.mkdirSync(path.join(root, 'app'), { recursive: true })
+    fs.writeFileSync(path.join(root, 'app', 'package.json'), JSON.stringify({ name: 'app' }))
+    return root
+}
+
+describe('getPackages (new layout)', () => {
+    let root: string
+    beforeEach(() => {
+        root = makeWorkspace()
+        process.env.TINYCLD_WS_ROOT = root
+        resetPackagesCache()
+    })
+    afterEach(() => {
+        delete process.env.TINYCLD_WS_ROOT
+        fs.rmSync(root, { recursive: true, force: true })
+    })
+
+    it('includes core (member named @tinycld/core, no manifest) plus feature members with a manifest.ts', () => {
+        const pkgs = getPackages()
+        expect(pkgs).toContain('@tinycld/core')
+        expect(pkgs).toContain('@tinycld/contacts')
+    })
+
+    it('excludes the app shell (named "app", no manifest.ts)', () => {
+        expect(getPackages()).not.toContain('app')
+    })
+
+    it('lists core first (stable order: core, then features sorted)', () => {
+        expect(getPackages()[0]).toBe('@tinycld/core')
+    })
+})

package/templates/workspace/tests/unit-setup.ts

@@ -0,0 +1,55 @@
+import { vi } from 'vitest'
+
+process.env.EXPO_PUBLIC_ENV ??= 'test'
+
+// tinycld.config.ts is the runtime source of truth, but loading the real one
+// pulls every linked package's collections/screens (and their un-mockable RN
+// surface) into the test graph. Shim it to an empty config so unit tests stay
+// light; tests that need specific packages can override per-file.
+vi.mock('@tinycld/app-generated/tinycld-config', () => ({
+    tinycldConfig: [],
+}))
+
+vi.mock('@sentry/react-native', () => ({
+    init: vi.fn(),
+    captureException: vi.fn(),
+    withScope: vi.fn(),
+}))
+
+// React Native's entry uses Flow syntax Vite/Rollup can't parse. Substitute
+// the minimal surface our tests touch.
+vi.mock('react-native', () => ({
+    Platform: { OS: 'web' },
+    Dimensions: {
+        get: () => ({ width: 1024, height: 768 }),
+        addEventListener: () => ({ remove: () => {} }),
+    },
+}))
+
+// @react-native-async-storage/async-storage requires the RN module bridge and
+// is pulled in transitively by `~/lib/store`. Substitute a minimal in-memory
+// shim so tests can exercise the Zustand registry without RN.
+vi.mock('@react-native-async-storage/async-storage', () => {
+    const store = new Map<string, string>()
+    const api = {
+        getItem: async (key: string) => store.get(key) ?? null,
+        setItem: async (key: string, value: string) => {
+            store.set(key, value)
+        },
+        removeItem: async (key: string) => {
+            store.delete(key)
+        },
+        clear: async () => {
+            store.clear()
+        },
+        getAllKeys: async () => Array.from(store.keys()),
+        multiGet: async (keys: string[]) => keys.map(k => [k, store.get(k) ?? null]),
+        multiSet: async (pairs: [string, string][]) => {
+            for (const [k, v] of pairs) store.set(k, v)
+        },
+        multiRemove: async (keys: string[]) => {
+            for (const k of keys) store.delete(k)
+        },
+    }
+    return { default: api, ...api }
+})

package/templates/workspace/tinycld.packages.ts

@@ -0,0 +1,75 @@
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+
+// New flat layout: every package (core, app, features) is a direct member dir
+// under the workspace root. core is the member whose package.json name is
+// "@tinycld/core" (it has no manifest.ts). Feature members are dirs with a
+// manifest.ts. Members without a manifest.ts are excluded (this includes the app shell).
+//
+// TINYCLD_WS_ROOT overrides the workspace root for tests that scan a fake tree.
+// It is resolved at call time (not module load) so that tests can set it in
+// beforeEach after the module is already imported.
+const CORE_NAME = '@tinycld/core'
+
+let cached: string[] | null = null
+
+/**
+ * Returns the package names linked into the app, core first then features
+ * sorted by name. Core is the member named "@tinycld/core" (no manifest.ts);
+ * feature members are dirs containing a manifest.ts with a named package.json.
+ * The app shell is excluded. Cached per process; reset with resetPackagesCache().
+ */
+export function getPackages(): string[] {
+    if (cached) return cached
+
+    const wsRoot = process.env.TINYCLD_WS_ROOT
+        ? path.resolve(process.env.TINYCLD_WS_ROOT)
+        : path.resolve(import.meta.dirname)
+
+    let core: string | null = null
+    const features: string[] = []
+
+    if (fs.existsSync(wsRoot)) {
+        for (const entry of fs.readdirSync(wsRoot)) {
+            const dir = path.join(wsRoot, entry)
+            if (!isDir(dir)) continue
+            const pkgJsonPath = path.join(dir, 'package.json')
+            if (!fs.existsSync(pkgJsonPath)) continue
+            let name: unknown
+            try {
+                name = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8')).name
+            } catch {
+                continue // unreadable package.json
+            }
+            if (typeof name !== 'string' || name.length === 0) continue
+            if (name === CORE_NAME) {
+                core = name
+                continue
+            }
+            if (hasManifest(dir)) features.push(name)
+        }
+    }
+
+    features.sort()
+    cached = core ? [core, ...features] : features
+    return cached
+}
+
+// Test-only: clear the per-process cache so a fresh TINYCLD_WS_ROOT is read.
+export function resetPackagesCache(): void {
+    cached = null
+}
+
+function hasManifest(dir: string): boolean {
+    return (
+        fs.existsSync(path.join(dir, 'manifest.ts')) || fs.existsSync(path.join(dir, 'manifest.js'))
+    )
+}
+
+function isDir(p: string): boolean {
+    try {
+        return fs.statSync(p).isDirectory()
+    } catch {
+        return false
+    }
+}

package/templates/workspace/vitest.config.ts

@@ -0,0 +1,104 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { defineConfig } from 'vitest/config'
+
+// Workspace-root vitest config. Supplies dedup pins, stub aliases, and the
+// react-native/expo/sentry mocks that let the broader core suite run under
+// Node without the Metro/RN runtime.
+const ROOT = import.meta.dirname
+const CORE_DIR = path.join(ROOT, 'core')
+const APP_GENERATED = path.join(ROOT, 'app', 'lib', 'generated')
+
+// Locate a hoisted dependency's dir. In this workspace layout deps hoist to
+// the workspace-root node_modules (all members declare framework deps as
+// peerDependencies only, so the app shell's direct deps live in
+// node_modules/ here at the root). Falls back one level up (CI layouts where
+// the workspace root is nested under another root).
+const pkgDir = (pkg: string): string => {
+    for (const root of [path.join(ROOT, 'node_modules'), path.join(ROOT, '..', 'node_modules')]) {
+        const candidate = path.join(root, pkg)
+        if (fs.existsSync(candidate)) return candidate
+    }
+    return path.join(ROOT, 'node_modules', pkg)
+}
+
+export default defineConfig({
+    resolve: {
+        alias: [
+            // --- dedup pins (Vite SSR resolver differs from Metro; keep until
+            //     a test proves the workspace dedupes these on its own) ---
+            { find: /^react$/, replacement: path.join(pkgDir('react'), 'index.js') },
+            {
+                find: /^react\/jsx-runtime$/,
+                replacement: path.join(pkgDir('react'), 'jsx-runtime.js'),
+            },
+            {
+                find: /^react\/jsx-dev-runtime$/,
+                replacement: path.join(pkgDir('react'), 'jsx-dev-runtime.js'),
+            },
+            // yjs/y-protocols use instanceof checks; a duplicate copy reached
+            // through a member symlink breaks nested Y.Map.set. Pin to the
+            // single install.
+            { find: /^yjs$/, replacement: pkgDir('yjs') },
+            { find: /^y-protocols\/(.+)$/, replacement: `${pkgDir('y-protocols')}/$1` },
+            // hyperformula's ESM build has broken relative imports under Vite
+            // SSR; pin to the self-consistent commonjs entry.
+            {
+                find: /^hyperformula$/,
+                replacement: path.join(pkgDir('hyperformula'), 'commonjs/index.js'),
+            },
+            // --- @tinycld/core path remaps. Unlike Metro, Vite's exports-map
+            //     resolution does NOT do directory-index fallback, so
+            //     `@tinycld/core/lib/notify` (a dir → lib/notify/index.ts) fails
+            //     to load through the exports wildcard. Remap straight to the
+            //     core source path, which Vite resolves with its own extension
+            //     + index probing.
+            {
+                find: /^@tinycld\/core$/,
+                replacement: path.join(CORE_DIR, 'index.ts'),
+            },
+            {
+                find: /^@tinycld\/core\/(.+)$/,
+                replacement: `${CORE_DIR}/$1`,
+            },
+            // --- @tinycld/app-generated/* build-time contract (written to
+            //     app/lib/generated/ by the generator; Vitest doesn't read
+            //     tsconfig paths) ---
+            {
+                find: /^@tinycld\/app-generated\/(.+)$/,
+                replacement: `${APP_GENERATED}/$1`,
+            },
+            // --- test doubles ---
+            // expo-clipboard transitively pulls in expo-modules-core, whose
+            // module-load-time side effects don't survive a bare Node test env.
+            {
+                find: /^expo-clipboard$/,
+                replacement: path.join(ROOT, 'tests/expo-clipboard-stub.ts'),
+            },
+            // expo-router's CJS entry does `require("./global")` at module top,
+            // which Node can't resolve when reached through a member symlink.
+            {
+                find: /^expo-router$/,
+                replacement: path.join(ROOT, 'tests/expo-router-stub.ts'),
+            },
+            // lucide-react-native pulls in react-native-svg (TS source, not
+            // transformed in node_modules under Vitest); a CJS Proxy stub
+            // yields a harmless component for any named icon import.
+            {
+                find: /^lucide-react-native$/,
+                replacement: path.join(ROOT, 'tests/lucide-react-native-stub.cjs'),
+            },
+        ],
+    },
+    test: {
+        environment: 'node',
+        include: [
+            'tests/**/*.test.{ts,tsx}',
+            'core/**/__tests__/**/*.test.{ts,tsx}',
+            'core/**/*.test.{ts,tsx}',
+            'app/scripts/**/__tests__/**/*.test.{ts,tsx}',
+            'package-scripts/tests/**/*.test.{ts,tsx}',
+        ],
+        setupFiles: ['tests/unit-setup.ts'],
+    },
+})