@absolutejs/absolute 0.20.0-beta.113 → 0.20.0-beta.114

package/CHANGELOG.md

@@ -6,6 +6,13 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.20.0-beta.114 — 2026-09-17
+
+### Added
+
+- **Capacitor and Expo share a first-class native branding pipeline** (`ABSOLUTE_CAPACITOR_ASSETS_SPEC`, `ABSOLUTE_CAPACITOR_ASSETS_VERSION`, `ABSOLUTE_MOBILE_BRANDING_FORMAT`, `AbsoluteMobileBrandingGenerationOptions`, `AbsoluteMobileBrandingInspection`, `AbsoluteMobileBrandingManifest`, `AbsoluteMobileBrandingRunner`, `AbsoluteMobileBrandingSource`, `NormalizedAbsoluteMobileConfig`, `absoluteExpoBrandingConfig`, `absoluteMobileBrandingManifestPath`, `createAbsoluteMobileBrandingManifest`, `generateAbsoluteCapacitorBranding`, `inspectAbsoluteMobileBranding`, `renderAbsoluteMobileBrandingPreview`, `writeAbsoluteExpoBrandingInputs`)
+  A typed mobile.branding contract now projects validated source PNGs into Capacitor and Expo icons, Android adaptive and themed layers, iOS appearance variants, and light/dark launch screens without application-authored native code. The mobile assets command wraps the pinned official Capacitor generator, installs it only as a direct development dependency when needed, previews artwork, records a content-addressed non-secret manifest, resumes platform-specific generation, reports bounded telemetry, and makes configured stale or missing output fail release doctor.
+
 ## 0.20.0-beta.113 — 2026-09-17
 
 ### Added

package/README.md

@@ -261,6 +261,12 @@ validation, and release projection. Add `--json` for a redacted CI or support
 artifact; it omits credentials, device/account identifiers, absolute paths, and
 detailed doctor messages. See [mobile project inspection](docs/MOBILE_INSPECT.md).
 
+Configure one typed source for native icons, Android adaptive/themed layers,
+iOS appearance variants, and launch artwork, then run `absolute mobile assets
+--preview`. AbsoluteJS projects it into either Capacitor or Expo, detects stale
+inputs, and includes the result in release doctor. See
+[mobile branding and native assets](docs/MOBILE_BRANDING.md).
+
 Before signing, run `absolute mobile doctor release`. It validates pinned and
 aligned Capacitor packages, dependency locking, HTTPS and signed-link identity,
 packaged app identity, SHA-256 page/style integrity, runtime compatibility, CSP,

package/changelog.json

