@tantawowa/hosanna-tools 3.10.2 → 3.12.0

package/README.md

@@ -282,6 +282,8 @@ Supported inputs include `file/line: pkg:/components/source_0.brs(7475)`, `at ..
 
 Production JavaScript bundles strip `console.*` calls by default. Configure this through the normal overlay chain with `build.stripLogs`: set it to `false` in `build-config/prod.json` to retain production logs, or in `build-config/prod.apple.json` / `build-config/prod.web.json` for a platform-only exception. Non-production environments keep logs unless their overlay explicitly enables stripping. Apple `prod` builds use Xcode `Release`; other environments continue to use `Debug`.
 
+Roku builds also populate `assetServer.baseUrl` when an overlay does not define it. `hst run` uses the resolved project Vite port and a reachable LAN IPv4 address. Override either the complete URL with `HS_ASSET_SERVER_BASE_URL`, or its parts with `HS_ASSET_SERVER_HOST` and `HS_ASSET_SERVER_PORT`; the equivalent `HOSANNA_ASSET_SERVER_*` names are also accepted. Explicit build-config overlays remain authoritative. The legacy `game.assetBaseUrl` setting is generated independently for backward compatibility.
+
 Native builds can resolve config immediately before the platform build:
 
 ```bash

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-07-18T16:38:55+00:00",
-  "buildDateISO": "2026-07-18T16:38:55.954Z",
+  "buildDate": "2026-07-22T14:50:04+00:00",
+  "buildDateISO": "2026-07-22T14:50:04.139Z",
   "timeZone": "UTC",
-  "gitHash": "7387408"
+  "gitHash": "04ad2ea"
 }

package/dist/cli.js

@@ -59,6 +59,7 @@ const generation_utils_js_2 = require("./generation/generation-utils.js");
 const env_info_js_1 = require("./lib/env-info.js");
 const hosanna_tools_utils_js_1 = require("./lib/hosanna-tools-utils.js");
 const cli_app_config_resolve_js_1 = require("./lib/cli.app-config-resolve.js");
+const cli_app_config_compile_js_1 = require("./lib/cli.app-config-compile.js");
 const hosanna_config_js_1 = require("./lib/hosanna-config.js");
 function formatRunPlanText(plan, explain, command = 'run') {
     const lines = [
@@ -134,6 +135,10 @@ function runPlanFlagsFromCliArgs(args, format) {
         format,
         explain: rawHasFlag('explain') ? Boolean(args.explain) : undefined,
         allowProfileInProd: rawHasFlag('allow-profile-in-prod') ? Boolean(args['allow-profile-in-prod']) : undefined,
+        shapeDelivery: rawHasFlag('shape-delivery') ? args['shape-delivery'] : undefined,
+        fontDelivery: rawHasFlag('font-delivery') ? args['font-delivery'] : undefined,
+        bundleRevision: rawHasFlag('bundle-revision') ? args['bundle-revision'] : undefined,
+        rebuildAppConfig: rawHasFlag('rebuild-app-config') ? Boolean(args['rebuild-app-config']) : undefined,
         passthroughArgs: args['--'],
     };
 }
@@ -568,6 +573,77 @@ catch (err) {
         console.error(`Failed to resolve app config: ${message}`);
         process.exit(1);
     }
+})
+    .command('app-config:compile', 'Resolve AppConfig and materialize precompiled theme shapes, bundled fonts, and an asset-bundle manifest', yargs => yargs
+    .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector' })
+    .option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
+    .option('expression', { type: 'string', describe: 'Expression selector such as tv, phone, or tablet' })
+    .option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
+    .option('out', { type: 'string', describe: 'Final resolved AppConfig output path' })
+    .option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
+    .option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], default: 'runtime', describe: 'Default delivery for shapes without an entry-level override' })
+    .option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], default: 'embedded', describe: 'Default delivery for font objects without an entry-level override' })
+    .option('bundle-id', { type: 'string', describe: 'Asset bundle id used in cachefs URIs' })
+    .option('bundle-revision', { type: 'string', describe: 'Manual bundle version revision used to invalidate device caches' })
+    .option('bundle-config-key', { type: 'string', default: 'compiledTheme', describe: 'Key written beneath AppConfig assetBundles' })
+    .option('bundle-output-dir', { type: 'string', default: 'public/asset-bundles', describe: 'Publishable asset-bundle output root' })
+    .option('asset-url-root', { type: 'string', default: '/asset-bundles', describe: 'HTTP URL root written into bundle asset descriptors' })
+    .option('watch', { type: 'boolean', default: false, describe: 'Watch AppConfig inheritance and local bundled files' })
+    .option('rebuild', { type: 'boolean', default: false, describe: 'Re-render compiler assets instead of reusing the incremental cache' })
+    .option('force', { type: 'boolean', default: false, describe: 'Rewrite unchanged compiler-owned files' }), async (args) => {
+    try {
+        await (0, cli_app_config_compile_js_1.runAppConfigCompileCommand)({
+            cwd: args.cwd,
+            input: args.input,
+            expression: args.expression,
+            platform: args.platform,
+            out: args.out,
+            generatedDir: args.generatedDir,
+            shapeDelivery: args.shapeDelivery,
+            fontDelivery: args.fontDelivery,
+            bundleId: args.bundleId,
+            bundleRevision: args.bundleRevision,
+            bundleConfigKey: args.bundleConfigKey,
+            bundleOutputDir: args.bundleOutputDir,
+            assetUrlRoot: args.assetUrlRoot,
+            watch: Boolean(args.watch),
+            rebuild: Boolean(args.rebuild),
+            force: Boolean(args.force),
+        });
+        if (!args.watch)
+            process.exit(0);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to compile app config: ${message}`);
+        process.exit(1);
+    }
+})
+    .command('app-config:clean', 'Remove compiler-owned AppConfig package, asset bundle, and incremental caches for one target', yargs => yargs
+    .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector used to infer the target' })
+    .option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
+    .option('expression', { type: 'string', describe: 'Expression selector such as tv, phone, or tablet' })
+    .option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
+    .option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
+    .option('bundle-id', { type: 'string', describe: 'Asset bundle id to remove' })
+    .option('bundle-output-dir', { type: 'string', default: 'public/asset-bundles', describe: 'Asset-bundle output root' }), args => {
+    try {
+        (0, cli_app_config_compile_js_1.runAppConfigCleanCommand)({
+            cwd: args.cwd,
+            input: args.input,
+            expression: args.expression,
+            platform: args.platform,
+            generatedDir: args.generatedDir,
+            bundleId: args.bundleId,
+            bundleOutputDir: args.bundleOutputDir,
+        });
+        process.exit(0);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to clean app config: ${message}`);
+        process.exit(1);
+    }
 })
     .command('native:init [platform]', 'Initialize app-owned Hosanna native thin projects and config', yargs => yargs
     .positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to initialize' })
@@ -1803,6 +1879,10 @@ catch (err) {
     .option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
     .option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
     .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to web/native launch inputs' })
+    .option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
+    .option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
+    .option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
+    .option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this build' })
     .option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
     .option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
     .option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
@@ -1869,6 +1949,10 @@ catch (err) {
     .option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
     .option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
     .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to web/native launch inputs' })
+    .option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
+    .option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
+    .option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
+    .option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this run' })
     .option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
     .option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
     .option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })