lecodes-cli 2.4.1 → 2.4.3

package/src/project/ignore.ts

@@ -1,164 +1,164 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs"
-import { join } from "node:path"
-
-/*
- * `.lecodesignore` support — keeps scratch files (temp probes, render screenshots, logs) out of
- * `status` / `push` so they never land in a checkpoint. Syntax is a practical subset of .gitignore:
- *   - blank lines and `# comments` are skipped
- *   - `!pattern` re-includes something a previous pattern ignored
- *   - a trailing `/` matches directories only
- *   - a leading `/` (or any embedded `/`) anchors the pattern to the project root
- *   - `*` matches within a path segment, `**` across segments, `?` a single char
- *   - a slash-free pattern (e.g. `_*`, `*.png`) matches a basename at any depth
- *
- * IMPORTANT: ignores apply to UNTRACKED files only. A file already in the project (recorded in the
- * manifest) is always tracked, even if it matches a pattern — so ignoring `*.png` can never make an
- * existing image asset silently disappear from the project. Pruning happens in `scanLocal`.
- */
-
-export type IgnoreMatcher = (key: string, isDir: boolean) => boolean
-
-type Rule = { re: RegExp, negate: boolean, dirOnly: boolean }
-
-// Always applied, even with no .lecodesignore — only patterns that are never real project assets, so
-// they're safe as invisible defaults. Everything asset-shaped (*.png, *.json, …) is opt-in via the
-// file written at clone time (see DEFAULT_IGNORE_FILE). `.artifacts/` is `lecodes test`'s
-// failure-frame dump dir (tests/.artifacts/) — regenerated scratch, never a project asset.
-// `dist/` is `lecodes app build desktop`'s default output (<root>/dist/<slug>, appDesktop.ts) —
-// same class, but it must be ignored for a second, load-bearing reason: that folder holds a COPY of
-// the host's runtime assets (lit.filamat, uberarchive.bin, …). Collected as project assets they get
-// staged next to the bundle, and onFetchLocal searches the bundle's dir BEFORE the host's assets dir
-// (main.cpp) — so the copy shadows the host's own. Harmless while every host was OpenGL and the
-// bytes matched; fatal once a build output can come from the Vulkan host, where the shadowing
-// lit.filamat is SPIR-V and Filament aborts with "not built for any of the OpenGL backend's
-// supported shader languages".
-// `.env` / `.env.*`: the project's LECODES_* config (projectEnv.ts) — it holds tokens and keystore
-// passwords, so it never leaves the machine whatever .lecodesignore says.
-// `.lightmap/` = a bake's float debug layers (`lecodes lightmap bake --debug-dir`): gigabytes the compile scan must never read
-const BUILTIN_PATTERNS = ["node_modules/", ".git/", "_*", "*.log", ".DS_Store", ".artifacts/", "dist/", ".env", ".env.*", ".lightmap/"]
-
-/** Template `.lecodesignore` written on clone — the explicit, editable "what we don't push" list. */
-export const DEFAULT_IGNORE_FILE = `# Files matched here are NOT pushed to LeCodes.
-# Only untracked files are affected — assets already in the project stay tracked
-# even if they match a pattern. Built-in defaults (node_modules, _*, *.log, .artifacts)
-# always apply.
-
-# Render / preview outputs (the default \`lecodes render --png\` target)
-screenshot.png
-shots/
-
-# Design-board comments live on the platform; design/comments/ is the local mirror of the
-# open ones (\`lecodes design comments pull\`) — read by Claude, but pushing it back as
-# project files would only duplicate the database.
-design/comments/
-
-# Image & other binary assets ARE pushed by default — they're real project resources.
-# Uncomment a pattern below only if you want to keep some untracked ones out of pushes.
-# *.png
-
-# Local notes & dumps (uncomment to ignore)
-# *.json
-# notes.md
-`
-
-/** Translate a glob (one path segment's worth of `*`/`?`/`**`) into a regex fragment. */
-const translate = (glob: string): string => {
-  let re = ""
-  for (let i = 0; i < glob.length; i++) {
-    const ch = glob[i]
-    if (ch === "*") {
-      if (glob[i + 1] === "*") { re += ".*"; i++; if (glob[i + 1] === "/") i++ } // `**/` spans dirs
-      else re += "[^/]*"
-    } else if (ch === "?") re += "[^/]"
-    else if (ch === "/") re += "/"
-    else if ("\\^$.|+()[]{}".includes(ch)) re += "\\" + ch
-    else re += ch
-  }
-  return re
-}
-
-const compile = (raw: string): Rule | null => {
-  let p = raw.trim()
-  if (!p || p.startsWith("#")) return null
-  let negate = false
-  if (p.startsWith("!")) { negate = true; p = p.slice(1) }
-  let dirOnly = false
-  if (p.endsWith("/")) { dirOnly = true; p = p.slice(0, -1) }
-  const anchored = p.startsWith("/") || p.includes("/")
-  if (p.startsWith("/")) p = p.slice(1)
-  if (!p) return null
-  const body = translate(p)
-  // `(/.*)?$` lets a directory pattern also match files nested under it, matching gitignore behavior
-  // even without relying on directory pruning.
-  const re = anchored ? new RegExp("^/" + body + "(/.*)?$") : new RegExp("(^|/)" + body + "(/.*)?$")
-  return { re, negate, dirOnly }
-}
-
-const buildMatcher = (rules: Rule[]): IgnoreMatcher => (key, isDir) => {
-  let ignored = false
-  for (const r of rules) {
-    if (r.dirOnly && !isDir) continue // a `foo/` rule only matches dirs directly (files via prune)
-    if (r.re.test(key)) ignored = !r.negate
-  }
-  return ignored
-}
-
-/** Compile a standalone glob list (same syntax as .lecodesignore lines, including `!` re-includes)
- *  into a file-path matcher — used for app.json's `resources.remote` patterns. */
-export const buildGlobMatcher = (patterns: string[]): ((path: string) => boolean) => {
-  // Matching is over FILE paths — normalize `videos/` (dir-only, would match nothing here) to
-  // `videos`, whose `(/.*)?$` tail matches everything under the directory.
-  const rules = patterns.map((p) => compile(p.trim().replace(/\/+$/, ""))).filter((r): r is Rule => r !== null)
-  const match = buildMatcher(rules)
-  // Anchored rules compile to `^/…` — they expect the canonical leading-slash key form.
-  return (path) => match(path.startsWith("/") ? path : "/" + path, false)
-}
-
-/** Read `<root>/.lecodesignore` (if any) and combine with the built-in defaults into a matcher. */
-export const loadIgnore = (root: string): IgnoreMatcher => {
-  const lines = [...BUILTIN_PATTERNS]
-  const file = join(root, ".lecodesignore")
-  if (existsSync(file)) {
-    try { lines.push(...readFileSync(file, "utf8").split(/\r?\n/)) } catch { /* unreadable → defaults only */ }
-  }
-  const rules = lines.map(compile).filter((r): r is Rule => r !== null)
-  return buildMatcher(rules)
-}
-
-/** Write the template `.lecodesignore` if the project doesn't have one yet (used on clone). */
-export const writeDefaultIgnore = (root: string) => {
-  const file = join(root, ".lecodesignore")
-  if (!existsSync(file)) writeFileSync(file, DEFAULT_IGNORE_FILE)
-}
-
-/* `.gitignore` for the project's OWN git repo. `.lecodes/` is per-checkout state — regenerable IDE
- * types (`lecodes update`) + `manifest.json`, this machine's push cursor (baseHeadId + per-file shas).
- * Committing it makes collaborators fight over the cursor and ship stale types, so every scaffold
- * path (init / clone / link) makes sure it's ignored. Render outputs mirror DEFAULT_IGNORE_FILE. */
-export const DEFAULT_GITIGNORE = `# LeCodes per-checkout state: generated IDE types + this machine's sync cursor
-# (.lecodes/manifest.json). Regenerate with \`lecodes update\` / re-attach with \`lecodes link\`.
-.lecodes/
-
-# Render / preview outputs and test failure frames
-screenshot.png
-shots/
-tests/.artifacts/
-tests/.shots/
-
-node_modules/
-
-dist/
-`
-
-/** Create `.gitignore` if missing; if it exists but doesn't ignore `.lecodes/`, append that rule.
- * Returns what happened so callers can log it ("created" | "updated" | null). */
-export const ensureGitignore = (root: string): "created" | "updated" | null => {
-  const file = join(root, ".gitignore")
-  if (!existsSync(file)) { writeFileSync(file, DEFAULT_GITIGNORE); return "created" }
-  const text = readFileSync(file, "utf8")
-  const covered = text.split(/\r?\n/).some(l => /^\/?\.lecodes\/?\s*$/.test(l.trim()))
-  if (covered) return null
-  const sep = text.length === 0 || text.endsWith("\n") ? "" : "\n"
-  writeFileSync(file, `${text}${sep}\n# LeCodes per-checkout state (generated types + sync cursor) — not source\n.lecodes/\n`)
-  return "updated"
-}
+import { existsSync, readFileSync, writeFileSync } from "node:fs"
+import { join } from "node:path"
+
+/*
+ * `.lecodesignore` support — keeps scratch files (temp probes, render screenshots, logs) out of
+ * `status` / `push` so they never land in a checkpoint. Syntax is a practical subset of .gitignore:
+ *   - blank lines and `# comments` are skipped
+ *   - `!pattern` re-includes something a previous pattern ignored
+ *   - a trailing `/` matches directories only
+ *   - a leading `/` (or any embedded `/`) anchors the pattern to the project root
+ *   - `*` matches within a path segment, `**` across segments, `?` a single char
+ *   - a slash-free pattern (e.g. `_*`, `*.png`) matches a basename at any depth
+ *
+ * IMPORTANT: ignores apply to UNTRACKED files only. A file already in the project (recorded in the
+ * manifest) is always tracked, even if it matches a pattern — so ignoring `*.png` can never make an
+ * existing image asset silently disappear from the project. Pruning happens in `scanLocal`.
+ */
+
+export type IgnoreMatcher = (key: string, isDir: boolean) => boolean
+
+type Rule = { re: RegExp, negate: boolean, dirOnly: boolean }
+
+// Always applied, even with no .lecodesignore — only patterns that are never real project assets, so
+// they're safe as invisible defaults. Everything asset-shaped (*.png, *.json, …) is opt-in via the
+// file written at clone time (see DEFAULT_IGNORE_FILE). `.artifacts/` is `lecodes test`'s
+// failure-frame dump dir (tests/.artifacts/) — regenerated scratch, never a project asset.
+// `dist/` is `lecodes app build desktop`'s default output (<root>/dist/<slug>, appDesktop.ts) —
+// same class, but it must be ignored for a second, load-bearing reason: that folder holds a COPY of
+// the host's runtime assets (lit.filamat, uberarchive.bin, …). Collected as project assets they get
+// staged next to the bundle, and onFetchLocal searches the bundle's dir BEFORE the host's assets dir
+// (main.cpp) — so the copy shadows the host's own. Harmless while every host was OpenGL and the
+// bytes matched; fatal once a build output can come from the Vulkan host, where the shadowing
+// lit.filamat is SPIR-V and Filament aborts with "not built for any of the OpenGL backend's
+// supported shader languages".
+// `.env` / `.env.*`: the project's LECODES_* config (projectEnv.ts) — it holds tokens and keystore
+// passwords, so it never leaves the machine whatever .lecodesignore says.
+// `.lightmap/` = a bake's float debug layers (`lecodes lightmap bake --debug-dir`): gigabytes the compile scan must never read
+const BUILTIN_PATTERNS = ["node_modules/", ".git/", "_*", "*.log", ".DS_Store", ".artifacts/", "dist/", ".env", ".env.*", ".lightmap/"]
+
+/** Template `.lecodesignore` written on clone — the explicit, editable "what we don't push" list. */
+export const DEFAULT_IGNORE_FILE = `# Files matched here are NOT pushed to LeCodes.
+# Only untracked files are affected — assets already in the project stay tracked
+# even if they match a pattern. Built-in defaults (node_modules, _*, *.log, .artifacts)
+# always apply.
+
+# Render / preview outputs (the default \`lecodes render --png\` target)
+screenshot.png
+shots/
+
+# Design-board comments live on the platform; design/comments/ is the local mirror of the
+# open ones (\`lecodes design comments pull\`) — read by Claude, but pushing it back as
+# project files would only duplicate the database.
+design/comments/
+
+# Image & other binary assets ARE pushed by default — they're real project resources.
+# Uncomment a pattern below only if you want to keep some untracked ones out of pushes.
+# *.png
+
+# Local notes & dumps (uncomment to ignore)
+# *.json
+# notes.md
+`
+
+/** Translate a glob (one path segment's worth of `*`/`?`/`**`) into a regex fragment. */
+const translate = (glob: string): string => {
+  let re = ""
+  for (let i = 0; i < glob.length; i++) {
+    const ch = glob[i]
+    if (ch === "*") {
+      if (glob[i + 1] === "*") { re += ".*"; i++; if (glob[i + 1] === "/") i++ } // `**/` spans dirs
+      else re += "[^/]*"
+    } else if (ch === "?") re += "[^/]"
+    else if (ch === "/") re += "/"
+    else if ("\\^$.|+()[]{}".includes(ch)) re += "\\" + ch
+    else re += ch
+  }
+  return re
+}
+
+const compile = (raw: string): Rule | null => {
+  let p = raw.trim()
+  if (!p || p.startsWith("#")) return null
+  let negate = false
+  if (p.startsWith("!")) { negate = true; p = p.slice(1) }
+  let dirOnly = false
+  if (p.endsWith("/")) { dirOnly = true; p = p.slice(0, -1) }
+  const anchored = p.startsWith("/") || p.includes("/")
+  if (p.startsWith("/")) p = p.slice(1)
+  if (!p) return null
+  const body = translate(p)
+  // `(/.*)?$` lets a directory pattern also match files nested under it, matching gitignore behavior
+  // even without relying on directory pruning.
+  const re = anchored ? new RegExp("^/" + body + "(/.*)?$") : new RegExp("(^|/)" + body + "(/.*)?$")
+  return { re, negate, dirOnly }
+}
+
+const buildMatcher = (rules: Rule[]): IgnoreMatcher => (key, isDir) => {
+  let ignored = false
+  for (const r of rules) {
+    if (r.dirOnly && !isDir) continue // a `foo/` rule only matches dirs directly (files via prune)
+    if (r.re.test(key)) ignored = !r.negate
+  }
+  return ignored
+}
+
+/** Compile a standalone glob list (same syntax as .lecodesignore lines, including `!` re-includes)
+ *  into a file-path matcher — used for app.json's `resources.remote` patterns. */
+export const buildGlobMatcher = (patterns: string[]): ((path: string) => boolean) => {
+  // Matching is over FILE paths — normalize `videos/` (dir-only, would match nothing here) to
+  // `videos`, whose `(/.*)?$` tail matches everything under the directory.
+  const rules = patterns.map((p) => compile(p.trim().replace(/\/+$/, ""))).filter((r): r is Rule => r !== null)
+  const match = buildMatcher(rules)
+  // Anchored rules compile to `^/…` — they expect the canonical leading-slash key form.
+  return (path) => match(path.startsWith("/") ? path : "/" + path, false)
+}
+
+/** Read `<root>/.lecodesignore` (if any) and combine with the built-in defaults into a matcher. */
+export const loadIgnore = (root: string): IgnoreMatcher => {
+  const lines = [...BUILTIN_PATTERNS]
+  const file = join(root, ".lecodesignore")
+  if (existsSync(file)) {
+    try { lines.push(...readFileSync(file, "utf8").split(/\r?\n/)) } catch { /* unreadable → defaults only */ }
+  }
+  const rules = lines.map(compile).filter((r): r is Rule => r !== null)
+  return buildMatcher(rules)
+}
+
+/** Write the template `.lecodesignore` if the project doesn't have one yet (used on clone). */
+export const writeDefaultIgnore = (root: string) => {
+  const file = join(root, ".lecodesignore")
+  if (!existsSync(file)) writeFileSync(file, DEFAULT_IGNORE_FILE)
+}
+
+/* `.gitignore` for the project's OWN git repo. `.lecodes/` is per-checkout state — regenerable IDE
+ * types (`lecodes update`) + `manifest.json`, this machine's push cursor (baseHeadId + per-file shas).
+ * Committing it makes collaborators fight over the cursor and ship stale types, so every scaffold
+ * path (init / clone / link) makes sure it's ignored. Render outputs mirror DEFAULT_IGNORE_FILE. */
+export const DEFAULT_GITIGNORE = `# LeCodes per-checkout state: generated IDE types + this machine's sync cursor
+# (.lecodes/manifest.json). Regenerate with \`lecodes update\` / re-attach with \`lecodes link\`.
+.lecodes/
+
+# Render / preview outputs and test failure frames
+screenshot.png
+shots/
+tests/.artifacts/
+tests/.shots/
+
+node_modules/
+
+dist/
+`
+
+/** Create `.gitignore` if missing; if it exists but doesn't ignore `.lecodes/`, append that rule.
+ * Returns what happened so callers can log it ("created" | "updated" | null). */
+export const ensureGitignore = (root: string): "created" | "updated" | null => {
+  const file = join(root, ".gitignore")
+  if (!existsSync(file)) { writeFileSync(file, DEFAULT_GITIGNORE); return "created" }
+  const text = readFileSync(file, "utf8")
+  const covered = text.split(/\r?\n/).some(l => /^\/?\.lecodes\/?\s*$/.test(l.trim()))
+  if (covered) return null
+  const sep = text.length === 0 || text.endsWith("\n") ? "" : "\n"
+  writeFileSync(file, `${text}${sep}\n# LeCodes per-checkout state (generated types + sync cursor) — not source\n.lecodes/\n`)
+  return "updated"
+}

