@akanjs/cli 3.0.0-alpha.66 → 3.0.0-alpha.68

package/.build-stamp

@@ -1 +1 @@
-9aa6bbc9a3c9ef9ff25aa95015f54834f3a9f39d7f76d5b9cc7704a55a0f57b8
+45913df1b25861ac83c5cec54131c1edd97946b5e28ceb2297776a553e68d432

package/{agent.command-7vr15vkn.js → agent.command-0cmqr1jg.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   AgentScript
-} from "./index-0jn016vv.js";
-import"./index-xda7qe2j.js";
-import"./index-8vv6xtm5.js";
+} from "./index-zsey7djg.js";
+import"./index-64yeb8sh.js";
+import"./index-vgntcq1j.js";
 import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-1f34snpd.js";
-import"./index-w008bx1p.js";
+} from "./index-54kzhhbz.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{application.command-nrq6qvkh.js → application.command-rb1dtwdd.js}

@@ -4,8 +4,8 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-a6k0b1b5.js";
-import"./index-k8k45qfk.js";
+} from "./index-h0mh2q0g.js";
+import"./index-mj0gjph9.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
@@ -15,10 +15,10 @@ import {
   Sys,
   Workspace,
   command
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 import"./index-fgc8r6dj.js";
 import"./index-5vy2jzar.js";
-import"./index-w008bx1p.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{applicationBuildRunner-jnjag4ay.js → applicationBuildRunner-af0wtspv.js}

@@ -2,9 +2,10 @@
 import {
   AllRoutesBuilder,
   CsrArtifactBuilder,
+  FontPruner,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-xesyg6bc.js";
+} from "./index-abyjt72y.js";
 import"./index-xjd3rqzj.js";
 import"./index-qnv0aqmm.js";
 import"./index-5vy2jzar.js";
@@ -23,6 +24,7 @@ var BUILD_PHASE_EMOJIS = {
   backend: "\uD83D\uDCE6",
   ssr: "\uD83E\uDDED",
   csr: "\uD83C\uDFA8",
+  assets: "\u2702\uFE0F",
   compress: "\uD83D\uDDDC\uFE0F",
   metadata: "\uD83D\uDCDD"
 };
@@ -58,7 +60,7 @@ class ApplicationBuildRunner {
   }
   async build({ spinner = false } = {}) {
     const phaseOptions = { spinner };
-    const { web } = await this.#app.getConfig();
+    const { web, assets } = await this.#app.getConfig();
     await this.#runPhase("prepare", "Preparing output directory", () => this.#app.prepareCommand("build"), undefined, {
       spinner
     });
@@ -67,6 +69,7 @@ class ApplicationBuildRunner {
     await this.#runPhase("backend", "Compiling backend", () => this.#buildBackend(), (result) => `${result.entrypoints} entrypoints, ${result.outputs} outputs`, phaseOptions);
     await this.#runPhase("ssr", "Building SSR route artifacts", async () => web.ssr ? await this.#buildSsr() : null, (result) => result ? `${result.allRoutes.manifest.routeIds.length} routes, ${result.allRoutes.manifest.knownEntries.length} entries` : web.ssr ? "skipped" : "disabled by akan.config.ts web.ssr", phaseOptions);
     await this.#runPhase("csr", "Building CSR assets", async () => web.csr ? await this.#buildCsr() : null, (result) => result?.outputDir ?? (web.csr ? "skipped" : "disabled by akan.config.ts web.csr"), phaseOptions);
+    await this.#runPhase("assets", "Trimming unread static assets", async () => assets.pruneFonts ? await new FontPruner(this.#app, assets).prune() : null, (result) => result ? `${result.removed.length} font file(s) dropped, ${ApplicationBuildRunner.formatBytes(result.freedBytes)} freed; ${result.kept.length} kept` : "disabled by akan.config.ts assets.pruneFonts", phaseOptions);
     await this.#runPhase("compress", "Compressing static assets", () => precompressArtifacts(this.#app), (result) => result.files > 0 ? `${result.files} files, ${ApplicationBuildRunner.formatBytes(result.inputBytes)} -> gzip ${ApplicationBuildRunner.formatBytes(result.outputBytes)} / br ${ApplicationBuildRunner.formatBytes(result.brotliBytes)}` : "no files", phaseOptions);
     await this.#runPhase("metadata", "Writing production metadata", () => this.#buildAppMeta(), undefined, {
       spinner

package/buildBatch.proc.js

@@ -5,14 +5,14 @@ import {
   FontOptimizer,
   PagesBundleBuilder,
   SsrBaseArtifactBuilder
-} from "./index-xesyg6bc.js";
+} from "./index-abyjt72y.js";
 import"./index-xjd3rqzj.js";
 import"./index-qnv0aqmm.js";
 import"./index-5vy2jzar.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{capacitorApp-w1ryppdw.js → capacitorApp-eep7xz8f.js}