@@ -2,6 +2,35 @@
 	"contract": 1,
 	"name": "@absolutejs/absolute",
 	"releases": [
+		{
+			"changes": [
+				{
+					"detail": "A typed mobile.branding contract now projects validated source PNGs into Capacitor and Expo icons, Android adaptive and themed layers, iOS appearance variants, and light/dark launch screens without application-authored native code. The mobile assets command wraps the pinned official Capacitor generator, installs it only as a direct development dependency when needed, previews artwork, records a content-addressed non-secret manifest, resumes platform-specific generation, reports bounded telemetry, and makes configured stale or missing output fail release doctor.",
+					"kind": "added",
+					"summary": "Capacitor and Expo share a first-class native branding pipeline",
+					"symbols": [
+						"ABSOLUTE_CAPACITOR_ASSETS_SPEC",
+						"ABSOLUTE_CAPACITOR_ASSETS_VERSION",
+						"ABSOLUTE_MOBILE_BRANDING_FORMAT",
+						"AbsoluteMobileBrandingGenerationOptions",
+						"AbsoluteMobileBrandingInspection",
+						"AbsoluteMobileBrandingManifest",
+						"AbsoluteMobileBrandingRunner",
+						"AbsoluteMobileBrandingSource",
+						"NormalizedAbsoluteMobileConfig",
+						"absoluteExpoBrandingConfig",
+						"absoluteMobileBrandingManifestPath",
+						"createAbsoluteMobileBrandingManifest",
+						"generateAbsoluteCapacitorBranding",
+						"inspectAbsoluteMobileBranding",
+						"renderAbsoluteMobileBrandingPreview",
+						"writeAbsoluteExpoBrandingInputs"
+					]
+				}
+			],
+			"date": "2026-09-17",
+			"version": "0.20.0-beta.114"
+		},
 		{
 			"changes": [
 				{

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-skhGcA/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-GY0KSL/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-skhGcA/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-GY0KSL/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-skhGcA/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-GY0KSL/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/build.js

@@ -27656,13 +27656,62 @@ __export(exports_config, {
 import { readFileSync as readFileSync35 } from "fs";
 import { resolve as resolve45 } from "path";
 import { createHash as createHash5, createPublicKey, X509Certificate } from "crypto";
-var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FINGERPRINT_PATTERN, UPDATE_NAME_PATTERN, RELEASE_TARGET_PATTERN, UPDATE_PUBLIC_KEY_PATTERN, ENVIRONMENT_NAME_PATTERN, DEFAULT_UPDATE_BOOT_TIMEOUT_MS = 20000, DEFAULT_UPDATE_HEALTH_FAILURE_RATE = 0.2, DEFAULT_UPDATE_HEALTH_MINIMUM_REPORTS = 20, DEFAULT_UPDATE_ROLLOUT_FAILURE_RATE = 0.05, DEFAULT_UPDATE_ROLLOUT_OBSERVATION_MINUTES = 60, MINUTE_MS, DEFAULT_UPDATE_ROLLOUT_STAGES, MINIMUM_UPDATE_BOOT_TIMEOUT_MS = 5000, MAXIMUM_UPDATE_BOOT_TIMEOUT_MS = 120000, HOSTNAME_PATTERN, EXPO_RESERVED_ROUTE_PREFIXES, resolveProjectPath = (projectRoot, value, field) => {
+var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FINGERPRINT_PATTERN, UPDATE_NAME_PATTERN, RELEASE_TARGET_PATTERN, UPDATE_PUBLIC_KEY_PATTERN, ENVIRONMENT_NAME_PATTERN, COLOR_PATTERN, DEFAULT_UPDATE_BOOT_TIMEOUT_MS = 20000, DEFAULT_UPDATE_HEALTH_FAILURE_RATE = 0.2, DEFAULT_UPDATE_HEALTH_MINIMUM_REPORTS = 20, DEFAULT_UPDATE_ROLLOUT_FAILURE_RATE = 0.05, DEFAULT_UPDATE_ROLLOUT_OBSERVATION_MINUTES = 60, MINUTE_MS, DEFAULT_UPDATE_ROLLOUT_STAGES, MINIMUM_UPDATE_BOOT_TIMEOUT_MS = 5000, MAXIMUM_UPDATE_BOOT_TIMEOUT_MS = 120000, HOSTNAME_PATTERN, EXPO_RESERVED_ROUTE_PREFIXES, resolveProjectPath = (projectRoot, value, field) => {
   const root = resolve45(projectRoot);
   const path = resolve45(root, value);
   if (path !== root && !path.startsWith(`${root}/`)) {
     throw new TypeError(`${field} must remain inside the project root.`);
   }
   return path;
+}, normalizeBrandingColor = (value, fallback, field) => {
+  const normalized = (value ?? fallback).trim().toUpperCase();
+  if (!COLOR_PATTERN.test(normalized))
+    throw new TypeError(`${field} must use #RRGGBB hexadecimal notation.`);
+  return normalized;
+}, normalizeBrandingPath = (projectRoot, value, field) => {
+  const path = resolveProjectPath(projectRoot, requireText(value, field), field);
+  if (!path.toLowerCase().endsWith(".png"))
+    throw new TypeError(`${field} must reference a PNG file.`);
+  return path;
+}, normalizeBranding = (config, projectRoot) => {
+  const { branding } = config;
+  if (!branding)
+    return;
+  const darkIcon = branding.ios?.darkIcon ? normalizeBrandingPath(projectRoot, branding.ios.darkIcon, "mobile.branding.ios.darkIcon") : undefined;
+  const tintedIcon = branding.ios?.tintedIcon ? normalizeBrandingPath(projectRoot, branding.ios.tintedIcon, "mobile.branding.ios.tintedIcon") : undefined;
+  const logoScale = branding.splash?.logoScale ?? 0.2;
+  if (!Number.isFinite(logoScale) || logoScale < 0.1 || logoScale > 0.4)
+    throw new TypeError("mobile.branding.splash.logoScale must be between 0.1 and 0.4.");
+  return {
+    android: {
+      backgroundColor: normalizeBrandingColor(branding.android?.backgroundColor, "#FFFFFF", "mobile.branding.android.backgroundColor"),
+      ...branding.android?.backgroundImage ? {
+        backgroundImage: normalizeBrandingPath(projectRoot, branding.android.backgroundImage, "mobile.branding.android.backgroundImage")
+      } : {},
+      ...branding.android?.foreground ? {
+        foreground: normalizeBrandingPath(projectRoot, branding.android.foreground, "mobile.branding.android.foreground")
+      } : {},
+      ...branding.android?.monochrome ? {
+        monochrome: normalizeBrandingPath(projectRoot, branding.android.monochrome, "mobile.branding.android.monochrome")
+      } : {}
+    },
+    icon: normalizeBrandingPath(projectRoot, branding.icon, "mobile.branding.icon"),
+    ios: {
+      ...darkIcon ? { darkIcon } : {},
+      ...tintedIcon ? { tintedIcon } : {}
+    },
+    splash: {
+      backgroundColor: normalizeBrandingColor(branding.splash?.backgroundColor, "#FFFFFF", "mobile.branding.splash.backgroundColor"),
+      darkBackgroundColor: normalizeBrandingColor(branding.splash?.darkBackgroundColor, "#111111", "mobile.branding.splash.darkBackgroundColor"),
+      ...branding.splash?.darkImage ? {
+        darkImage: normalizeBrandingPath(projectRoot, branding.splash.darkImage, "mobile.branding.splash.darkImage")
+      } : {},
+      ...branding.splash?.image ? {
+        image: normalizeBrandingPath(projectRoot, branding.splash.image, "mobile.branding.splash.image")
+      } : {},
+      logoScale
+    }
+  };
 }, requireText = (value, field) => {
   const normalized = value.trim();
   if (!normalized)
@@ -28048,11 +28097,13 @@ var APP_ID_PATTERN, SCHEME_PATTERN, APPLE_APP_ID_PREFIX_PATTERN, CERTIFICATE_FIN
   const updates = normalizeUpdates(config, productionOrigin, projectRoot);
   const updateServer = normalizeUpdateServer(config, productionOrigin, projectRoot, updates);
   const observability = normalizeObservability(config, productionOrigin);
+  const branding = normalizeBranding(config, projectRoot);
   return {
     androidCertificateFingerprints: normalizeCertificateFingerprints(config.deepLinks?.android?.sha256CertificateFingerprints),
     appId,
     appleAppIdPrefix: normalizeAppleAppIdPrefix(config.deepLinks?.apple?.appIdPrefix),
     appName: requireText(config.appName, "mobile.appName"),
+    ...branding ? { branding } : {},
     bundleDirectory: resolveProjectPath(projectRoot, config.bundleDirectory ?? ".absolutejs/mobile/web", "mobile.bundleDirectory"),
     deepLinkHosts: normalizeHosts(config.deepLinks?.hosts, productionOrigin),
     deepLinkScheme,
@@ -28080,6 +28131,7 @@ var init_config = __esm(() => {
   RELEASE_TARGET_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}$/u;
   UPDATE_PUBLIC_KEY_PATTERN = /^[A-Za-z0-9+/]+={0,2}$/u;
   ENVIRONMENT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/u;
+  COLOR_PATTERN = /^#[0-9A-F]{6}$/u;
   MINUTE_MS = 60 * 1000;
   DEFAULT_UPDATE_ROLLOUT_STAGES = [
     { minimumReports: 20, observationMinutes: 60, rollout: 0.05 },
@@ -38031,5 +38083,5 @@ export {
   devBuild
 };
 
-//# debugId=0E877E48913E5F9364756E2164756E21
+//# debugId=EF374DB4847C1F1864756E2164756E21
 //# sourceMappingURL=build.js.map