package/src/project/localFiles.ts

@@ -1,5 +1,5 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs"
-import { join, relative } from "node:path"
+import { basename, dirname, join, relative } from "node:path"
 import { sanitizeAssetName } from "lecodes-sdk/compile/assetName"
 import { sha256, toKey } from "./paths"
 import { loadIgnore, type IgnoreMatcher } from "./ignore"
@@ -25,17 +25,49 @@ const ext = (name: string) => {
   return i < 0 ? "" : name.slice(i + 1).toLowerCase()
 }
 
-/** Best-effort kind for a file the user added locally (known files keep their manifest type). */
-export const classifyKind = (name: string): FileKind => {
+/** Best-effort kind of a file by its name (a scanned file's is `LocalFile.kind`). */
+const classifyKind = (name: string): FileKind => {
   const e = ext(name)
   if (e === "mat") return "shader"
   if (e === "scene") return "scene"
   return TEXT_EXTS.has(e) ? "text" : "resource"
 }
 
+// A plugin's `web.static` folder (its lecodes-plugin.json, plugin/manifest.ts) is a runtime its web
+// half loads beside itself AS IT IS — 8th Wall's xr.js of 1 MB, xr-slam.js of 5.5 MB, its models:
+// files a page is served, never code of the app, whatever their extensions. Typed by the extension
+// they went up as TEXT assets, megabyte rows the builder was then sent with every compile; every
+// file under one is a resource. (Only a project's half has one: a first-party half asks its bundler
+// for `resources`. The manifest is read as collectLocal reads a half folder's, tolerantly: a broken
+// one names no folder.)
+const PLUGIN_MANIFEST = "lecodes-plugin.json"
+
+/** The keys of the static folders the scanned plugin manifests name ("/plugins/ar-8thwall/xr-runtime/"). */
+const staticFolders = (root: string, files: { path: string, absPath: string }[]): string[] => {
+  const folders: string[] = []
+  for (const file of files) {
+    if (basename(file.path) !== PLUGIN_MANIFEST) continue
+    let folder: unknown
+    try {
+      folder = (JSON.parse(readFileSync(file.absPath, "utf8").replace(/^\uFEFF/, "")) as { web?: { static?: unknown } | null }).web?.static
+    } catch { continue }
+    if (typeof folder !== "string" || folder.trim() === "") continue
+    try { folders.push(toKey(relative(root, join(dirname(file.absPath), folder))) + "/") } catch { /* outside the project: none of its files is scanned */ }
+  }
+  return folders
+}
+
 export const isTextKind = (kind: FileKind) => kind !== "resource"
 
-export type LocalFile = { path: string, absPath: string, sha: string }
+export type LocalFile = {
+  path: string
+  absPath: string
+  sha: string
+  /** What the platform stores the file as when the manifest has no type of it (a known file keeps
+   *  its recorded one): a resource under a plugin's static folder, else by its extension. Every
+   *  caller that types a local file takes this — the rule lives here alone. */
+  kind: FileKind
+}
 
 export type LocalScan = { files: LocalFile[], dirs: string[], ignored: string[] }
 
@@ -46,10 +78,10 @@ export type ScanOptions = {
   tracked?: Set<string>
 }
 
-/** Recursively scan the working tree, skipping ignored dirs/files; hashes each file. */
+/** Recursively scan the working tree, skipping ignored dirs/files; hashes and types each file. */
 export const scanLocal = (root: string, opts: ScanOptions = {}): LocalScan => {
   const { ignore, tracked } = opts
-  const files: LocalFile[] = []
+  const found: Omit<LocalFile, "kind">[] = []
   const dirs: string[] = []
   const ignored: string[] = []
   const isTracked = (key: string) => tracked?.has(key) ?? false
@@ -77,11 +109,16 @@ export const scanLocal = (root: string, opts: ScanOptions = {}): LocalScan => {
         if (SKIP_FILES.has(entry.name)) continue
         const fileIgnored = parentIgnored || (!!ignore && ignore(key, false))
         if (fileIgnored && !isTracked(key)) { ignored.push(key); continue }
-        files.push({ path: key, absPath: abs, sha: sha256(readFileSync(abs)) })
+        found.push({ path: key, absPath: abs, sha: sha256(readFileSync(abs)) })
       }
     }
   }
   walk(root, false)