@@ -25,9 +25,9 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-jbhecvr9.js";
+} from "./index-1rdjjbh3.js";
 import"./index-76rn3g2c.js";
-import"./index-w008bx1p.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{cloud.command-crwf7emx.js → cloud.command-8v0kdhsk.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   CloudScript
-} from "./index-bzthvy50.js";
-import"./index-cnyeq88g.js";
-import"./index-6s8snbb8.js";
+} from "./index-wda1nmq9.js";
+import"./index-dnaz1wgm.js";
+import"./index-c60r0ch7.js";
 import {
   GlobalConfig
 } from "./index-sh01r3pm.js";
-import"./index-a6k0b1b5.js";
-import"./index-k8k45qfk.js";
+import"./index-h0mh2q0g.js";
+import"./index-mj0gjph9.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 import"./index-fgc8r6dj.js";
 import"./index-5vy2jzar.js";
-import"./index-w008bx1p.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{context.command-xbsgta4f.js → context.command-rbfvzdr5.js}

@@ -1,25 +1,25 @@
 // @bun
 import {
   ContextScript
-} from "./index-gkg6e6cx.js";
-import"./index-hpbf1b1e.js";
-import"./index-8xeg8ehr.js";
-import"./index-639mgtfm.js";
-import"./index-9ppq2sx0.js";
-import"./index-d5ef8n21.js";
+} from "./index-gzvqqkv0.js";
+import"./index-1ngstd4e.js";
+import"./index-n6sd13k2.js";
+import"./index-4z07epxz.js";
+import"./index-9rhhv7kt.js";
+import"./index-xgd380f4.js";
 import"./index-ss469dec.js";
-import"./index-7kxz2z5t.js";
-import"./index-jbhecvr9.js";
+import"./index-0c7xjgq8.js";
+import"./index-1rdjjbh3.js";
 import"./index-sh01r3pm.js";
-import"./index-xda7qe2j.js";
-import"./index-8vv6xtm5.js";
+import"./index-64yeb8sh.js";
+import"./index-vgntcq1j.js";
 import"./index-j37qq1f2.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-1f34snpd.js";
-import"./index-w008bx1p.js";
+} from "./index-54kzhhbz.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";

package/{guideline.command-mm19n009.js → guideline.command-92fb2x3p.js}

@@ -10,8 +10,8 @@ import {
   command,
   runner,
   script
-} from "./index-1f34snpd.js";
-import"./index-w008bx1p.js";
+} from "./index-54kzhhbz.js";
+import"./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import {

package/guidelines/conventions/conventions.instruction.md

@@ -366,6 +366,40 @@ const config: AppConfig = { docker: "FROM oven/bun:1-slim\n…" }; // verbatim,
 - `AkanAppConfig.docker` is the resolved declaration; `AkanAppConfig.dockerfile` is the text `akan build` writes
   to `dist/apps/<app>/Dockerfile`.
 
