@stacksjs/stx 0.2.120 → 0.2.122

package/dist/index.d.ts

@@ -54,6 +54,7 @@ export * from './a11y';
 export * from './analytics';
 export * from './analyzer';
 export * from './animation';
+export * from './appearance-bootstrap';
 export * from './assets';
 export * from './app-shell';
 export * from './async-components';

package/dist/index.js

@@ -13,6 +13,7 @@ export * from "./a11y.js";
 export * from "./analytics.js";
 export * from "./analyzer.js";
 export * from "./animation.js";
+export * from "./appearance-bootstrap.js";
 export * from "./assets.js";
 export * from "./app-shell.js";
 export * from "./async-components.js";

package/dist/native-build.d.ts

@@ -62,10 +62,16 @@ export declare interface NativeBuildConfig {
     }
   }
   systemTray?: boolean
+  menubarOnly?: boolean
+  infoPlist?: Record<string, string | number | boolean>
+  minimumSystemVersion?: string
+  category?: string
+  copyright?: string
   hotReload?: boolean
   devTools?: boolean
   craftPath?: string
   env?: Record<string, string>
+  context?: Record<string, unknown>
   verbose?: boolean
 }
 export declare interface NativeBuildResult {

package/dist/native-build.js

@@ -4,6 +4,7 @@ import { spawn, execSync } from "node:child_process";
 import { tmpdir, homedir, platform as osPlatform } from "node:os";
 import { injectCraftBridge } from "./craft-bridge.js";
 import { processCraftComponents, CRAFT_COMPONENT_STYLES } from "./craft-components.js";
+import { renderTemplate } from "./render.js";
 export async function buildNative(config) {
   const startTime = Date.now();
   try {
@@ -17,7 +18,10 @@ export async function buildNative(config) {
     const target = config.target || detectPlatform(), format = config.format || getDefaultFormat(target), outputDir = config.output || join(process.cwd(), "dist", "native");
     if (!existsSync(outputDir))
       mkdirSync(outputDir, { recursive: !0 });
-    let html = await Bun.file(config.input).text();
+    let html = await renderTemplate(config.input, {
+      context: config.context,
+      options: { isDev: !1 }
+    });
     html = injectCraftBridge(html, { debug: config.verbose });
     html = processCraftComponents(html);
     if (!html.includes("craft-component-styles")) {
@@ -87,64 +91,51 @@ async function buildMacOS(html, appName, appVersion, outputDir, format, config,
     sidebarConfigPath = join(resourcesDir, "sidebar-config.json");
     await Bun.write(sidebarConfigPath, JSON.stringify(config.sidebar.config));
   }
-  const sidebarFlags = config.sidebar?.enabled ? `--native-sidebar --sidebar-width ${config.sidebar?.width || 240} --sidebar-config "$(cat "$RESOURCES/sidebar-config.json")"` : "", launcherScript = `#!/bin/bash
+  const sidebarFlags = config.sidebar?.enabled ? `--native-sidebar --sidebar-width ${config.sidebar?.width || 240} --sidebar-config "$(cat "$RESOURCES/sidebar-config.json")"` : "", craftBinaryDest = join(macOSDir, "craft");
+  copyFileSync(craftPath, craftBinaryDest);
+  chmodSync(craftBinaryDest, 493);
+  const menubarOnly = config.menubarOnly ?? config.systemTray, launcherScript = `#!/bin/bash
+set -euo pipefail
 DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd )"
 RESOURCES="$DIR/../Resources"
-"${craftPath}" --html "$(cat "$RESOURCES/index.html")" \\
-  --title "${config.window?.title || appName}" \\
-  --width ${config.window?.width || 1200} \\
-  --height ${config.window?.height || 800} \\
-  ${config.systemTray ? "--system-tray" : ""} \\
-  ${config.devTools ? "--dev-tools" : ""} \\
-  ${config.window?.frameless ? "--frameless" : ""} \\
-  ${config.window?.alwaysOnTop ? "--always-on-top" : ""} \\
-  ${sidebarFlags}
+exec "$DIR/craft" --html-file "$RESOURCES/index.html" \\
+  ${[
+    `--title "${config.window?.title || appName}"`,
+    `--width ${config.window?.width || 1200}`,
+    `--height ${config.window?.height || 800}`,
+    menubarOnly ? "--menubar-only" : config.systemTray ? "--system-tray" : "",
+    config.devTools ? "" : "--no-devtools",
+    config.window?.frameless ? "--frameless" : "",
+    config.window?.transparent ? "--transparent" : "",
+    config.window?.alwaysOnTop ? "--always-on-top" : "",
+    config.window?.resizable === !1 ? "--no-resize" : "",
+    sidebarFlags
+  ].filter(Boolean).join(" \\\n  ")}
 `, launcherPath = join(macOSDir, appName);
   await Bun.write(launcherPath, launcherScript);
   chmodSync(launcherPath, 493);
-  const craftBinaryDest = join(macOSDir, "craft");
-  try {
-    copyFileSync(craftPath, craftBinaryDest);
-    chmodSync(craftBinaryDest, 493);
-  } catch {
-    const craftWrapperScript = `#!/bin/bash
-exec "${craftPath}" "$@"`;
-    await Bun.write(craftBinaryDest, craftWrapperScript);
-    chmodSync(craftBinaryDest, 493);
-  }
-  const infoPlist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>CFBundleExecutable</key>
-    <string>${appName}</string>
-    <key>CFBundleIdentifier</key>
-    <string>${bundleId}</string>
-    <key>CFBundleName</key>
-    <string>${appName}</string>
-    <key>CFBundleDisplayName</key>
-    <string>${appName}</string>
-    <key>CFBundleShortVersionString</key>
-    <string>${appVersion}</string>
-    <key>CFBundleVersion</key>
-    <string>${appVersion}</string>
-    <key>CFBundlePackageType</key>
-    <string>APPL</string>
-    <key>CFBundleSignature</key>
-    <string>????</string>
-    <key>LSMinimumSystemVersion</key>
-    <string>10.15</string>
-    <key>NSHighResolutionCapable</key>
-    <true/>
-    <key>NSSupportsAutomaticGraphicsSwitching</key>
-    <true/>
-    <key>LSUIElement</key>
-    <${config.systemTray ? "true" : "false"}/>
-</dict>
-</plist>`;
-  await Bun.write(join(contentsDir, "Info.plist"), infoPlist);
-  if (config.icon && await Bun.file(config.icon).exists())
+  const hasIcon = Boolean(config.icon && await Bun.file(config.icon).exists());
+  if (hasIcon)
     copyFileSync(config.icon, join(resourcesDir, "AppIcon.icns"));
+  const plistEntries = {
+    CFBundleExecutable: appName,
+    CFBundleIdentifier: bundleId,
+    CFBundleName: appName,
+    CFBundleDisplayName: appName,
+    CFBundleShortVersionString: appVersion,
+    CFBundleVersion: appVersion,
+    CFBundlePackageType: "APPL",
+    CFBundleSignature: "????",
+    LSMinimumSystemVersion: config.minimumSystemVersion || "13.0",
+    NSHighResolutionCapable: !0,
+    NSSupportsAutomaticGraphicsSwitching: !0,
+    LSUIElement: config.menubarOnly ?? Boolean(config.systemTray),
+    ...hasIcon ? { CFBundleIconFile: "AppIcon" } : {},
+    ...config.category ? { LSApplicationCategoryType: config.category } : {},
+    ...config.copyright ? { NSHumanReadableCopyright: config.copyright } : {},
+    ...config.infoPlist || {}
+  };
+  await Bun.write(join(contentsDir, "Info.plist"), renderInfoPlist(plistEntries));
   if (format === "dmg") {
     const dmgPath = join(outputDir, `${appName}-${appVersion}.dmg`), dmgResult = await createDMG(appBundlePath, dmgPath, appName);
     if (!dmgResult.success)
@@ -153,19 +144,38 @@ exec "${craftPath}" "$@"`;
   }
   return { success: !0, target: "macos", format: "app", outputPath: appBundlePath };
 }
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function renderInfoPlist(entries) {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${Object.entries(entries).map(([key, value]) => {
+    const rendered = typeof value === "boolean" ? `<${value}/>` : typeof value === "number" ? `<integer>${value}</integer>` : `<string>${escapeXml(String(value))}</string>`;
+    return `    <key>${escapeXml(key)}</key>
+    ${rendered}`;
+  }).join(`
+`)}
+</dict>
+</plist>
+`;
+}
 async function buildWindows(html, appName, appVersion, outputDir, format, config, craftPath) {
   const appDir = join(outputDir, appName);
   mkdirSync(appDir, { recursive: !0 });
   const htmlPath = join(appDir, "index.html");
   await Bun.write(htmlPath, html);
+  copyFileSync(craftPath, join(appDir, "craft.exe"));
   const launcherBat = `@echo off
 set DIR=%~dp0
-"${craftPath}" --html-file "%DIR%index.html" ^
+"%DIR%craft.exe" --html-file "%DIR%index.html" ^
   --title "${config.window?.title || appName}" ^
   --width ${config.window?.width || 1200} ^
   --height ${config.window?.height || 800} ^
   ${config.systemTray ? "--system-tray" : ""} ^
-  ${config.devTools ? "--dev-tools" : ""}
+  ${config.devTools ? "" : "--no-devtools"}
 `;
   await Bun.write(join(appDir, `${appName}.bat`), launcherBat);
   if (format === "zip") {
@@ -181,14 +191,18 @@ async function buildLinux(html, appName, appVersion, outputDir, format, config,
   mkdirSync(appDir, { recursive: !0 });
   const htmlPath = join(appDir, "index.html");
   await Bun.write(htmlPath, html);
+  const craftDest = join(appDir, "craft");
+  copyFileSync(craftPath, craftDest);
+  chmodSync(craftDest, 493);
   const launcherScript = `#!/bin/bash
+set -euo pipefail
 DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd )"
-"${craftPath}" --html-file "$DIR/index.html" \\
+exec "$DIR/craft" --html-file "$DIR/index.html" \\
   --title "${config.window?.title || appName}" \\
   --width ${config.window?.width || 1200} \\
   --height ${config.window?.height || 800} \\
   ${config.systemTray ? "--system-tray" : ""} \\
-  ${config.devTools ? "--dev-tools" : ""}
+  ${config.devTools ? "" : "--no-devtools"}
 `, launcherPath = join(appDir, appName.toLowerCase());
   await Bun.write(launcherPath, launcherScript);
   chmodSync(launcherPath, 493);
@@ -231,10 +245,13 @@ async function buildAndroid(_html, appName, _appVersion, _outputDir, _config, _c
   };
 }
 async function findCraftBinary() {
+  if (process.env.CRAFT_BIN && await Bun.file(process.env.CRAFT_BIN).exists())
+    return process.env.CRAFT_BIN;
   const possiblePaths = [
-    join(process.cwd(), "../../craft/packages/zig/zig-out/bin/craft-minimal"),
-    join(process.cwd(), "../craft/packages/zig/zig-out/bin/craft-minimal"),
-    join(homedir(), "Code/craft/packages/zig/zig-out/bin/craft-minimal"),
+    join(process.cwd(), "../../craft/packages/zig/zig-out/bin/craft"),
+    join(process.cwd(), "../craft/packages/zig/zig-out/bin/craft"),
+    join(homedir(), "Code/Tools/craft/packages/zig/zig-out/bin/craft"),
+    join(homedir(), "Code/craft/packages/zig/zig-out/bin/craft"),
     "/usr/local/bin/craft",
     "/usr/bin/craft",
     join(homedir(), ".local/bin/craft"),

package/dist/process.js

@@ -12,9 +12,10 @@ import { extractBridgeData, processClientScript } from "./client-script.js";
 import { processReactiveDirectives } from "./reactive.js";
 import { processMarkdownFileDirectives } from "./assets.js";
 import { processAuthDirectives, processConditionals, processEnvDirective, processIssetEmptyDirectives } from "./conditionals.js";
-import { injectCspMetaTag, processCspDirectives } from "./csp.js";
+import { addNonceToInlineContent, injectCspMetaTag, processCspDirectives } from "./csp.js";
 import { processCsrfDirectives } from "./csrf.js";
 import { processCustomDirectives } from "./custom-directives.js";
+import { processAppearanceBootstrapDirective } from "./appearance-bootstrap.js";
 import { devHelpers, errorLogger, errorRecovery, safeExecuteAsync, StxRuntimeError, StxValidationError } from "./error-handling.js";
 import { getHead as getHeadStatic } from "./head.js";
 import { processExpressions, usesSignalsInScript } from "./expressions.js";
@@ -669,6 +670,7 @@ async function processOtherDirectives(template, context, filePath, options, depe
   output = processXElementDirectives(output);
   const pageFilePath = context.__originalFilePath || filePath, serverData = extractBridgeData(context);
   output = await processSignals(output, opts, pageFilePath, serverData);
+  output = processAppearanceBootstrapDirective(output, context);
   output = await runPostProcessingMiddleware(output, context, filePath, opts);
   if (opts.media?.image?.autoSiblings) {
     const publicDir = opts.publicDir || "public", { rewriteImagesWithSiblings } = await import("./image-optimization/auto-sibling.js");
@@ -775,5 +777,7 @@ ${runtimeScript}`);
   }
   if (clientScriptsTransformed)
     context.__stx_event_bindings = [];
+  if (opts.csp?.enabled && opts.csp.useNonce && typeof context.cspNonce === "string")
+    output = addNonceToInlineContent(output, context.cspNonce);
   return output;
 }