+  const statics = staticFolders(root, found)
+  const files: LocalFile[] = found.map(f => ({
+    ...f,
+    kind: statics.some(dir => f.path.startsWith(dir)) ? "resource" : classifyKind(basename(f.path)),
+  }))
   return { files, dirs, ignored }
 }
 

package/src/web/build.ts

@@ -9,6 +9,7 @@ import { ambiguousEntryWarning, compileProject } from "../compile/projectCompile
 import { readAppConfigAt } from "../commands/app/shared"
 import type { Manifest } from "../project/manifest"
 import { CliError } from "../cli"
+import { buildHalf, copyStatic, halfModule, projectHalves, type ProjectHalf } from "./halves"
 
 /*
  * `lecodes web build`: the project as a FOLDER a static hosting serves.
@@ -22,8 +23,13 @@ import { CliError } from "../cli"
  *                         tweens, the canvas, the 3D engine, its twins, AR — a chunk each with
  *                         the files it fetches; the page's features.json says what
  *                         a bundle has to name for one to be needed, and whose files they are)
- *   plugins/<id>/…        the web halves of the plugins the app lists, a folder each, and
- *   plugins.json          where the half of each is
+ *   plugins/<id>/…        the web halves of the plugins the app lists, a folder each — a plugin
+ *                         app.json names a folder of the project for on the web (`"ar": { "web":
+ *                         "./plugins/ar-8thwall" }`) has the project's half too, built here
+ *                         (plugins/<folder>/index.js + its `web.static` folder, web/halves.ts), tried
+ *                         before the first-party one — and
+ *   plugins.json          where the half of each is, by the plugin's id: its module, or the modules
+ *                         to try in order (the project's half, then the first-party one)
  *   assets/<path>         the project's assets — only the ones the bundle names
  *   shaders/<hash>_webgl-lite.filamat
  *                         the project's .mat shaders the bundle names, in the one form Web Lite
@@ -146,6 +152,12 @@ export const buildWeb = async (options: WebBuildOptions): Promise<WebBuildResult
     warnings.push("This project uses 2D scenes, which Web Lite does not show yet: the page runs its UI and its 3D, a 2D scene's calls fail. (`lecodes dev --web` runs the whole app on the web player.)")
   }
 
+  // the project's own web halves of the plugins it lists, built before the folder is cleaned: one
+  // that does not build leaves the last build as it was
+  const listed = new Set((/^\/\/ plugins: (.+)$/m.exec(header)?.[1] ?? "").split(";").map((id) => id.trim()).filter(Boolean))
+  const halves: { half: ProjectHalf, js: string }[] = []
+  for (const half of projectHalves(root)) if (listed.has(half.id)) halves.push({ half, js: await buildHalf(half, { minify: options.minify }) })
+
   // ---- the folder ----------------------------------------------------------------------------------------------
   rmSync(out, { recursive: true, force: true })
   mkdirSync(out, { recursive: true })
@@ -161,19 +173,31 @@ export const buildWeb = async (options: WebBuildOptions): Promise<WebBuildResult
     }
     rmSync(table)
   }
-  // …and the plugins the app does not list (`// plugins:` of the bundle's header)
+  // …and the plugins the app does not list (`// plugins:` of the bundle's header). A plugin app.json
+  // names a folder of the project for on the web takes the project's half (web/halves.ts) FIRST and
+  // keeps its first-party one as the fallback: if the project's half declines the page (`register`
+  // returns false), the first-party half takes it — plugins.json names both, in that order
+  // (`"ar": ["plugins/ar-8thwall/index.js", "plugins/ar/index-….js"]`); a plain module otherwise.
   const pluginsTable = join(out, "plugins.json")
-  if (existsSync(pluginsTable)) {
-    const listed = new Set((/^\/\/ plugins: (.+)$/m.exec(header)?.[1] ?? "").split(";").map((id) => id.trim()).filter(Boolean))
-    const { plugins } = JSON.parse(readFileSync(pluginsTable, "utf8")) as { plugins: Record<string, string> }
-    const kept: Record<string, string> = {}
+  if (existsSync(pluginsTable) || halves.length > 0) {
+    const { plugins } = existsSync(pluginsTable) ? JSON.parse(readFileSync(pluginsTable, "utf8")) as { plugins: Record<string, string> } : { plugins: {} }
+    const kept: Record<string, string | string[]> = {}
     for (const id of Object.keys(plugins)) {
       if (listed.has(id)) kept[id] = plugins[id]!
       else rmSync(join(out, "plugins", id), { recursive: true, force: true })
     }
-    for (const id of listed) if (!(id in plugins)) warnings.push(`The "${id}" plugin has no web half in this CLI: it is unsupported on the page (\`isSupported\` answers false).`)
+    for (const { half, js } of halves) {
+      if (half.folder in plugins && half.folder in kept) throw new CliError(`Plugin "${half.id}": its half's folder is named like the "${half.folder}" plugin the page carries — rename ${half.dir}.`)
+      const dir = join(out, "plugins", half.folder)
+      mkdirSync(dir, { recursive: true })
+      writeFileSync(join(dir, "index.js"), js)
+      copyStatic(half, join(out, "plugins"))
+      const firstParty = plugins[half.id]
+      kept[half.id] = firstParty !== undefined && listed.has(half.id) ? [halfModule(half), firstParty] : halfModule(half)
+    }
+    for (const id of listed) if (!(id in kept)) warnings.push(`The "${id}" plugin has no web half in this CLI: it is unsupported on the page (\`isSupported\` answers false).`)
     if (Object.keys(kept).length > 0) writeFileSync(pluginsTable, JSON.stringify({ plugins: kept }, null, 2))
-    else { rmSync(pluginsTable); rmSync(join(out, "plugins"), { recursive: true, force: true }) }
+    else { rmSync(pluginsTable, { force: true }); rmSync(join(out, "plugins"), { recursive: true, force: true }) }
   }
 
   const bundle = `app.${createHash("sha256").update(js).digest("hex").slice(0, 10)}.js`

package/src/web/halves.ts

@@ -0,0 +1,76 @@
+// A project's OWN web halves on Web Lite: the plugins app.json names a folder of the project for on
+// the web — a half folder over a first-party plugin (`"ar": { "web": "./plugins/ar-8thwall" }`, its
+// manifest `implements: "ar"`), or a plugin of the project with a web half (`"dial": "./plugins/dial"`).
+// The CLI builds each — `lecodes web build` into the folder, `lecodes web dev` in memory. A project's
+// own half of an id comes first; if it DECLINES the page (`register` returns `false`, sync or through
+// a promise — renderers/web-lite registry.ts), the first-party half of that id takes it: the page
+// carries both, the first-party one as the fallback.
+//
+//   plugins/<folder>/index.js        the half: ONE module (Bun.build, ES) that exports `register(host)`
+//   plugins/<folder>/<static>/…      the manifest's `web.static` folder, as it is, names unhashed (a
+//                                    runtime the half loads by `new URL("<static>/x.js", import.meta.url)`
+//                                    fetches its own files relative to itself)
+//   plugins.json                     `"<id>": ["plugins/<folder>/index.js", "plugins/<id>/index-….js"]`
+//                                    — keyed by the plugin's id, the project's half then the
+//                                    first-party one; the plain module when the page has no
+//                                    first-party half of the id
+//
+// What a half is built into — plain TypeScript of its own folder, ONE module, no package, no file
+// outside the folder — is the SDK's (lecodes-sdk/compile `bundleWebHalf`, `webHalfManifestOf`): the
+// build service builds the halves of a project the platform deploys by the same rules. Here: the
+// halves found on disk, and the SDK's errors as the CLI's.
+
+import { cpSync, existsSync, readFileSync } from "node:fs"
+import { join, sep } from "node:path"
+import { bundleWebHalf, webHalfManifestOf, webHalfSpecsOf, type WebHalfManifest } from "lecodes-sdk/compile"
+import { CliError } from "../cli"
+import { localPlugin, readAppConfigAt, type PluginManifest } from "../commands/app/shared"
+import { MANIFEST_FILE } from "../plugin/manifest"
+
+export type ProjectHalf = {
+  /** The plugin's id: app.json's key, what the page asks the half for. */
+  id: string
+  /** The folder's name: where the half lands, `plugins/<folder>/`. */
+  folder: string
+  dir: string
+  manifest: PluginManifest
+  /** The module that exports `register(host)` (the manifest's `web.register`). */
+  entry: string
+  /** `web.static`, relative to the folder; null when none. */
+  static: string | null
+}
+
+/** Where a half's module is, relative to the page. */
+export const halfModule = (half: ProjectHalf): string => `plugins/${half.folder}/index.js`
+
+/** The SDK's error as the CLI's. */
+const asCliError = (e: unknown): CliError => new CliError(e instanceof Error ? e.message : String(e))
+
+/** The project's web halves, by app.json's web specs that are folders. Throws on one that cannot be
+ *  built: no web half, packages, a missing generated file. */
+export const projectHalves = (root: string): ProjectHalf[] => {
+  const halves: ProjectHalf[] = []
+  for (const { id, spec } of webHalfSpecsOf(readAppConfigAt(root))) {
+    // the whole manifest checked first (every problem of the file at once), then what a build takes of it
+    const { dir, manifest } = localPlugin(root, id, spec)
+    const folder = dir.split(sep).pop()!
+    let web: WebHalfManifest
+    try { web = webHalfManifestOf(readFileSync(join(dir, MANIFEST_FILE), "utf8"), folder, id) } catch (e) { throw asCliError(e) }
+    const genId = web.implements ?? id
+    if (!existsSync(join(dir, "web", `${genId}.gen.ts`))) {
+      throw new CliError(`Plugin "${id}": ${spec}/web/${genId}.gen.ts is not there — run \`lecodes plugin gen ${spec}\`.`)
+    }
+    if (halves.some((h) => h.folder === folder)) throw new CliError(`Plugin "${id}": ${spec} is the half of another plugin already`)
+    halves.push({ id, folder, dir, manifest, entry: join(dir, web.register), static: web.static })
+  }
+  return halves
+}
+
+/** The half as ONE ES module's text. `dev`: not minified, its source map inline. */
+export const buildHalf = (half: ProjectHalf, opts: { dev?: boolean, minify?: boolean } = {}): Promise<string> =>
+  bundleWebHalf({ id: half.id, dir: half.dir, entry: half.entry, dev: opts.dev, minify: opts.minify }).catch((e: unknown) => { throw asCliError(e) })
+
+/** The half's `web.static` folder, copied beside its module (`<plugins>/<folder>/<static>/`). */
+export const copyStatic = (half: ProjectHalf, pluginsDir: string): void => {
+  if (half.static) cpSync(join(half.dir, half.static), join(pluginsDir, half.folder, half.static), { recursive: true })
+}