+## Shipped Assets — `assets` In `akan.config.ts`
+
+`akan build` copies the whole `public/` tree into `dist`, lib assets dereferenced, and that copy is the image.
+**`assets: { pruneFonts, keepFonts }`** trims the fonts out of it that nothing reads. **Source trees are never
+touched** — an app's and a lib's own `public/` keep every file, because one shared font folder is picked over
+differently by every app that mounts it and by other repos.
+
+```ts
+const config: LibConfig = { assets: { keepFonts: ["fonts/Assistant-*.woff2"] } }; // libs/<lib>/akan.config.ts
+const config: AppConfig = { assets: { pruneFonts: false } }; // emergency valve, not the normal escape hatch
+```
+
+- **A font with `optimize` on is a build input, not a runtime asset.** `FontOptimizer` subsets it into
+  `.akan/artifact/fonts` and the emitted CSS points at `/_akan/fonts/*`, which `WebRouter` serves from the
+  artifact — so the source in `public/` is never opened again. That is the bulk of what this drops, and it
+  applies to the fonts the app *does* use, not only the ones it does not.
+- **The keep-set is derived per app, per build; there is no list of fonts to drop.** An exclude list would rot
+  the moment another app or repo started using one of them, and nobody would know to update it. A font survives
+  because ① its font declares `optimize: false`, so `FontCss.getRuntimeCss` emits the raw src; ② something
+  references its filename — anything under `public/`, the compiled stylesheet, a client/server bundle, the CSR
+  shell; or ③ a `keepFonts` glob names it.
+- **`keepFonts` belongs to the `akan.config.ts` that owns the font**, written against that lib's or app's own
+  `public/` (`"fonts/X.woff2"`, resolved to `libs/<lib>/fonts/X.woff2`). A lib shared across repos carries the
+  reason its own CSS needs a font, instead of every mounting app rediscovering it in production.
+- **A reference from a build bundle is ignored for an already-subset font.** Every route file's `fonts`
+  declaration is inlined into the pages bundle, the client chunks and the CSR shell, so a declared source is in
+  all three whether or not anything loads it. `public/` and the compiled CSS are read as authoritative.
+- **A generated manifest that lists every public asset keeps every font it names** — a service-worker precache
+  file is the usual one. That is a real reference, not a false positive, so the build reports it at `info`:
+  read the `[font-prune] kept …` line before concluding the prune does nothing.
+- Matching is by filename, including the percent-encoded spelling, so a `url()` survives however it is written.
+- The phase is `assets`, between `csr` and `compress`. An api-only build (`web: false`) copies no `public/` and
+  the phase finds nothing to do.
+
 ## React Components And Styling (`**/*.tsx`)
 
 - Components are `export const X = ({ … }: XProps) => { return (…); };` — arrow const with a block body. `export default` is reserved for pages, layouts, and `lazy()` targets.

package/incrementalBuilder.proc.js

@@ -16,7 +16,7 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 import"./index-f39512t6.js";
 import"./index-mxvakhsm.js";
 import"./index-1577bej2.js";

package/{index-7kxz2z5t.js → index-0c7xjgq8.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-hpbf1b1e.js → index-1ngstd4e.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-xda7qe2j.js";
+} from "./index-64yeb8sh.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-8vv6xtm5.js";
+} from "./index-vgntcq1j.js";
 import {
   runner
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-jbhecvr9.js → index-1rdjjbh3.js}

@@ -5,7 +5,7 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   CommandExecutionError
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";

package/{index-639mgtfm.js → index-4z07epxz.js}

@@ -9,14 +9,14 @@ import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-8vv6xtm5.js";
+} from "./index-vgntcq1j.js";
 import {
   Prompter
 } from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";

package/{index-1f34snpd.js → index-54kzhhbz.js}

