lecodes-cli 2.4.1 → 2.4.3

package/src/commands/thumbs.ts

@@ -1,185 +1,185 @@
-import { createRequire } from "node:module"
-import { execFileSync } from "node:child_process"
-import { existsSync, mkdtempSync, readdirSync, rmSync, statSync } from "node:fs"
-import { tmpdir } from "node:os"
-import { extname, join, relative, resolve } from "node:path"
-import { loadPeer } from "../hosts/peerInstall"
-import { projectRootOf } from "./scene"
-import { CliError, bool, c, defineCommand, endProgress, log, note, num, progress, warnErr } from "../cli"
-import { toKey } from "../project/paths"
-
-/*
- * `lecodes thumbs [path…]` — the scene editor's asset thumbnails, generated from the COMMAND LINE.
- *
- * The editor renders previews in a hidden browser host (3D assets need an engine), but image
- * thumbnails need no engine at all — and a .ktx2 has no picture until something decodes it. This
- * command fills the same cache the editor reads (`.lecodes/preview/<asset>.<hash>.png`, owned by
- * lecodes-3d-editor's server/previewCache) with no browser in the loop, so opening the editor on a
- * texture-heavy project shows a full grid immediately instead of rendering 40 thumbnails on the
- * spot.
- *
- * Incremental by construction: the cache file name carries the first 10 hex of the SOURCE file's
- * sha256, so an asset whose preview is already there is skipped after one hash — re-running over a
- * big project is nearly free. `--force` ignores that.
- *
- * Decoders, in the order tried: sharp (through the optional `lecodes-assets` peer — handles webp),
- * else jimp (bundled with this CLI: png / jpeg / bmp / gif / tiff). KTX2 goes through
- * KTX-Software's `ktx extract` first (it is a GPU-compressed format; nothing in JS reads it), and
- * the extracted PNG then takes the same resize path.
- *
- * NOT covered: models, materials and prefabs — those are RENDERED, which needs an engine. The
- * editor still does them on demand (and `lecodes render --desktop` is the browserless renderer if
- * that ever becomes a batch job).
- */
-
-const DEFAULT_SIZE = 256
-const IMAGE_EXT = /\.(png|jpe?g|webp|bmp|gif|tiff?|ktx2)$/i
-const RENDERED_EXT = /\.(glb|gltf|material\.ts|scene\.ts)$/i
-
-/** KTX-Software's `ktx` CLI (v4.3+ has `extract`), resolved like lecodes-assets resolves toktx. */
-const findKtx = (): string | null => {
-  const exe = process.platform === "win32" ? "ktx.exe" : "ktx"
-  const candidates = [
-    process.env.LECODES_KTX,
-    process.env.KTX_CLI,
-    process.env.KTX_TOKTX?.replace(/toktx(\.exe)?$/i, exe),
-    process.platform === "win32" ? join(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
-    process.platform === "win32" ? join(process.env.ProgramFiles ?? "", "KTX-Software", "bin", exe) : null,
-    "/usr/local/bin/ktx",
-    "/opt/homebrew/bin/ktx",
-  ].filter((p): p is string => !!p)
-  for (const path of candidates) { if (existsSync(path)) return path }
-  try {
-    execFileSync(exe, [ "--version" ], { stdio: "ignore" })
-    return exe
-  } catch { return null }
-}
-
-type Resizer = (file: string, size: number) => Promise<Uint8Array>
-
-/** sharp through the `lecodes-assets` peer (it declares it optional), or null when neither is
- *  installed — jimp then covers everything but webp. */
-const sharpResizer = (): Resizer | null => {
-  try {
-    const req = createRequire(import.meta.url)
-    const sharp = createRequire(req.resolve("lecodes-assets/cli"))("sharp")
-    return async (file, size) =>
-      sharp(file).resize({ width: size, height: size, fit: "inside", withoutEnlargement: true }).png().toBuffer()
-  } catch { return null }
-}
-
-const jimpResizer = (): Resizer => async (file, size) => {
-  const { Jimp } = await import("jimp")
-  const img = await Jimp.read(file)
-  if (Math.max(img.width, img.height) > size) img.scaleToFit({ w: size, h: size })
-  return await img.getBuffer("image/png")
-}
-
-/** KTX2 → a temporary PNG (level 0, transcoded to RGBA8 when the payload is Basis-compressed). */
-const ktxToPng = (ktx: string, file: string, out: string): void => {
-  const run = (args: string[]) => execFileSync(ktx, args, { stdio: [ "ignore", "ignore", "pipe" ], encoding: "utf8" })
-  try {
-    run([ "extract", "--transcode", "rgba8", "--level", "0", file, out ])
-  } catch (e: any) {
-    // Only Basis (ETC1S/UASTC) payloads are transcodable; a plain uncompressed KTX2 extracts as-is
-    run([ "extract", "--level", "0", file, out ])
-    if (!existsSync(out)) throw e
-  }
-}
-
-/** Every previewable file under a folder — the SAME sweep the editor's asset panel lists with
- *  (node_modules + dotfiles out, nothing else): what this command doesn't cover, the browser would
- *  end up rendering itself. */
-const collect = (dir: string): string[] => {
-  const out: string[] = []
-  for (const name of readdirSync(dir)) {
-    if (name === "node_modules" || name.startsWith(".")) continue
-    const full = join(dir, name)
-    if (statSync(full).isDirectory()) out.push(...collect(full))
-    else if (IMAGE_EXT.test(name)) out.push(full)
-  }
-  return out
-}
-
-export default defineCommand({
-  name: "thumbs",
-  summary: "Asset thumbnails for the scene editor, without a browser",
-  usage: "[path…]",
-  description: "Decodes the project's images (KTX2 too, via KTX-Software's ktx tool) into the editor's preview cache. Incremental: the cached name carries the asset's content hash, so unchanged files are skipped. Models, materials and prefabs are rendered by the editor, not here.",
-  flags: {
-    force: bool("redo even the up-to-date ones"),
-    size: num("longest edge, px", { default: DEFAULT_SIZE }),
-  },
-  run: ({ args, flags }) => thumbs(args, flags.size, flags.force),
-})
-
-const thumbs = async (targets: string[], size: number, force: boolean): Promise<void> => {
-  const root = projectRootOf(process.cwd())
-
-  // The scene editor owns the preview cache — installed into ~/.lecodes/peers on first use.
-  const sceneServer = await loadPeer<typeof import("lecodes-3d-editor/server")>("lecodes-3d-editor", "server", { for: "lecodes thumbs" })
-
-  // Targets: the paths given (a file or a folder each), else the whole project.
-  let files: string[] = []
-  const rendered: string[] = []
-  if (targets.length > 0) {
-    for (const arg of targets) {
-      const abs = resolve(process.cwd(), arg)
-      if (!existsSync(abs)) throw new CliError(`No such file or folder: ${arg}`)
-      if (statSync(abs).isDirectory()) files.push(...collect(abs))
-      else if (IMAGE_EXT.test(abs)) files.push(abs)
-      else if (RENDERED_EXT.test(abs)) rendered.push(arg)
-      else throw new CliError(`Not a previewable asset: ${arg}`)
-    }
-  } else {
-    files = collect(root)
-  }
-  files = [ ...new Set(files) ]
-
-  if (files.length === 0 && rendered.length === 0) {
-    log("No images to thumbnail.")
-    return
-  }
-
-  const ktx = files.some((f) => f.toLowerCase().endsWith(".ktx2")) ? findKtx() : null
-  const sharp = sharpResizer()
-  const resize = sharp ?? jimpResizer()
-  const tmp = mkdtempSync(join(tmpdir(), "lecodes-thumbs-"))
-
-  let made = 0, fresh = 0
-  const skipped: string[] = []
-  try {
-    for (const [ i, file ] of files.entries()) {
-      const asset = "./" + toKey(relative(root, file))
-      progress(i, files.length, asset)
-      const hash = sceneServer.hashAsset(root, asset)
-      if (!hash) continue
-      if (!force && sceneServer.previewIsCurrent(root, asset, hash)) { fresh++; continue }
-
-      const ext = extname(file).toLowerCase()
-      if (ext === ".webp" && !sharp) { skipped.push(`${asset} (webp needs sharp — npm install -g lecodes-assets)`); continue }
-      try {
-        let source = file
-        if (ext === ".ktx2") {
-          if (!ktx) { skipped.push(`${asset} (KTX2 needs KTX-Software's \`ktx\` — set LECODES_KTX or put it on PATH)`); continue }
-          source = join(tmp, `${i}.png`)
-          ktxToPng(ktx, file, source)
-        }
-        sceneServer.writePreviewFile(root, asset, await resize(source, size))
-        made++
-      } catch (e: any) {
-        skipped.push(`${asset} (${(e?.message ?? String(e)).split("\n")[0]})`)
-      }
-    }
-  } finally {
-    endProgress()
-    rmSync(tmp, { recursive: true, force: true })
-  }
-
-  log(`${c.bold(String(made))} generated · ${fresh} already current${skipped.length > 0 ? ` · ${skipped.length} skipped` : ""}`)
-  for (const s of skipped) warnErr(s)
-  if (rendered.length > 0) {
-    warnErr(`Models, materials and prefabs are RENDERED, not decoded — the scene editor does those: ${rendered.join(", ")}`)
-  }
-  note(`Cache: ${join(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`)
-}
+import { createRequire } from "node:module"
+import { execFileSync } from "node:child_process"
+import { existsSync, mkdtempSync, readdirSync, rmSync, statSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { extname, join, relative, resolve } from "node:path"
+import { loadPeer } from "../hosts/peerInstall"
+import { projectRootOf } from "./scene"
+import { CliError, bool, c, defineCommand, endProgress, log, note, num, progress, warnErr } from "../cli"
+import { toKey } from "../project/paths"
+
+/*
+ * `lecodes thumbs [path…]` — the scene editor's asset thumbnails, generated from the COMMAND LINE.
+ *
+ * The editor renders previews in a hidden browser host (3D assets need an engine), but image
+ * thumbnails need no engine at all — and a .ktx2 has no picture until something decodes it. This
+ * command fills the same cache the editor reads (`.lecodes/preview/<asset>.<hash>.png`, owned by
+ * lecodes-3d-editor's server/previewCache) with no browser in the loop, so opening the editor on a
+ * texture-heavy project shows a full grid immediately instead of rendering 40 thumbnails on the
+ * spot.
+ *
+ * Incremental by construction: the cache file name carries the first 10 hex of the SOURCE file's
+ * sha256, so an asset whose preview is already there is skipped after one hash — re-running over a
+ * big project is nearly free. `--force` ignores that.
+ *
+ * Decoders, in the order tried: sharp (through the optional `lecodes-assets` peer — handles webp),
+ * else jimp (bundled with this CLI: png / jpeg / bmp / gif / tiff). KTX2 goes through
+ * KTX-Software's `ktx extract` first (it is a GPU-compressed format; nothing in JS reads it), and
+ * the extracted PNG then takes the same resize path.
+ *
+ * NOT covered: models, materials and prefabs — those are RENDERED, which needs an engine. The
+ * editor still does them on demand (and `lecodes render --desktop` is the browserless renderer if
+ * that ever becomes a batch job).
+ */
+
+const DEFAULT_SIZE = 256
+const IMAGE_EXT = /\.(png|jpe?g|webp|bmp|gif|tiff?|ktx2)$/i
+const RENDERED_EXT = /\.(glb|gltf|material\.ts|scene\.ts)$/i
+
+/** KTX-Software's `ktx` CLI (v4.3+ has `extract`), resolved like lecodes-assets resolves toktx. */
+const findKtx = (): string | null => {
+  const exe = process.platform === "win32" ? "ktx.exe" : "ktx"
+  const candidates = [
+    process.env.LECODES_KTX,
+    process.env.KTX_CLI,
+    process.env.KTX_TOKTX?.replace(/toktx(\.exe)?$/i, exe),
+    process.platform === "win32" ? join(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
+    process.platform === "win32" ? join(process.env.ProgramFiles ?? "", "KTX-Software", "bin", exe) : null,
+    "/usr/local/bin/ktx",
+    "/opt/homebrew/bin/ktx",
+  ].filter((p): p is string => !!p)
+  for (const path of candidates) { if (existsSync(path)) return path }
+  try {
+    execFileSync(exe, [ "--version" ], { stdio: "ignore" })
+    return exe
+  } catch { return null }
+}
+
+type Resizer = (file: string, size: number) => Promise<Uint8Array>
+
+/** sharp through the `lecodes-assets` peer (it declares it optional), or null when neither is
+ *  installed — jimp then covers everything but webp. */
+const sharpResizer = (): Resizer | null => {
+  try {
+    const req = createRequire(import.meta.url)
+    const sharp = createRequire(req.resolve("lecodes-assets/cli"))("sharp")
+    return async (file, size) =>
+      sharp(file).resize({ width: size, height: size, fit: "inside", withoutEnlargement: true }).png().toBuffer()
+  } catch { return null }
+}
+
+const jimpResizer = (): Resizer => async (file, size) => {
+  const { Jimp } = await import("jimp")
+  const img = await Jimp.read(file)
+  if (Math.max(img.width, img.height) > size) img.scaleToFit({ w: size, h: size })
+  return await img.getBuffer("image/png")
+}
+
+/** KTX2 → a temporary PNG (level 0, transcoded to RGBA8 when the payload is Basis-compressed). */
+const ktxToPng = (ktx: string, file: string, out: string): void => {
+  const run = (args: string[]) => execFileSync(ktx, args, { stdio: [ "ignore", "ignore", "pipe" ], encoding: "utf8" })
+  try {
+    run([ "extract", "--transcode", "rgba8", "--level", "0", file, out ])
+  } catch (e: any) {
+    // Only Basis (ETC1S/UASTC) payloads are transcodable; a plain uncompressed KTX2 extracts as-is
+    run([ "extract", "--level", "0", file, out ])
+    if (!existsSync(out)) throw e
+  }
+}
+
+/** Every previewable file under a folder — the SAME sweep the editor's asset panel lists with
+ *  (node_modules + dotfiles out, nothing else): what this command doesn't cover, the browser would
+ *  end up rendering itself. */
+const collect = (dir: string): string[] => {
+  const out: string[] = []
+  for (const name of readdirSync(dir)) {
+    if (name === "node_modules" || name.startsWith(".")) continue
+    const full = join(dir, name)
+    if (statSync(full).isDirectory()) out.push(...collect(full))
+    else if (IMAGE_EXT.test(name)) out.push(full)
+  }
+  return out
+}
+
+export default defineCommand({
+  name: "thumbs",
+  summary: "Asset thumbnails for the scene editor, without a browser",
+  usage: "[path…]",
+  description: "Decodes the project's images (KTX2 too, via KTX-Software's ktx tool) into the editor's preview cache. Incremental: the cached name carries the asset's content hash, so unchanged files are skipped. Models, materials and prefabs are rendered by the editor, not here.",
+  flags: {
+    force: bool("redo even the up-to-date ones"),
+    size: num("longest edge, px", { default: DEFAULT_SIZE }),
+  },
+  run: ({ args, flags }) => thumbs(args, flags.size, flags.force),
+})
+
+const thumbs = async (targets: string[], size: number, force: boolean): Promise<void> => {
+  const root = projectRootOf(process.cwd())
+
+  // The scene editor owns the preview cache — installed into ~/.lecodes/peers on first use.
+  const sceneServer = await loadPeer<typeof import("lecodes-3d-editor/server")>("lecodes-3d-editor", "server", { for: "lecodes thumbs" })
+
+  // Targets: the paths given (a file or a folder each), else the whole project.
+  let files: string[] = []
+  const rendered: string[] = []
+  if (targets.length > 0) {
+    for (const arg of targets) {
+      const abs = resolve(process.cwd(), arg)
+      if (!existsSync(abs)) throw new CliError(`No such file or folder: ${arg}`)
+      if (statSync(abs).isDirectory()) files.push(...collect(abs))
+      else if (IMAGE_EXT.test(abs)) files.push(abs)
+      else if (RENDERED_EXT.test(abs)) rendered.push(arg)
+      else throw new CliError(`Not a previewable asset: ${arg}`)
+    }
+  } else {
+    files = collect(root)
+  }
+  files = [ ...new Set(files) ]
+
+  if (files.length === 0 && rendered.length === 0) {
+    log("No images to thumbnail.")
+    return
+  }
+
+  const ktx = files.some((f) => f.toLowerCase().endsWith(".ktx2")) ? findKtx() : null
+  const sharp = sharpResizer()
+  const resize = sharp ?? jimpResizer()
+  const tmp = mkdtempSync(join(tmpdir(), "lecodes-thumbs-"))
+
+  let made = 0, fresh = 0
+  const skipped: string[] = []
+  try {
+    for (const [ i, file ] of files.entries()) {
+      const asset = "./" + toKey(relative(root, file))
+      progress(i, files.length, asset)
+      const hash = sceneServer.hashAsset(root, asset)
+      if (!hash) continue
+      if (!force && sceneServer.previewIsCurrent(root, asset, hash)) { fresh++; continue }
+
+      const ext = extname(file).toLowerCase()
+      if (ext === ".webp" && !sharp) { skipped.push(`${asset} (webp needs sharp — npm install -g lecodes-assets)`); continue }
+      try {
+        let source = file
+        if (ext === ".ktx2") {
+          if (!ktx) { skipped.push(`${asset} (KTX2 needs KTX-Software's \`ktx\` — set LECODES_KTX or put it on PATH)`); continue }
+          source = join(tmp, `${i}.png`)
+          ktxToPng(ktx, file, source)
+        }
+        sceneServer.writePreviewFile(root, asset, await resize(source, size))
+        made++
+      } catch (e: any) {
+        skipped.push(`${asset} (${(e?.message ?? String(e)).split("\n")[0]})`)
+      }
+    }
+  } finally {
+    endProgress()
+    rmSync(tmp, { recursive: true, force: true })
+  }
+
+  log(`${c.bold(String(made))} generated · ${fresh} already current${skipped.length > 0 ? ` · ${skipped.length} skipped` : ""}`)
+  for (const s of skipped) warnErr(s)
+  if (rendered.length > 0) {
+    warnErr(`Models, materials and prefabs are RENDERED, not decoded — the scene editor does those: ${rendered.join(", ")}`)
+  }
+  note(`Cache: ${join(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`)
+}

package/src/commands/web.ts

@@ -9,6 +9,7 @@ import { buildWeb } from "../web/build"
 import { startPreview } from "../web/preview"
 import { bundleFlags } from "./shared"
 import { lanCandidates, loadDevToken } from "./dev"
+import { devCertificate } from "../dev/https"
 
 /*
  * `lecodes web` — the project as a WEB PAGE (Web Lite: DOM and CSS, the browser's layout, text and
@@ -50,26 +51,31 @@ const kb = (bytes: number): string => bytes < 1024 ? `${bytes} B` : bytes < 1024
 const dev = defineCommand({
   name: "dev",
   summary: "Open the project as a web page, reloaded on every save",
-  description: "Serves the project's bundle and assets with the page of Web Lite around them; a save recompiles and runs the app again, the page's console output and errors stream back here. The address's hash is the route the app is opened with (#/product/42 → app.launchUrl).",
+  description: "Serves the project's bundle and assets with the page of Web Lite around them; a save recompiles and runs the app again, the page's console output and errors stream back here. The address's hash is the route the app is opened with (#/product/42 → app.launchUrl). A web half of the project's own (app.json `\"ar\": { \"web\": \"./plugins/ar-8thwall\" }`) is built with every compile and served beside the page, its `web.static` folder from the project.\n\n`--https`: the page over https, for a phone's camera and motion sensors (a browser gives them to a secure page only) — a self-signed certificate for localhost and this machine's LAN addresses, made once and kept in ~/.lecodes/dev-https/. The phone's browser warns about it: accept it once.",
   flags: {
     port: num("server port", { default: DEFAULT_PORT }),
     entry: bundleFlags.entry,
+    https: bool("serve over https with a self-signed certificate (a phone's camera and sensors need it)"),
     "no-open": bool("don't open the browser"),
   },
-  examples: ["lecodes web dev", "lecodes web dev --port 8080 --no-open"],
+  examples: ["lecodes web dev", "lecodes web dev --port 8080 --no-open", "lecodes web dev --https"],
   run: async ({ flags }) => {
     const { root, manifest, name } = project()
     const lite = litePage()
 
     const port = flags.port || DEFAULT_PORT
     // The page is opened on this machine; a phone on the same network reaches it by the LAN address.
-    const lan = lanCandidates()[0]?.address
-    const origin = `http://localhost:${port}`
+    const lans = lanCandidates().map((candidate) => candidate.address)
+    const lan = lans[0]
+    const scheme = flags.https ? "https" : "http"
+    const origin = `${scheme}://localhost:${port}`
+    const tls = flags.https ? await devCertificate(lans) : undefined
     const server = await startDevServer({
       root, manifest, name, origin, port,
       token: loadDevToken(root),
       entryOverride: flags.entry,
       lite,
+      tls,
       log: note,
     }).catch((e: unknown) => {
       const msg = e instanceof Error ? e.message : String(e)
@@ -95,7 +101,8 @@ const dev = defineCommand({
     log(`${c.bold("LeCodes Web")} — ${name}`)
     log("")
     log(`In the browser:  ${c.bold(url)}`)
-    if (lan) note(`On this network: ${url.replace("http://localhost:", `http://${lan}:`)}`)
+    if (lan) note(`On this network: ${url.replace(`${scheme}://localhost:`, `${scheme}://${lan}:`)}`)
+    if (tls) note("The certificate is this machine's own (~/.lecodes/dev-https): a browser warns about it — accept it once per device.")
     log("")
     log(`Watching ${root} — save a file to reload. Ctrl+C to stop.`)
 

package/src/compile/collect.ts

@@ -1,8 +1,7 @@
 import { readFileSync } from "node:fs"
-import { basename } from "node:path"
 import type { Project } from "../platform/api"
 import type { Manifest } from "../project/manifest"
-import { classifyKind, scanLocal } from "../project/localFiles"
+import { scanLocal } from "../project/localFiles"
 import { loadIgnore } from "../project/ignore"
 import { buildPaths } from "../project/materialize"
 import type { CompileEntry } from "./projectCompile"
@@ -35,7 +34,7 @@ export const collectEntries = (
   const warnings: string[] = []
   const scan = scanLocal(root, { ignore: loadIgnore(root), tracked: new Set(Object.keys(manifest.files)) })
   for (const file of scan.files) {
-    const type = manifest.files[file.path]?.type ?? classifyKind(basename(file.path))
+    const type = manifest.files[file.path]?.type ?? file.kind
     if (type === "resource") {
       const src = serverByPath.get(file.path)?.fileSrc
       if (!src && (opts.warnMissingUrl ?? true)) warnings.push(`No server URL for ${file.path} — push it so its URL resolves.`)

package/src/compile/collectLocal.ts

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs"
 import { basename } from "node:path"
 import type { Manifest } from "../project/manifest"
-import { classifyKind, scanLocal } from "../project/localFiles"
+import { scanLocal } from "../project/localFiles"
 import { loadIgnore } from "../project/ignore"
 import type { CompileEntry } from "./projectCompile"
 
@@ -13,6 +13,10 @@ import type { CompileEntry } from "./projectCompile"
  * in the artifacts; callers that don't pass `localShaders` keep the old degradation — an empty
  * artifact list + a push-once warning (same as `collectEntries` reports for unpushed shaders).
  */
+const isHalfManifest = (abs: string): boolean => {
+  try { return typeof (JSON.parse(readFileSync(abs, "utf8").replace(/^/, "")) as { implements?: unknown }).implements === "string" } catch { return false }
+}
+
 export const collectLocalEntries = (
   root: string, manifest: Manifest | null, assetBase: string,
   opts: { localShaders?: boolean } = {},
@@ -20,8 +24,15 @@ export const collectLocalEntries = (
   const entries: CompileEntry[] = []
   const warnings: string[] = []
   const scan = scanLocal(root, { ignore: loadIgnore(root), tracked: new Set(Object.keys(manifest?.files ?? {})) })
+  // A HALF FOLDER (a manifest that `implements` a first-party plugin) is no part of the app: its
+  // app side is the SDK's wrapper, its files are a platform's half and what that half fetches (a
+  // runtime of megabytes) — never read into a compile, never a candidate entry.
+  const halfFolders = scan.files
+    .filter((f) => basename(f.path) === "lecodes-plugin.json" && isHalfManifest(f.absPath))
+    .map((f) => f.path.slice(0, -"lecodes-plugin.json".length))
   for (const file of scan.files) {
-    const type = manifest?.files[file.path]?.type ?? classifyKind(basename(file.path))
+    if (halfFolders.some((dir) => file.path.startsWith(dir))) continue
+    const type = manifest?.files[file.path]?.type ?? file.kind
     if (type === "resource") {
       entries.push({ path: file.path, type, fileSrc: assetBase + encodeURI(file.path), absPath: file.absPath })
     } else if (type === "shader") {

package/src/compile/designCompile.ts

@@ -1,7 +1,6 @@
 import { readFileSync } from "node:fs"
-import { basename } from "node:path"
 import type { Manifest } from "../project/manifest"
-import { classifyKind, scanLocal } from "../project/localFiles"
+import { scanLocal } from "../project/localFiles"
 import { loadIgnore } from "../project/ignore"
 import { compileProject, type CompileEntry } from "./projectCompile"
 import { applyAssetIcons } from "./assetIcons"
@@ -44,7 +43,7 @@ export const compileDesignScreen = async (opts: {
   const entries: CompileEntry[] = []
   const scan = scanLocal(root, { ignore: loadIgnore(root), tracked: new Set(Object.keys(manifest?.files ?? {})) })
   for (const file of scan.files) {
-    const type = manifest?.files[file.path]?.type ?? classifyKind(basename(file.path))
+    const type = manifest?.files[file.path]?.type ?? file.kind
     if (type === "resource") {
       entries.push({
         path: file.path,

package/src/compile/projectCompile.ts

@@ -25,6 +25,9 @@ const resolveSdkInject = (): string | null => {
 }
 const sdkInject = resolveSdkInject()
 if (sdkInject) process.env.LECODES_SDK_INJECT = sdkInject
+/** The SDK's source tree projects compile against (null: none found) — where the first-party
+ *  plugins' contracts are read from too (plugin/firstParty.ts). */
+export const sdkSourceDir: string | null = sdkInject ? dirname(sdkInject) : null
 
 /** Absolute path to the chisel binary: env override → the @letary/chisel npm package → a chisel
  *  binary shipped next to the executable (standalone binary distribution). Null when none found. */