package/runtime/web/assets/ar-CHvaraG4.js

@@ -1 +0,0 @@
-var nt=Object.defineProperty;var ot=(e,t,n)=>t in e?nt(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var P=(e,t,n)=>ot(e,typeof t!="symbol"?t+"":t,n);const it=(e,t)=>{const n=t.data instanceof Uint8Array?t.data.slice().buffer:t.data;return{systemId:e.putBuffer(n),name:t.name,size:n.byteLength}},l={present:e=>e!=null,f64:e=>typeof e=="number"&&Number.isFinite(e)?e:void 0,i32:e=>typeof e=="number"&&Number.isInteger(e)&&e>=-2147483648&&e<=2147483647?e:void 0,bool:e=>typeof e=="boolean"?e:void 0,string:e=>typeof e=="string"?e:void 0,json:e=>e,bytes:e=>Object.prototype.toString.call(e)==="[object Uint8Array]"?e.slice():void 0,object:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0,array:(e,t)=>Array.isArray(e)&&(t===void 0||e.length===t)?e:void 0,list:(e,t)=>{if(!Array.isArray(e))return;const n=[];for(const o of e){const i=t(o);if(i===void 0)return;n.push(i)}return n},map:(e,t)=>{if(typeof e!="object"||e===null||Array.isArray(e))return;const n={};for(const[o,i]of Object.entries(e)){const r=t(i);if(r===void 0)return;n[o]=r}return n}};let $;const rt=e=>{const t=l.object(e),n=t?l.i32(t.systemId):void 0,o=n===void 0||$==null?void 0:$(n);return t&&o?{data:o,name:l.string(t.name)??""}:void 0},S=e=>typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=4294967295?e:void 0,st=e=>{const t=l.object(e);if(!t)return;let n;if(l.present(t.scene)){const r=S(t.scene);if(r===void 0)return;n=r}let o;if(l.present(t.camera)){const r=S(t.camera);if(r===void 0)return;o=r}const i={};return n!==void 0&&(i.scene=n),o!==void 0&&(i.camera=o),i},at=e=>e==="world"||e==="images"?e:void 0,ct=e=>e==="horizontal"||e==="vertical"||e==="both"||e==="none"?e:void 0,Y=e=>{const t=l.object(e);if(!t)return;const n=rt(t.image);if(n===void 0)return;const o=l.f64(t.physicalWidth);if(o===void 0)return;const i=S(t.entity);return i===void 0?void 0:{image:n,physicalWidth:o,entity:i}},dt=e=>e==="gravity"||e==="gravityAndHeading"?e:void 0,ut=e=>{const t=l.object(e);if(!t)return;let n;if(l.present(t.mode)){const s=at(t.mode);if(s===void 0)return;n=s}let o;if(l.present(t.planes)){const s=ct(t.planes);if(s===void 0)return;o=s}let i;if(l.present(t.images)){const s=l.list(t.images,u=>Y(u));if(s===void 0)return;i=s}let r;if(l.present(t.worldAlignment)){const s=dt(t.worldAlignment);if(s===void 0)return;r=s}let h;if(l.present(t.lightEstimation)){const s=l.bool(t.lightEstimation);if(s===void 0)return;h=s}let c;if(l.present(t.autoFocus)){const s=l.bool(t.autoFocus);if(s===void 0)return;c=s}const d={};return n!==void 0&&(d.mode=n),o!==void 0&&(d.planes=o),i!==void 0&&(d.images=i),r!==void 0&&(d.worldAlignment=r),h!==void 0&&(d.lightEstimation=h),c!==void 0&&(d.autoFocus=c),d},lt=e=>e==="planes"||e==="estimated"||e==="any"?e:void 0,ft=e=>{const t=l.object(e);if(!t)return;const n=l.f64(t.x);if(n===void 0)return;const o=l.f64(t.y);if(o===void 0)return;const i=l.f64(t.z);return i===void 0?void 0:{x:n,y:o,z:i}},ht=e=>{const t=l.object(e);if(!t)return;const n=l.f64(t.x);if(n===void 0)return;const o=l.f64(t.y);if(o===void 0)return;const i=l.f64(t.z);if(i===void 0)return;const r=l.f64(t.w);return r===void 0?void 0:{x:n,y:o,z:i,w:r}},mt=e=>{const t=l.object(e);if(!t)return;const n=ft(t.position);if(n===void 0)return;const o=ht(t.rotation);return o===void 0?void 0:{position:n,rotation:o}};class A extends Error{constructor(t){super(t),this.code=t}}const q={name:"ar",version:1},vt=(e,t)=>{$=n=>e.getBuffer(n),e.registerService(q.name,(n,o)=>{const i={tracking:c=>o.emit("tracking",c),plane:c=>o.emit("plane",c),image:c=>o.emit("image",c),anchor:c=>o.emit("anchor",c),light:c=>o.emit("light",c),error:c=>o.emit("error",c)},r=t(st(n)??{},i);return{call:async(c,d)=>{switch(c){case"start":{let s;if(l.present(d[0])){const u=ut(d[0]);if(u===void 0)throw new Error("bad arguments — AR.start: options");s=u}await r.start(s);return}case"stop":{await r.stop();return}case"setImages":{const s=l.list(d[0],u=>Y(u));if(s===void 0)throw new Error("bad arguments — AR.setImages: images");await r.setImages(s);return}case"hitTest":{const s=l.f64(d[0]);if(s===void 0)throw new Error("bad arguments — AR.hitTest: x");const u=l.f64(d[1]);if(u===void 0)throw new Error("bad arguments — AR.hitTest: y");let p;if(l.present(d[2])){const E=lt(d[2]);if(E===void 0)throw new Error("bad arguments — AR.hitTest: target");p=E}return await r.hitTest(s,u,p)}case"anchor":{const s=S(d[0]);if(s===void 0)throw new Error("bad arguments — AR.anchor: entity");const u=mt(d[1]);if(u===void 0)throw new Error("bad arguments — AR.anchor: pose");await r.anchor(s,u);return}case"release":{const s=S(d[0]);if(s===void 0)throw new Error("bad arguments — AR.release: entity");await r.release(s);return}case"captureFrame":{const s=await r.captureFrame();return it(e,s)}default:throw new Error(`Unknown method: ${c}`)}},close:()=>{var c;return(c=r.close)==null?void 0:c.call(r)}}},q.version)},F=Math.PI/180,D=(e,t)=>[e[3]*t[0]+e[0]*t[3]+e[1]*t[2]-e[2]*t[1],e[3]*t[1]-e[0]*t[2]+e[1]*t[3]+e[2]*t[0],e[3]*t[2]+e[0]*t[1]-e[1]*t[0]+e[2]*t[3],e[3]*t[3]-e[0]*t[0]-e[1]*t[1]-e[2]*t[2]],U=e=>{const t=Math.hypot(e[0],e[1],e[2],e[3])||1;return[e[0]/t,e[1]/t,e[2]/t,e[3]/t]},O=(e,t)=>{const n=Math.sin(t/2);return[e[0]*n,e[1]*n,e[2]*n,Math.cos(t/2)]},G=(e,t)=>{const[n,o,i,r]=e,h=2*(o*t[2]-i*t[1]),c=2*(i*t[0]-n*t[2]),d=2*(n*t[1]-o*t[0]);return[t[0]+r*h+(o*d-i*c),t[1]+r*c+(i*h-n*d),t[2]+r*d+(n*c-o*h)]},Q=(e,t,n)=>D(D(O([0,0,1],e*F),O([1,0,0],t*F)),O([0,1,0],n*F)),tt=e=>{const[t,n,o,i]=e;return[2*(t*o-i*n),2*(i*t+n*o),i*i-t*t-n*n+o*o]},wt=(e,t)=>{const n=e[0]*t[0]+e[1]*t[1]+e[2]*t[2];if(n<-.999999)return[1,0,0,0];const o=[e[1]*t[2]-e[2]*t[1],e[2]*t[0]-e[0]*t[2],e[0]*t[1]-e[1]*t[0]];return U([o[0],o[1],o[2],1+n])};class Z{constructor(t=1,n=.05){P(this,"q",[0,0,0,1]);P(this,"seeded",!1);P(this,"ix",0);P(this,"iy",0);P(this,"iz",0);this.kp=t,this.ki=n}get ready(){return this.seeded}seed(t){this.q=U(t),this.seeded=!0}update(t,n,o){const i=Math.hypot(n[0],n[1],n[2]);if(!this.seeded){if(i===0)return;this.seed(wt([n[0]/i,n[1]/i,n[2]/i],[0,0,1]));return}let r=t[0],h=t[1],c=t[2];if(i>0){const z=n[0]/i,j=n[1]/i,I=n[2]/i,b=tt(this.q),M=j*b[2]-I*b[1],T=I*b[0]-z*b[2],k=z*b[1]-j*b[0];this.ki>0&&(this.ix+=this.ki*M*o,this.iy+=this.ki*T*o,this.iz+=this.ki*k*o,r+=this.ix,h+=this.iy,c+=this.iz),r+=this.kp*M,h+=this.kp*T,c+=this.kp*k}const d=.5*o*r,s=.5*o*h,u=.5*o*c,[p,E,x,R]=this.q;this.q=U([p+R*d+E*u-x*s,E+R*s-p*u+x*d,x+R*u+p*s-E*d,R-p*d-E*s-x*u])}}const gt=O([1,0,0],-Math.PI/2),yt=(e,t)=>D(D(gt,e),O([0,0,1],-t*F)),pt=e=>{let[t,,n]=G(e,[0,0,-1]);return Math.hypot(t,n)<.3&&([t,,n]=G(e,[0,1,0])),O([0,1,0],-Math.atan2(-t,-n))},At=e=>{const[t,n,o,i]=e;return[1-2*(n*n+o*o),2*(t*n+i*o),2*(t*o-i*n),0,2*(t*n-i*o),1-2*(t*t+o*o),2*(n*o+i*t),0,2*(t*o+i*n),2*(n*o-i*t),1-2*(t*t+n*n),0,0,0,0,1]},Et=(e,t,n,o,i)=>{const r=Math.max(e,t)/2/Math.tan(i*F/2),h=Math.max(n/e,o/t);return 2*Math.atan(o/h/2/r)/F},bt=(e,t,n,o)=>{const i=1/Math.tan(e*F/2);return[i/t,0,0,0,0,i,0,0,0,0,(o+n)/(n-o),-1,0,0,2*o*n/(n-o),0]},xt=(e,t,n,o)=>{const i=Math.max(n/e,o/t),r=n/(e*i),h=o/(t*i);return[r,0,(1-r)/2,0,h,(1-h)/2]},Mt=68,J=.01,K=1e3,N=Math.PI/180,X=30,kt=e=>{var n;if(typeof navigator>"u"||!((n=navigator.mediaDevices)!=null&&n.getUserMedia))return;const t=e.gl;vt(e,(o,i)=>{const r=o.scene;let h=0,c=!1,d=!1,s=null,u=null,p=null,E="",x=new Z,R=!1,z=null,j=null,I=0,b=0,M=0,T=null,k=null;const W=a=>{a.alpha===null||a.beta===null||a.gamma===null||a.alpha===0&&a.beta===0&&a.gamma===0||(j=[a.beta,a.gamma],z=Q(a.alpha,a.beta,a.gamma))},B=a=>{const m=a.rotationRate,f=a.accelerationIncludingGravity;if(!m||!f||m.alpha===null||m.beta===null||m.gamma===null||f.x===null||f.y===null||f.z===null)return;const g=a.timeStamp;if(b||(b=g),M===0)if(j){const y=tt(Q(0,j[0],j[1])),v=Math.hypot(f.x,f.y,f.z)||1;M=(y[0]*f.x+y[1]*f.y+y[2]*f.z)/v<0?-1:1}else if(g-b>500)M=1;else return;const w=I?Math.min(.1,Math.max(0,(g-I)/1e3)):0;I=g,R||(R=!0,z&&x.seed(z)),x.update([m.beta*N,m.gamma*N,m.alpha*N],[f.x*M,f.y*M,f.z*M],w)},C=()=>{if(!u||r===void 0)return;const a=t.viewport(r),{width:m,height:f}=a,g=`${u.videoWidth}x${u.videoHeight}:${m}x${f}`;if(g!==E&&u.videoWidth>0&&m>0&&f>0){E=g;const v=Et(u.videoWidth,u.videoHeight,m,f,Mt);t.setProjection(r,bt(v,m/f,J,K),J,K),t.setBackground(r,u,xt(u.videoWidth,u.videoHeight,m,f))}const w=R?x.ready?x.q:null:z;if(!w)return;const y=yt(w,a.rotation);T??(T=pt(y)),t.setCameraMatrix(r,At(D(T,y)))},H=async()=>{const a=[window.DeviceMotionEvent,window.DeviceOrientationEvent];if(!a[1])return!1;let m=!0;for(const f of a)if(typeof(f==null?void 0:f.requestPermission)=="function")try{m=await f.requestPermission()==="granted"&&m}catch{m=!1}return m},V=()=>{k&&window.removeEventListener("pointerup",k,!0),k=null},et=()=>{k||(k=()=>{V(),H().then(a=>{a||console.warn("[ar] the page was not given the device's sensors: the camera of the scene stays as the app turned it")})},window.addEventListener("pointerup",k,!0))},_=()=>{h++,c=!1,d=!1,p==null||p(),p=null;for(const a of(s==null?void 0:s.getTracks())??[])a.stop();s=null,u&&(u.srcObject=null,r!==void 0&&(t.setBackground(r,null),t.clearProjection(r)),u.remove()),u=null,E="",V(),window.removeEventListener("deviceorientation",W),window.removeEventListener("devicemotion",B),x=new Z,R=!1,z=null,j=null,I=0,b=0,M=0,T=null};return{async start(a){var y;if(c||d)throw new A("busy");if(r===void 0||o.camera===void 0)throw console.warn("[ar] start: the session has no scene or camera to drive (ARScene opens it with both)"),new A("failed");((a==null?void 0:a.mode)==="images"||(y=a==null?void 0:a.images)!=null&&y.length)&&console.warn("[ar] the web finds no images in the camera's picture: their anchors are never tracked"),d=!0;const m=++h,f=H();let g;try{g=await navigator.mediaDevices.getUserMedia({audio:!1,video:{facingMode:{ideal:"environment"},width:{ideal:1280},height:{ideal:720}}})}catch(v){m===h&&(d=!1);const L=v instanceof DOMException?v.name:"";throw console.warn(`[ar] no camera: ${v instanceof Error?v.message:v}`),new A(L==="NotAllowedError"||L==="SecurityError"?"denied":L==="NotFoundError"||L==="OverconstrainedError"?"unavailable":"failed")}if(m!==h){for(const v of g.getTracks())v.stop();throw new A("failed")}s=g;const w=document.createElement("video");if(w.muted=!0,w.playsInline=!0,w.autoplay=!0,w.srcObject=g,u=w,await new Promise(v=>{if(w.readyState>=2)return v();w.addEventListener("loadeddata",()=>v(),{once:!0})}),await w.play().catch(()=>{}),m!==h)throw new A("failed");window.addEventListener("deviceorientation",W),window.addEventListener("devicemotion",B),p=t.onFrame(C),C(),d=!1,c=!0,i.tracking({state:"normal"}),f.then(v=>{!v&&m===h&&et()})},stop(){_()},setImages(a){if(!c)throw new A("notRunning");a.length&&console.warn("[ar] the web finds no images in the camera's picture: their anchors are never tracked")},hitTest(){if(!c)throw new A("notRunning");return[]},anchor(){if(!c)throw new A("notRunning")},release(){},async captureFrame(){const a=u;if(!c||!a)throw new A("notRunning");const m=h;for(let y=0;a.readyState<2||a.videoWidth===0;y++){if(y>=X)throw console.warn(`[ar] captureFrame: the camera gave no picture in ${X} frames`),new A("failed");if(await new Promise(v=>requestAnimationFrame(v)),m!==h)throw new A("notRunning")}const f=document.createElement("canvas");f.width=a.videoWidth,f.height=a.videoHeight;const g=f.getContext("2d");if(!g)throw new A("failed");g.drawImage(a,0,0);const w=await new Promise(y=>f.toBlob(y,"image/jpeg",.9));if(!w)throw new A("failed");return{data:await w.arrayBuffer(),name:"frame.jpg"}},close(){_()}}})};export{kt as register};