@@ -6,7 +6,7 @@ import {
   ModuleExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 import {
   getDirname
 } from "./index-1577bej2.js";

package/{index-xda7qe2j.js → index-64yeb8sh.js}

@@ -2,7 +2,7 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-8vv6xtm5.js";
+} from "./index-vgntcq1j.js";
 import {
   AppExecutor,
   LibExecutor,
@@ -11,7 +11,7 @@ import {
   readDevkitVersion,
   rootAllowedDirs,
   rootAllowedFiles
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,

package/{index-w008bx1p.js → index-8ve7n6yj.js}

@@ -268,7 +268,8 @@ var DEFAULT_AKAN_IMAGE_CONFIG = {
   dangerouslyAllowSVG: false,
   maximumRedirects: 3,
   fetchTimeoutMs: 7000,
-  maxRemoteBytes: 25 * 1024 * 1024
+  maxRemoteBytes: 25 * 1024 * 1024,
+  maxConcurrency: 0
 };
 var normalizeIndexPath = (indexPath) => {
   const normalized = indexPath?.trim();
@@ -317,8 +318,12 @@ var normalizeDeepLinks = (deepLinks) => {
 };
 var emptyLibContributions = () => ({
   externalLibs: [],
-  docker: { preRuns: [], postRuns: [] }
+  docker: { preRuns: [], postRuns: [] },
+  keepFonts: []
 });
+var normalizeKeepFonts = (keepFonts) => [
+  ...new Set((keepFonts ?? []).map((glob) => glob.trim().replace(/^\/+/, "")).filter(Boolean))
+];
 var dedupeDockerRuns = (runs) => {
   const byKey = new Map;
   for (const run of runs)
@@ -342,6 +347,7 @@ class AkanAppConfig {
   mobile;
   hasMobileConfig;
   secrets;
+  assets;
   syncPageLibs;
   baseDevEnv;
   libs;
@@ -372,6 +378,13 @@ class AkanAppConfig {
     process.env.AKAN_PUBLIC_LOCALES = this.i18n.locales.join(",");
     this.publicEnv = config?.publicEnv ?? [];
     this.secrets = config?.secrets ?? [];
+    this.assets = {
+      pruneFonts: config?.assets?.pruneFonts ?? true,
+      keepFonts: [
+        ...normalizeKeepFonts(config?.assets?.keepFonts),
+        ...libContributions.keepFonts ?? []
+      ]
+    };
     this.syncPageLibs = config?.syncPageLibs ?? false;
     this.hasMobileConfig = Boolean(config.mobile);
     this.mobile = this.#resolveMobileConfig(config.mobile);
@@ -569,7 +582,8 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       docker: {
         preRuns: libConfigs.flatMap((libConfig) => libConfig?.docker.preRuns ?? []),
         postRuns: libConfigs.flatMap((libConfig) => libConfig?.docker.postRuns ?? [])
-      }
+      },
+      keepFonts: libConfigs.flatMap((libConfig) => (libConfig?.assets.keepFonts ?? []).map((glob) => `libs/${libConfig?.lib.name}/${glob}`))
     };
   }
   #resolveProductionDependencyVersion(lib) {
@@ -669,11 +683,13 @@ class AkanLibConfig {
   lib;
   externalLibs;
   docker;
+  assets;
   plugins;
   constructor(lib, config, plugins = []) {
     this.lib = lib;
     this.externalLibs = config?.externalLibs ?? [];
     this.docker = { preRuns: config?.docker?.preRuns ?? [], postRuns: config?.docker?.postRuns ?? [] };
+    this.assets = { keepFonts: normalizeKeepFonts(config?.assets?.keepFonts) };
     this.plugins = plugins;
   }
   static async from(lib, { bustImportCache = false } = {}) {
@@ -2691,7 +2707,7 @@ class AppExecutor extends SysExecutor {
     } else {
       await this.removeDir(".akan");
       if (!akanConfig2.web.ssr || !akanConfig2.web.csr)
-        this.logger.warn(`akan.config.ts disables web.${!akanConfig2.web.ssr ? "ssr" : "csr"}; \`akan start\` still serves it, \`akan build\` will not`);
+        this.logger.verbose(`akan.config.ts disables web.${!akanConfig2.web.ssr ? "ssr" : "csr"}; \`akan start\` still serves it, \`akan build\` will not`);
     }
     if (type === "start")
       process.env.NODE_ENV = "development";

package/{index-9ppq2sx0.js → index-9rhhv7kt.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-d5ef8n21.js";
+} from "./index-xgd380f4.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-8vv6xtm5.js";
+} from "./index-vgntcq1j.js";
 import {
   script
-} from "./index-1f34snpd.js";
+} from "./index-54kzhhbz.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-w008bx1p.js";
+} from "./index-8ve7n6yj.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";