@stacksjs/actions 0.75.257 → 0.75.259

package/dist/build/android-config.js

@@ -1 +1 @@
-import{NATIVE_APP_ROUTE,normalizeMobileUrl,toCraftCrashReporting}from"./ios-config";const CAPABILITY_KEYS={speechRecognition:"enableSpeechRecognition",haptics:"enableHaptics",share:"enableShare",camera:"enableCamera",biometric:"enableBiometric",pushNotifications:"enablePushNotifications",secureStorage:"enableSecureStorage",geolocation:"enableGeolocation",backgroundLocation:"enableBackgroundLocation",keepAwake:"enableKeepAwake",deepLinks:"enableDeepLinks",healthConnect:"enableHealthConnect",bluetooth:"enableBluetooth",heartRate:"enableHeartRate",localNetwork:"enableLocalNetwork",localDatabase:"enableLocalDatabase",localNotifications:"enableLocalNotifications"};export const CRAFT_ANDROID_FLOORS={nativeShell:"0.0.169",appLinks:"0.0.201",bluetooth:"0.0.178",heartRate:"0.0.247",healthConnect:"0.0.169",backgroundRefresh:"0.0.169",appBundle:"0.0.169",crashReporting:"0.0.179",notificationIcon:"0.0.241"};export function assertCraftSupportsAndroidMapProvider(config,providers){if(config.mapProvider&&!providers?.includes(config.mapProvider))throw Error(`The resolved Craft Android builder does not advertise native map provider '${config.mapProvider}'. Upgrade craft-native to a published SDK supporting that provider before building this app.`)}export function androidCraftFeatures(config,options={}){const features=[];if(config.renderer==="native"&&Object.keys(config.nativeScreens??{}).length)features.push("nativeShell");if(config.appLinks?.length&&config.capabilities?.deepLinks)features.push("appLinks");if(config.capabilities?.bluetooth)features.push("bluetooth");if(config.capabilities?.heartRate)features.push("heartRate");if(config.capabilities?.healthConnect&&config.renderer==="native")features.push("healthConnect");if(config.backgroundRefresh?.enabled)features.push("backgroundRefresh");if(options.appBundle)features.push("appBundle");if(config.crashReporting?.key)features.push("crashReporting");if(config.notificationIcon||config.notificationColor)features.push("notificationIcon");return features}export function assertCraftSupportsAndroid(config,version,source,options={}){const missing=androidCraftFeatures(config,options).filter((feature)=>!Bun.semver.satisfies(version,`>=${CRAFT_ANDROID_FLOORS[feature]}`));if(!missing.length)return;const needed=missing.map((feature)=>CRAFT_ANDROID_FLOORS[feature]).reduce((max,next)=>Bun.semver.order(next,max)>0?next:max,"0.0.0");throw Error(`The Craft Android builder is craft-native ${version} (${source}), which would build the app without ${missing.map((feature)=>`${feature} (needs >= ${CRAFT_ANDROID_FLOORS[feature]})`).join(", ")}. Install craft-native >= ${needed}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export function toCraftAndroidConfig(config){const devServerURL=normalizeMobileUrl(config.url),trustedOrigins=new Set(config.trustedOrigins??[]);if(devServerURL)trustedOrigins.add(new URL(devServerURL).origin);const native=config.renderer==="native",craft={mapProvider:config.mapProvider,nativeFonts:config.nativeFonts,appName:config.appName,packageName:config.packageName,version:config.version,versionCode:config.versionCode,minSdk:config.minSdk,targetSdk:config.targetSdk,darkMode:config.darkMode,appearance:config.appearance,backgroundColor:config.backgroundColor,backgroundColorDark:config.backgroundColorDark,devServerURL,trustedOrigins:[...trustedOrigins],urlSchemes:config.urlSchemes,appLinks:config.appLinks,appIconPath:config.appIcon,notificationColor:config.notificationColor,googleServicesFile:config.googleServicesFile,mapsApiKey:config.mapsApiKey,renderer:config.renderer,nativeScreens:native?config.nativeScreens:void 0,nativeApp:native&&config.nativeApp?NATIVE_APP_ROUTE:void 0,tabs:native?config.tabs:void 0,backgroundRefresh:native?config.backgroundRefresh:void 0,healthConnect:config.capabilities?.healthConnect?config.healthConnect:void 0,privacyPolicyURL:config.privacyPolicyUrl,crashReporting:toCraftCrashReporting(config.crashReporting)};for(const[key,nativeKey]of Object.entries(CAPABILITY_KEYS)){const enabled=config.capabilities?.[key];if(enabled!==void 0)craft[nativeKey]=enabled}if(config.capabilities?.backgroundLocation)craft.enableGeolocation=!0;for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function validateAndroidMobileConfig(config){if(config.mapProvider!==void 0&&config.mapProvider!=="google"&&config.mapProvider!=="maplibre")throw Error(`android.mapProvider must be 'google' or 'maplibre', not ${String(config.mapProvider)}`);if(config.mapProvider&&config.renderer!=="native")throw Error("android.mapProvider configures native map views: set android.renderer to 'native'");if(!config.appName?.trim())throw Error("config/mobile.ts must define android.appName");if(!/^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z][A-Za-z0-9_]*)+$/.test(config.packageName))throw Error(`Invalid Android package name: ${config.packageName}`);if(config.notificationColor!==void 0&&!/^#[0-9a-f]{6}$/i.test(config.notificationColor))throw Error(`android.notificationColor must be #RRGGBB, not ${String(config.notificationColor)}`);if(config.notificationIcon!==void 0&&!/\.(png|xml)$/i.test(config.notificationIcon))throw Error("android.notificationIcon must be an Android vector drawable (.xml) or a white-on-transparent .png");if(config.mapsApiKey!==void 0&&(typeof config.mapsApiKey!=="string"||!config.mapsApiKey.trim()))throw Error("android.mapsApiKey must be a non-empty Google Maps Android SDK key");if(config.renderer!==void 0&&config.renderer!=="web"&&config.renderer!=="native")throw Error(`android.renderer must be 'web' or 'native', not ${String(config.renderer)}`);if(config.renderer==="native"){if(!Object.keys(config.nativeScreens??{}).length)throw Error("android.renderer 'native' draws every screen natively: list them in android.nativeScreens");if(config.webAssets)throw Error("android.renderer 'native' has no web view to show android.webAssets in: set android.url to the app's site instead");if(config.fallbackWebAssets)throw Error("android.fallbackWebAssets is the web view's offline page; android.renderer 'native' has no web view");if(!config.url)throw Error("android.renderer 'native' needs android.url: the app's site, where its API answers")}else{if(config.url&&config.webAssets)throw Error("Choose either android.url or android.webAssets in config/mobile.ts, not both");if(!config.url&&!config.webAssets)throw Error("config/mobile.ts must define android.url or android.webAssets");if(config.fallbackWebAssets&&!config.url)throw Error("android.fallbackWebAssets requires android.url")}if(config.nativeApp&&config.renderer!=="native")throw Error("android.nativeApp runs beside native screens: set android.renderer to 'native'");for(const tab of config.tabs??[])if(!tab.id?.startsWith("/"))throw Error(`An android.tabs entry needs an id that is an app path, like /m (got ${String(tab.id)})`);if(config.url){const normalized=normalizeMobileUrl(config.url),url=new URL(normalized),isLocal=["localhost","127.0.0.1","10.0.2.2"].includes(url.hostname);if(url.protocol!=="https:"&&!isLocal)throw Error("android.url must use HTTPS outside local development")}if(config.capabilities?.healthConnect&&(config.minSdk??26)<26)throw Error("Android Health Connect requires android.minSdk 26 or newer");if(config.healthConnect&&!config.capabilities?.healthConnect)throw Error("android.healthConnect lists Health Connect data, but android.capabilities.healthConnect is off");const minutes=config.backgroundRefresh?.minimumIntervalMinutes;if(minutes!==void 0&&(!Number.isFinite(minutes)||minutes<15))throw Error("android.backgroundRefresh.minimumIntervalMinutes is at least 15 (WorkManager's shortest period)");for(const scheme of config.urlSchemes??[])if(!/^[a-z][a-z0-9+.-]*$/i.test(scheme))throw Error(`Invalid Android URL scheme: ${scheme}`)}export function androidRelease(config){if(config.crashReporting?.release)return config.crashReporting.release;return`${config.version||"1.0.0"}+${config.versionCode||1}`}export async function uploadAndroidMapping(mappingPath,host,release,token,send=fetch){if(!token)return{ok:!1,message:"BUGHQ_UPLOAD_TOKEN is not set, so the R8 mapping was not uploaded and this build's Android crashes will show obfuscated names."};const file=Bun.file(mappingPath);if(!await file.exists())return{ok:!1,message:`No R8 mapping at ${mappingPath}, so nothing was uploaded.`};try{const body=Bun.gzipSync(new Uint8Array(await file.arrayBuffer())),response=await send(`${host.replace(/\/$/,"")}/api/debug-files?kind=proguard&release=${encodeURIComponent(release)}`,{method:"POST",headers:{Authorization:`Bearer ${token}`,"Content-Type":"application/octet-stream"},body});if(!response.ok)return{ok:!1,message:`bughq refused the R8 mapping (${response.status}): ${(await response.text()).slice(0,200)}`};return{ok:!0,message:`Uploaded the R8 mapping for ${release} to bughq.`}}catch(error){return{ok:!1,message:`Could not upload the R8 mapping: ${error instanceof Error?error.message:String(error)}`}}}
+import{NATIVE_APP_ROUTE,normalizeMobileUrl,toCraftCrashReporting}from"./ios-config";import{nativeScreenRoutes}from"./native-screens";const CAPABILITY_KEYS={speechRecognition:"enableSpeechRecognition",haptics:"enableHaptics",share:"enableShare",camera:"enableCamera",biometric:"enableBiometric",pushNotifications:"enablePushNotifications",secureStorage:"enableSecureStorage",geolocation:"enableGeolocation",backgroundLocation:"enableBackgroundLocation",keepAwake:"enableKeepAwake",deepLinks:"enableDeepLinks",healthConnect:"enableHealthConnect",bluetooth:"enableBluetooth",heartRate:"enableHeartRate",localNetwork:"enableLocalNetwork",localDatabase:"enableLocalDatabase",localNotifications:"enableLocalNotifications"};export const CRAFT_ANDROID_FLOORS={nativeShell:"0.0.169",appLinks:"0.0.201",bluetooth:"0.0.178",heartRate:"0.0.247",healthConnect:"0.0.169",backgroundRefresh:"0.0.169",appBundle:"0.0.169",crashReporting:"0.0.179",notificationIcon:"0.0.241"};export function assertCraftSupportsAndroidMapProvider(config,providers){if(config.mapProvider&&!providers?.includes(config.mapProvider))throw Error(`The resolved Craft Android builder does not advertise native map provider '${config.mapProvider}'. Upgrade craft-native to a published SDK supporting that provider before building this app.`)}export function androidCraftFeatures(config,options={}){const features=[];if(config.renderer==="native"&&Object.keys(config.nativeScreens??{}).length)features.push("nativeShell");if(config.appLinks?.length&&config.capabilities?.deepLinks)features.push("appLinks");if(config.capabilities?.bluetooth)features.push("bluetooth");if(config.capabilities?.heartRate)features.push("heartRate");if(config.capabilities?.healthConnect&&config.renderer==="native")features.push("healthConnect");if(config.backgroundRefresh?.enabled)features.push("backgroundRefresh");if(options.appBundle)features.push("appBundle");if(config.crashReporting?.key)features.push("crashReporting");if(config.notificationIcon||config.notificationColor)features.push("notificationIcon");return features}export function assertCraftSupportsAndroid(config,version,source,options={}){const missing=androidCraftFeatures(config,options).filter((feature)=>!Bun.semver.satisfies(version,`>=${CRAFT_ANDROID_FLOORS[feature]}`));if(!missing.length)return;const needed=missing.map((feature)=>CRAFT_ANDROID_FLOORS[feature]).reduce((max,next)=>Bun.semver.order(next,max)>0?next:max,"0.0.0");throw Error(`The Craft Android builder is craft-native ${version} (${source}), which would build the app without ${missing.map((feature)=>`${feature} (needs >= ${CRAFT_ANDROID_FLOORS[feature]})`).join(", ")}. Install craft-native >= ${needed}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export function toCraftAndroidConfig(config){const devServerURL=normalizeMobileUrl(config.url),trustedOrigins=new Set(config.trustedOrigins??[]);if(devServerURL)trustedOrigins.add(new URL(devServerURL).origin);const native=config.renderer==="native",craft={mapProvider:config.mapProvider,nativeFonts:config.nativeFonts,appName:config.appName,packageName:config.packageName,version:config.version,versionCode:config.versionCode,minSdk:config.minSdk,targetSdk:config.targetSdk,darkMode:config.darkMode,appearance:config.appearance,backgroundColor:config.backgroundColor,backgroundColorDark:config.backgroundColorDark,devServerURL,trustedOrigins:[...trustedOrigins],urlSchemes:config.urlSchemes,appLinks:config.appLinks,appIconPath:config.appIcon,notificationColor:config.notificationColor,googleServicesFile:config.googleServicesFile,mapsApiKey:config.mapsApiKey,renderer:config.renderer,nativeScreens:native?nativeScreenRoutes(config):void 0,nativeApp:native&&config.nativeApp?NATIVE_APP_ROUTE:void 0,tabs:native?config.tabs:void 0,backgroundRefresh:native?config.backgroundRefresh:void 0,healthConnect:config.capabilities?.healthConnect?config.healthConnect:void 0,privacyPolicyURL:config.privacyPolicyUrl,crashReporting:toCraftCrashReporting(config.crashReporting)};for(const[key,nativeKey]of Object.entries(CAPABILITY_KEYS)){const enabled=config.capabilities?.[key];if(enabled!==void 0)craft[nativeKey]=enabled}if(config.capabilities?.backgroundLocation)craft.enableGeolocation=!0;for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function validateAndroidMobileConfig(config){if(config.mapProvider!==void 0&&config.mapProvider!=="google"&&config.mapProvider!=="maplibre")throw Error(`android.mapProvider must be 'google' or 'maplibre', not ${String(config.mapProvider)}`);if(config.mapProvider&&config.renderer!=="native")throw Error("android.mapProvider configures native map views: set android.renderer to 'native'");if(!config.appName?.trim())throw Error("config/mobile.ts must define android.appName");if(!/^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z][A-Za-z0-9_]*)+$/.test(config.packageName))throw Error(`Invalid Android package name: ${config.packageName}`);if(config.notificationColor!==void 0&&!/^#[0-9a-f]{6}$/i.test(config.notificationColor))throw Error(`android.notificationColor must be #RRGGBB, not ${String(config.notificationColor)}`);if(config.notificationIcon!==void 0&&!/\.(png|xml)$/i.test(config.notificationIcon))throw Error("android.notificationIcon must be an Android vector drawable (.xml) or a white-on-transparent .png");if(config.mapsApiKey!==void 0&&(typeof config.mapsApiKey!=="string"||!config.mapsApiKey.trim()))throw Error("android.mapsApiKey must be a non-empty Google Maps Android SDK key");if(config.renderer!==void 0&&config.renderer!=="web"&&config.renderer!=="native")throw Error(`android.renderer must be 'web' or 'native', not ${String(config.renderer)}`);if(config.renderer==="native"){if(!Object.keys(config.nativeScreens??{}).length)throw Error("android.renderer 'native' draws every screen natively: list them in android.nativeScreens");if(config.webAssets)throw Error("android.renderer 'native' has no web view to show android.webAssets in: set android.url to the app's site instead");if(config.fallbackWebAssets)throw Error("android.fallbackWebAssets is the web view's offline page; android.renderer 'native' has no web view");if(!config.url)throw Error("android.renderer 'native' needs android.url: the app's site, where its API answers")}else{if(config.url&&config.webAssets)throw Error("Choose either android.url or android.webAssets in config/mobile.ts, not both");if(!config.url&&!config.webAssets)throw Error("config/mobile.ts must define android.url or android.webAssets");if(config.fallbackWebAssets&&!config.url)throw Error("android.fallbackWebAssets requires android.url")}if(config.nativeApp&&config.renderer!=="native")throw Error("android.nativeApp runs beside native screens: set android.renderer to 'native'");for(const tab of config.tabs??[])if(!tab.id?.startsWith("/"))throw Error(`An android.tabs entry needs an id that is an app path, like /m (got ${String(tab.id)})`);if(config.url){const normalized=normalizeMobileUrl(config.url),url=new URL(normalized),isLocal=["localhost","127.0.0.1","10.0.2.2"].includes(url.hostname);if(url.protocol!=="https:"&&!isLocal)throw Error("android.url must use HTTPS outside local development")}if(config.capabilities?.healthConnect&&(config.minSdk??26)<26)throw Error("Android Health Connect requires android.minSdk 26 or newer");if(config.healthConnect&&!config.capabilities?.healthConnect)throw Error("android.healthConnect lists Health Connect data, but android.capabilities.healthConnect is off");const minutes=config.backgroundRefresh?.minimumIntervalMinutes;if(minutes!==void 0&&(!Number.isFinite(minutes)||minutes<15))throw Error("android.backgroundRefresh.minimumIntervalMinutes is at least 15 (WorkManager's shortest period)");for(const scheme of config.urlSchemes??[])if(!/^[a-z][a-z0-9+.-]*$/i.test(scheme))throw Error(`Invalid Android URL scheme: ${scheme}`)}export function androidRelease(config){if(config.crashReporting?.release)return config.crashReporting.release;return`${config.version||"1.0.0"}+${config.versionCode||1}`}export async function uploadAndroidMapping(mappingPath,host,release,token,send=fetch){if(!token)return{ok:!1,message:"BUGHQ_UPLOAD_TOKEN is not set, so the R8 mapping was not uploaded and this build's Android crashes will show obfuscated names."};const file=Bun.file(mappingPath);if(!await file.exists())return{ok:!1,message:`No R8 mapping at ${mappingPath}, so nothing was uploaded.`};try{const body=Bun.gzipSync(new Uint8Array(await file.arrayBuffer())),response=await send(`${host.replace(/\/$/,"")}/api/debug-files?kind=proguard&release=${encodeURIComponent(release)}`,{method:"POST",headers:{Authorization:`Bearer ${token}`,"Content-Type":"application/octet-stream"},body});if(!response.ok)return{ok:!1,message:`bughq refused the R8 mapping (${response.status}): ${(await response.text()).slice(0,200)}`};return{ok:!0,message:`Uploaded the R8 mapping for ${release} to bughq.`}}catch(error){return{ok:!1,message:`Could not upload the R8 mapping: ${error instanceof Error?error.message:String(error)}`}}}

package/dist/build/ios-config.js

@@ -1,4 +1,4 @@
-import{existsSync,readFileSync,writeFileSync}from"node:fs";import{isAbsolute,join,relative,resolve}from"node:path";import{spotlightActivityTypes}from"@stacksjs/mobile";export const NATIVE_APP_ROUTE="__app";const CAPABILITY_KEYS={speechRecognition:"enableSpeechRecognition",haptics:"enableHaptics",share:"enableShare",camera:"enableCamera",biometric:"enableBiometric",pushNotifications:"enablePushNotifications",secureStorage:"enableSecureStorage",geolocation:"enableGeolocation",backgroundLocation:"enableBackgroundLocation",clipboard:"enableClipboard",contacts:"enableContacts",calendar:"enableCalendar",localNotifications:"enableLocalNotifications",inAppPurchase:"enableInAppPurchase",keepAwake:"enableKeepAwake",orientationLock:"enableOrientationLock",deepLinks:"enableDeepLinks",qrScanner:"enableQRScanner",localNetwork:"enableLocalNetwork",filePicker:"enableFilePicker",fileDownload:"enableFileDownload",socialAuth:"enableSocialAuth",audioRecording:"enableAudioRecording",videoRecording:"enableVideoRecording",motionSensors:"enableMotionSensors",localDatabase:"enableLocalDatabase",bluetooth:"enableBluetooth",nfc:"enableNFC",healthKit:"enableHealthKit",appleMusic:"enableAppleMusic",heartRate:"enableHeartRate",backgroundAudio:"enableBackgroundAudio",scheduledWorkouts:"enableScheduledWorkouts",liveActivities:"enableLiveActivities",watchApp:"enableWatchApp",backgroundTasks:"enableBackgroundTasks",screenCapture:"enableScreenCapture",pdfViewer:"enablePDFViewer",augmentedReality:"enableAR",machineLearning:"enableMLKit"};export const CRAFT_CAPABILITY_FLOORS={appleMusic:"0.0.144",heartRate:"0.0.152",backgroundAudio:"0.0.162",scheduledWorkouts:"0.0.163"};export function unsupportedCraftCapabilities(capabilities,version){const missing=[];for(const[capability,needs]of Object.entries(CRAFT_CAPABILITY_FLOORS))if(capabilities?.[capability]&&!Bun.semver.satisfies(version,`>=${needs}`))missing.push({capability,needs});return missing}export function assertCraftSupportsCapabilities(capabilities,version,source){const missing=unsupportedCraftCapabilities(capabilities,version);if(missing.length===0)return;const needed=missing.reduce((max,{needs})=>Bun.semver.order(needs,max)>0?needs:max,"0.0.0");throw Error(`The Craft iOS builder is craft-native ${version} (${source}), which would build the app without ${missing.map(({capability,needs})=>`ios.capabilities.${capability} (needs >= ${needs})`).join(", ")}. Install craft-native >= ${needed}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export const CRAFT_CRASH_REPORTING_FLOOR="0.0.179";export function resolveCrashReporting(shared,platform){const set=(config)=>Object.fromEntries(Object.entries(config??{}).filter(([,value])=>value!==void 0&&value!=="")),merged={...set(shared),...set(platform)};if(!merged.key?.trim())return;if(merged.host){const url=new URL(normalizeMobileUrl(merged.host)),local=["localhost","127.0.0.1","::1","10.0.2.2"].includes(url.hostname);if(url.protocol!=="https:"&&!local)throw Error("crashReporting.host must use HTTPS outside local development");merged.host=url.origin}return merged}export function toCraftCrashReporting(config){if(!config?.key)return;const craft={key:config.key,host:config.host,environment:config.environment,release:config.release,sessions:config.sessions};for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function assertCraftSupportsCrashReporting(config,version,source){if(!config?.key||Bun.semver.satisfies(version,`>=${CRAFT_CRASH_REPORTING_FLOOR}`))return;throw Error(`The Craft builder is craft-native ${version} (${source}), which would build the app without crash reporting (crashReporting needs >= ${CRAFT_CRASH_REPORTING_FLOOR}). Install craft-native >= ${CRAFT_CRASH_REPORTING_FLOOR}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export function normalizeMobileUrl(value){const input=value?.trim();if(!input)return;return new URL(/^https?:\/\//i.test(input)?input:`https://${input}`).toString().replace(/\/$/,"")}export function portablePaths(value,projectDir,appRoot){if(typeof value==="string")return isAbsolute(value)&&!relative(appRoot,value).startsWith("..")?relative(projectDir,value)||".":value;if(Array.isArray(value))return value.map((item)=>portablePaths(item,projectDir,appRoot));if(value&&typeof value==="object"){const out={};for(const[key,item]of Object.entries(value))out[key]=typeof item==="string"&&!/(?:path(?:dark)?|bundle)$|^(?:src|license)$/i.test(key)?item:portablePaths(item,projectDir,appRoot);return out}return value}export function resolveMobilePath(root,value){if(!value)return;return isAbsolute(value)?value:resolve(root,value)}export function resolveSwipeNavigation(config){if(config.swipeNavigation!==void 0)return config.swipeNavigation;return config.swipeBack==="webview"}export function toCraftIosConfig(config){const devServerURL=normalizeMobileUrl(config.url),trustedOrigins=new Set(config.trustedOrigins??[]);if(devServerURL)trustedOrigins.add(new URL(devServerURL).origin);const declaresAppBoundDomains=(config.appBoundDomains?.length??0)>0,craft={nativeFonts:config.nativeFonts,appName:config.appName,bundleId:config.bundleId,version:config.version,buildNumber:config.buildNumber,darkMode:config.darkMode,appearance:config.appearance,backgroundColor:config.backgroundColor,backgroundColorDark:config.backgroundColorDark,swipeNavigation:resolveSwipeNavigation(config),allowsLinkPreview:config.allowsLinkPreview,keyboardAccessory:config.keyboardAccessory,disableZoom:config.disableZoom,splashMaxSeconds:config.splashMaxSeconds,requestTimeoutSeconds:config.requestTimeoutSeconds,backgroundRefresh:config.backgroundRefresh,iosVersion:config.deploymentTarget,watchosVersion:config.watchDeploymentTarget,teamId:config.teamId,devServerURL,urlSchemes:config.urlSchemes,appShortcuts:config.appShortcuts,trustedOrigins:[...trustedOrigins],appBoundDomains:config.appBoundDomains,limitNavigationsToAppBoundDomains:config.limitNavigationsToAppBoundDomains??(declaresAppBoundDomains||void 0),associatedDomains:config.associatedDomains,renderer:config.renderer,nativeScreens:config.nativeScreens,nativeApp:config.nativeApp?NATIVE_APP_ROUTE:void 0,nativeScriptThread:config.nativeScriptThread,tabs:config.tabs,shareStorage:config.shareStorage,appGroups:config.appGroups,appIconPath:config.appIcon,privacy:config.privacy,usageDescriptions:config.usageDescriptions,orientations:config.orientations,deviceFamilies:config.deviceFamilies,crashReporting:toCraftCrashReporting(config.crashReporting)};for(const[key,nativeKey]of Object.entries(CAPABILITY_KEYS)){const enabled=config.capabilities?.[key];if(enabled!==void 0)craft[nativeKey]=enabled}if(config.capabilities?.backgroundLocation)craft.enableGeolocation=!0;for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function validateIosMobileConfig(config){if(!config.appName?.trim())throw Error("config/mobile.ts must define ios.appName");if(!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(config.bundleId))throw Error(`Invalid iOS bundle identifier: ${config.bundleId}`);if(config.url&&config.webAssets)throw Error("Choose either ios.url or ios.webAssets in config/mobile.ts, not both");if(!config.url&&!config.webAssets)throw Error("config/mobile.ts must define ios.url or ios.webAssets");if(config.renderer!==void 0&&config.renderer!=="web"&&config.renderer!=="native")throw Error(`ios.renderer must be 'web' or 'native', not ${String(config.renderer)}`);if(config.renderer==="native"){if(!Object.keys(config.nativeScreens??{}).length)throw Error("ios.renderer 'native' draws every screen natively: list them in ios.nativeScreens");if(config.webAssets)throw Error("ios.renderer 'native' has no web view to show ios.webAssets in: set ios.url to the app's site instead");if(config.fallbackWebAssets)throw Error("ios.fallbackWebAssets is the web view's offline page; ios.renderer 'native' has no web view")}if(config.fallbackWebAssets&&!config.url)throw Error("ios.fallbackWebAssets requires ios.url");if(config.deviceFamilies&&(config.deviceFamilies.length===0||config.deviceFamilies.some((family)=>family!=="iphone"&&family!=="ipad")))throw Error("ios.deviceFamilies must contain iphone and/or ipad");if(config.url){const url=new URL(normalizeMobileUrl(config.url)),isLocal=["localhost","127.0.0.1","::1"].includes(url.hostname);if(url.protocol!=="https:"&&!isLocal)throw Error("ios.url must use HTTPS outside local development")}for(const domain of config.associatedDomains??[])if(!/^(applinks|webcredentials|activitycontinuation):[^/\s]+$/.test(domain))throw Error(`Invalid iOS associated domain: ${domain}`);for(const key of["splashMaxSeconds","requestTimeoutSeconds"]){const value=config[key];if(value!==void 0&&(!Number.isFinite(value)||value<=0))throw Error(`ios.${key} must be a positive number of seconds`)}const refresh=config.backgroundRefresh;if(refresh){if(refresh.identifier!==void 0&&!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(refresh.identifier))throw Error(`Invalid iOS background refresh identifier: ${refresh.identifier}`);if(refresh.minimumIntervalMinutes!==void 0&&(!Number.isFinite(refresh.minimumIntervalMinutes)||refresh.minimumIntervalMinutes<=0))throw Error("ios.backgroundRefresh.minimumIntervalMinutes must be a positive number of minutes")}if(config.capabilities?.watchApp){const target=Number.parseFloat(config.watchDeploymentTarget??"9.0");if(!Number.isFinite(target)||target<9)throw Error("ios.watchDeploymentTarget must be watchOS 9.0 or newer")}}const ACTIVITY_TYPES_BLOCK=/[ \t]*<key>NSUserActivityTypes<\/key>\s*<array>[\s\S]*?<\/array>\n?/;export function withActivityTypes(plist,types){const entries=types.map((type)=>`        <string>${escapeXml(type)}</string>`).join(`
+import{existsSync,readFileSync,writeFileSync}from"node:fs";import{isAbsolute,join,relative,resolve}from"node:path";import{spotlightActivityTypes}from"@stacksjs/mobile";import{nativeScreenRoutes}from"./native-screens";export const NATIVE_APP_ROUTE="__app";const CAPABILITY_KEYS={speechRecognition:"enableSpeechRecognition",haptics:"enableHaptics",share:"enableShare",camera:"enableCamera",biometric:"enableBiometric",pushNotifications:"enablePushNotifications",secureStorage:"enableSecureStorage",geolocation:"enableGeolocation",backgroundLocation:"enableBackgroundLocation",clipboard:"enableClipboard",contacts:"enableContacts",calendar:"enableCalendar",localNotifications:"enableLocalNotifications",inAppPurchase:"enableInAppPurchase",keepAwake:"enableKeepAwake",orientationLock:"enableOrientationLock",deepLinks:"enableDeepLinks",qrScanner:"enableQRScanner",localNetwork:"enableLocalNetwork",filePicker:"enableFilePicker",fileDownload:"enableFileDownload",socialAuth:"enableSocialAuth",audioRecording:"enableAudioRecording",videoRecording:"enableVideoRecording",motionSensors:"enableMotionSensors",localDatabase:"enableLocalDatabase",bluetooth:"enableBluetooth",nfc:"enableNFC",healthKit:"enableHealthKit",appleMusic:"enableAppleMusic",heartRate:"enableHeartRate",backgroundAudio:"enableBackgroundAudio",scheduledWorkouts:"enableScheduledWorkouts",liveActivities:"enableLiveActivities",watchApp:"enableWatchApp",backgroundTasks:"enableBackgroundTasks",screenCapture:"enableScreenCapture",pdfViewer:"enablePDFViewer",augmentedReality:"enableAR",machineLearning:"enableMLKit"};export const CRAFT_CAPABILITY_FLOORS={appleMusic:"0.0.144",heartRate:"0.0.152",backgroundAudio:"0.0.162",scheduledWorkouts:"0.0.163"};export function unsupportedCraftCapabilities(capabilities,version){const missing=[];for(const[capability,needs]of Object.entries(CRAFT_CAPABILITY_FLOORS))if(capabilities?.[capability]&&!Bun.semver.satisfies(version,`>=${needs}`))missing.push({capability,needs});return missing}export function assertCraftSupportsCapabilities(capabilities,version,source){const missing=unsupportedCraftCapabilities(capabilities,version);if(missing.length===0)return;const needed=missing.reduce((max,{needs})=>Bun.semver.order(needs,max)>0?needs:max,"0.0.0");throw Error(`The Craft iOS builder is craft-native ${version} (${source}), which would build the app without ${missing.map(({capability,needs})=>`ios.capabilities.${capability} (needs >= ${needs})`).join(", ")}. Install craft-native >= ${needed}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export const CRAFT_CRASH_REPORTING_FLOOR="0.0.179";export function resolveCrashReporting(shared,platform){const set=(config)=>Object.fromEntries(Object.entries(config??{}).filter(([,value])=>value!==void 0&&value!=="")),merged={...set(shared),...set(platform)};if(!merged.key?.trim())return;if(merged.host){const url=new URL(normalizeMobileUrl(merged.host)),local=["localhost","127.0.0.1","::1","10.0.2.2"].includes(url.hostname);if(url.protocol!=="https:"&&!local)throw Error("crashReporting.host must use HTTPS outside local development");merged.host=url.origin}return merged}export function toCraftCrashReporting(config){if(!config?.key)return;const craft={key:config.key,host:config.host,environment:config.environment,release:config.release,sessions:config.sessions};for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function assertCraftSupportsCrashReporting(config,version,source){if(!config?.key||Bun.semver.satisfies(version,`>=${CRAFT_CRASH_REPORTING_FLOOR}`))return;throw Error(`The Craft builder is craft-native ${version} (${source}), which would build the app without crash reporting (crashReporting needs >= ${CRAFT_CRASH_REPORTING_FLOOR}). Install craft-native >= ${CRAFT_CRASH_REPORTING_FLOOR}: look for an older copy nested under @stacksjs/mobile in bun.lock, or raise the app's own craft-native pin.`)}export function normalizeMobileUrl(value){const input=value?.trim();if(!input)return;return new URL(/^https?:\/\//i.test(input)?input:`https://${input}`).toString().replace(/\/$/,"")}export function portablePaths(value,projectDir,appRoot){if(typeof value==="string")return isAbsolute(value)&&!relative(appRoot,value).startsWith("..")?relative(projectDir,value)||".":value;if(Array.isArray(value))return value.map((item)=>portablePaths(item,projectDir,appRoot));if(value&&typeof value==="object"){const out={};for(const[key,item]of Object.entries(value))out[key]=typeof item==="string"&&!/(?:path(?:dark)?|bundle)$|^(?:src|license)$/i.test(key)?item:portablePaths(item,projectDir,appRoot);return out}return value}export function resolveMobilePath(root,value){if(!value)return;return isAbsolute(value)?value:resolve(root,value)}export function resolveSwipeNavigation(config){if(config.swipeNavigation!==void 0)return config.swipeNavigation;return config.swipeBack==="webview"}export function toCraftIosConfig(config){const devServerURL=normalizeMobileUrl(config.url),trustedOrigins=new Set(config.trustedOrigins??[]);if(devServerURL)trustedOrigins.add(new URL(devServerURL).origin);const declaresAppBoundDomains=(config.appBoundDomains?.length??0)>0,craft={nativeFonts:config.nativeFonts,appName:config.appName,bundleId:config.bundleId,version:config.version,buildNumber:config.buildNumber,darkMode:config.darkMode,appearance:config.appearance,backgroundColor:config.backgroundColor,backgroundColorDark:config.backgroundColorDark,swipeNavigation:resolveSwipeNavigation(config),allowsLinkPreview:config.allowsLinkPreview,keyboardAccessory:config.keyboardAccessory,disableZoom:config.disableZoom,splashMaxSeconds:config.splashMaxSeconds,requestTimeoutSeconds:config.requestTimeoutSeconds,backgroundRefresh:config.backgroundRefresh,iosVersion:config.deploymentTarget,watchosVersion:config.watchDeploymentTarget,teamId:config.teamId,devServerURL,urlSchemes:config.urlSchemes,appShortcuts:config.appShortcuts,trustedOrigins:[...trustedOrigins],appBoundDomains:config.appBoundDomains,limitNavigationsToAppBoundDomains:config.limitNavigationsToAppBoundDomains??(declaresAppBoundDomains||void 0),associatedDomains:config.associatedDomains,renderer:config.renderer,nativeScreens:nativeScreenRoutes(config),nativeApp:config.nativeApp?NATIVE_APP_ROUTE:void 0,nativeScriptThread:config.nativeScriptThread,tabs:config.tabs,shareStorage:config.shareStorage,appGroups:config.appGroups,appIconPath:config.appIcon,privacy:config.privacy,usageDescriptions:config.usageDescriptions,orientations:config.orientations,deviceFamilies:config.deviceFamilies,crashReporting:toCraftCrashReporting(config.crashReporting)};for(const[key,nativeKey]of Object.entries(CAPABILITY_KEYS)){const enabled=config.capabilities?.[key];if(enabled!==void 0)craft[nativeKey]=enabled}if(config.capabilities?.backgroundLocation)craft.enableGeolocation=!0;for(const key of Object.keys(craft))if(craft[key]===void 0)delete craft[key];return craft}export function validateIosMobileConfig(config){if(!config.appName?.trim())throw Error("config/mobile.ts must define ios.appName");if(!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(config.bundleId))throw Error(`Invalid iOS bundle identifier: ${config.bundleId}`);if(config.url&&config.webAssets)throw Error("Choose either ios.url or ios.webAssets in config/mobile.ts, not both");if(!config.url&&!config.webAssets)throw Error("config/mobile.ts must define ios.url or ios.webAssets");if(config.renderer!==void 0&&config.renderer!=="web"&&config.renderer!=="native")throw Error(`ios.renderer must be 'web' or 'native', not ${String(config.renderer)}`);if(config.renderer==="native"){if(!Object.keys(config.nativeScreens??{}).length)throw Error("ios.renderer 'native' draws every screen natively: list them in ios.nativeScreens");if(config.webAssets)throw Error("ios.renderer 'native' has no web view to show ios.webAssets in: set ios.url to the app's site instead");if(config.fallbackWebAssets)throw Error("ios.fallbackWebAssets is the web view's offline page; ios.renderer 'native' has no web view")}if(config.fallbackWebAssets&&!config.url)throw Error("ios.fallbackWebAssets requires ios.url");if(config.deviceFamilies&&(config.deviceFamilies.length===0||config.deviceFamilies.some((family)=>family!=="iphone"&&family!=="ipad")))throw Error("ios.deviceFamilies must contain iphone and/or ipad");if(config.url){const url=new URL(normalizeMobileUrl(config.url)),isLocal=["localhost","127.0.0.1","::1"].includes(url.hostname);if(url.protocol!=="https:"&&!isLocal)throw Error("ios.url must use HTTPS outside local development")}for(const domain of config.associatedDomains??[])if(!/^(applinks|webcredentials|activitycontinuation):[^/\s]+$/.test(domain))throw Error(`Invalid iOS associated domain: ${domain}`);for(const key of["splashMaxSeconds","requestTimeoutSeconds"]){const value=config[key];if(value!==void 0&&(!Number.isFinite(value)||value<=0))throw Error(`ios.${key} must be a positive number of seconds`)}const refresh=config.backgroundRefresh;if(refresh){if(refresh.identifier!==void 0&&!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(refresh.identifier))throw Error(`Invalid iOS background refresh identifier: ${refresh.identifier}`);if(refresh.minimumIntervalMinutes!==void 0&&(!Number.isFinite(refresh.minimumIntervalMinutes)||refresh.minimumIntervalMinutes<=0))throw Error("ios.backgroundRefresh.minimumIntervalMinutes must be a positive number of minutes")}if(config.capabilities?.watchApp){const target=Number.parseFloat(config.watchDeploymentTarget??"9.0");if(!Number.isFinite(target)||target<9)throw Error("ios.watchDeploymentTarget must be watchOS 9.0 or newer")}}const ACTIVITY_TYPES_BLOCK=/[ \t]*<key>NSUserActivityTypes<\/key>\s*<array>[\s\S]*?<\/array>\n?/;export function withActivityTypes(plist,types){const entries=types.map((type)=>`        <string>${escapeXml(type)}</string>`).join(`
 `),block=types.length===0?"":`    <key>NSUserActivityTypes</key>
     <array>
 ${entries}

package/dist/build/native-screens.d.ts

@@ -1,8 +1,19 @@
 import type { IosMobileConfig } from '@stacksjs/types';
+/**
+ * The screen name a `nativeScreens` value stands for. A value is either a
+ * screen's name in `nativeScreensDir` (`Today`) or, so the web views can be the
+ * app's screens too, a view's path from the project root
+ * (`resources/views/calendar.stx`), named after it (`views-calendar`): one
+ * source for the web page and the native screen.
+ */
+export declare function nativeScreenName(value: string): string;
+/** `nativeScreens` as Craft reads it: each path to the name of the screen it opens. */
+export declare function nativeScreenRoutes(config: Pick<IosMobileConfig, 'nativeScreens'>): Record<string, string> | undefined;
 /**
  * The `.stx` file each native screen is drawn from: one per screen name in
- * `nativeScreens`, in `nativeScreensDir` (`resources/native` by default).
- * A screen named twice, for two paths, is compiled once.
+ * `nativeScreens`, in `nativeScreensDir` (`resources/native` by default), or
+ * the view a path names (`resources/views/calendar.stx`). A screen named
+ * twice, for two paths, is compiled once.
  */
 export declare function nativeScreenFiles(config: Pick<IosMobileConfig, 'nativeScreens' | 'nativeScreensDir'>, root: string, section?: 'ios' | 'android'): Record<string, string>;
 /** The app script's file (`nativeApp`), or null when the app has none. */

package/dist/build/native-screens.js

@@ -1 +1 @@
-import{existsSync,mkdirSync,rmSync,writeFileSync}from"node:fs";import{join,resolve}from"node:path";export function nativeScreenFiles(config,root,section="ios"){const dir=resolve(root,config.nativeScreensDir??"resources/native"),files={};for(const name of Object.values(config.nativeScreens??{})){if(files[name])continue;const file=join(dir,`${name}.stx`);if(!existsSync(file))throw Error(`${section}.nativeScreens names the screen "${name}", but ${file} does not exist.`);files[name]=file}return files}export function nativeAppFile(config,root,section="ios"){if(!config.nativeApp)return null;const file=resolve(root,config.nativeApp);if(!existsSync(file))throw Error(`${section}.nativeApp names ${config.nativeApp}, but ${file} does not exist.`);return file}export async function compileNativeScreens(config,root,output,compile,section="ios",options={}){const screens=nativeScreenFiles(config,root,section),names=Object.keys(screens),app=nativeAppFile(config,root,section);if(!names.length){if(app)throw Error(`${section}.nativeApp runs beside native screens: list them in ${section}.nativeScreens`);return null}const compileBundle=compile??(await import("@stacksjs/stx/native")).compileNativeBundle;mkdirSync(output,{recursive:!0});const outFile=join(output,"native-screens.js"),routesDir=join(output,"native-screens");rmSync(options.routes?outFile:routesDir,{recursive:!0,force:!0});if(options.routes){rmSync(routesDir,{recursive:!0,force:!0});const sharedRuntime=options.runtime===!0,messages=sharedRuntime&&options.messages&&config.nativeMessages?{dir:config.nativeMessages.dir,languages:[...config.nativeMessages.languages]}:void 0,result=await compileBundle({screens,initialScreen:names[0],minify:!0,routesDir,root,...sharedRuntime?{sharedRuntime}:{},...app?{app}:{},...messages?{messages}:{}});if(result.routes&&Object.keys(result.routes).length)return{outFile:routesDir,diagnostics:result.diagnostics??[]};if(!result.code)throw Error("stx compiled no native bundle: it wrote no route files and returned no code");writeFileSync(outFile,result.code);return{outFile,diagnostics:result.diagnostics??[]}}const result=await compileBundle({screens,initialScreen:names[0],minify:!0,outFile,root,...app?{app}:{}});return{outFile:result.outFile||outFile,diagnostics:result.diagnostics??[]}}
+import{existsSync,mkdirSync,rmSync,writeFileSync}from"node:fs";import{join,resolve}from"node:path";export function nativeScreenName(value){if(!value.endsWith(".stx"))return value;return value.replace(/\.stx$/,"").replace(/^resources\//,"").replace(/^\.?\//,"").replace(/[^\w-]+/g,"-").replace(/^-+|-+$/g,"")}export function nativeScreenRoutes(config){if(!config.nativeScreens)return;return Object.fromEntries(Object.entries(config.nativeScreens).map(([path,value])=>[path,nativeScreenName(value)]))}export function nativeScreenFiles(config,root,section="ios"){const dir=resolve(root,config.nativeScreensDir??"resources/native"),files={};for(const value of Object.values(config.nativeScreens??{})){const name=nativeScreenName(value);if(files[name])continue;const file=value.endsWith(".stx")?resolve(root,value):join(dir,`${value}.stx`);if(!existsSync(file))throw Error(`${section}.nativeScreens names the screen "${value}", but ${file} does not exist.`);files[name]=file}return files}export function nativeAppFile(config,root,section="ios"){if(!config.nativeApp)return null;const file=resolve(root,config.nativeApp);if(!existsSync(file))throw Error(`${section}.nativeApp names ${config.nativeApp}, but ${file} does not exist.`);return file}export async function compileNativeScreens(config,root,output,compile,section="ios",options={}){const screens=nativeScreenFiles(config,root,section),names=Object.keys(screens),app=nativeAppFile(config,root,section);if(!names.length){if(app)throw Error(`${section}.nativeApp runs beside native screens: list them in ${section}.nativeScreens`);return null}const compileBundle=compile??(await import("@stacksjs/stx/native")).compileNativeBundle;mkdirSync(output,{recursive:!0});const outFile=join(output,"native-screens.js"),routesDir=join(output,"native-screens");rmSync(options.routes?outFile:routesDir,{recursive:!0,force:!0});if(options.routes){rmSync(routesDir,{recursive:!0,force:!0});const sharedRuntime=options.runtime===!0,messages=sharedRuntime&&options.messages&&config.nativeMessages?{dir:config.nativeMessages.dir,languages:[...config.nativeMessages.languages]}:void 0,result=await compileBundle({screens,initialScreen:names[0],minify:!0,routesDir,root,...sharedRuntime?{sharedRuntime}:{},...app?{app}:{},...messages?{messages}:{}});if(result.routes&&Object.keys(result.routes).length)return{outFile:routesDir,diagnostics:result.diagnostics??[]};if(!result.code)throw Error("stx compiled no native bundle: it wrote no route files and returned no code");writeFileSync(outFile,result.code);return{outFile,diagnostics:result.diagnostics??[]}}const result=await compileBundle({screens,initialScreen:names[0],minify:!0,outFile,root,...app?{app}:{}});return{outFile:result.outFile||outFile,diagnostics:result.diagnostics??[]}}

package/dist/release-notes.d.ts

@@ -0,0 +1,79 @@
+import type { CommitInfo } from '@stacksjs/logsmith';
+/**
+ * The notes for these commits, grouped the way logsmith groups a changelog.
+ * Empty when none of them is something a tester sees.
+ */
+export declare function testerNotes(commits: CommitInfo[], options?: TesterNotesOptions): string;
+/**
+ * Notes cut to `limit` characters on whole lines, saying how many items were
+ * left out ("…and 12 more"). A section heading whose items were all cut goes
+ * too; a single line longer than the limit is cut at a word.
+ */
+export declare function fitNotes(text: string, limit: number): string;
+/** The newest mobile release tag (`v*-build.*`) at or before `ref`. */
+export declare function previousMobileTag(cwd: string, ref?: string): string | undefined;
+/** The conventional commits in `from..to`, parsed by logsmith. */
+export declare function commitsBetween(cwd: string, from: string | undefined, to?: string): CommitInfo[];
+/**
+ * The notes for a release and where they came from: `--notes`/`--notes-file`,
+ * then RELEASE_NOTES/RELEASE_NOTES_FILE, then config/mobile.ts, then generated.
+ */
+export declare function resolveNotes(options: ResolveNotesOptions): { text: string, source: NotesSource };
+/**
+ * App Store locales for the app's languages (`en` → `en-US`, `de` → `de-DE`),
+ * always with `en-US` first, the locale an app without localizations uses.
+ */
+export declare function appStoreLocales(languages: string[] | undefined): string[];
+/**
+ * Write `TestFlight/WhatToTest.<locale>.txt` beside the Xcode project, where
+ * Xcode Cloud reads it when it uploads the build to TestFlight. Returns the
+ * files written, relative to `root`.
+ */
+export declare function writeWhatToTest(root: string, projectDir: string, notes: string, locales: string[]): string[];
+/** The What to Test a tag shipped with, as committed beside its Xcode project. */
+export declare function committedWhatToTest(cwd: string, tag: string, projectDir: string, locale?: string): string | null;
+/** App Store Connect's limit on a build's "What to Test". */
+export declare const TESTFLIGHT_NOTES_LIMIT: 4000;
+/**
+ * The cap for `TestFlight/WhatToTest.<locale>.txt`. Apple documents 4000
+ * characters for the field, but Xcode Cloud has been seen to log "Found notes"
+ * and then show nothing for a file over about 2 KB (developer forums, thread
+ * 810627), so the file stays well under that. The App Store Connect API path
+ * (`--wait`, `buddy release:notes --testflight`) sets the full 4000.
+ */
+export declare const XCODE_CLOUD_NOTES_LIMIT: 1000;
+/** Google Play's limit on a release's "What's new", per language. */
+export declare const PLAY_NOTES_LIMIT: 500;
+/**
+ * The commit types a tester notices, in the order bumpx's changelog lists them.
+ * @defaultValue `['feat', 'fix', 'perf', 'revert']`
+ */
+export declare const DEFAULT_NOTE_TYPES: string[];
+/**
+ * Scopes that never describe something a tester sees.
+ * @defaultValue `['release', 'ci', 'deps', 'deps-dev', 'test', 'tests', 'docs', 'lint']`
+ */
+export declare const DEFAULT_EXCLUDED_SCOPES: string[];
+/** What testers read when nothing since the last build is theirs to see. */
+export declare const NO_VISIBLE_CHANGES: 'Maintenance build: no visible changes since the previous build.';
+/** What `config/mobile.ts` may say about release notes (`MobileConfig.release`). */
+export declare interface ReleaseNotesConfig {
+  notes?: string
+  notesFile?: string
+  noteTypes?: string[]
+  excludeScopes?: string[]
+  locales?: string[]
+}
+export declare interface TesterNotesOptions {
+  types?: string[]
+  excludeScopes?: string[]
+  markdown?: boolean
+}
+export declare interface ResolveNotesOptions {
+  cwd: string
+  flags?: { notes?: string, notesFile?: string }
+  env?: Record<string, string | undefined>
+  config?: ReleaseNotesConfig
+  generate: () => string
+}
+export type NotesSource = 'flag' | 'env' | 'config' | 'generated';

package/dist/release-notes.js

@@ -0,0 +1,9 @@
+import{existsSync,mkdirSync,readFileSync,writeFileSync}from"node:fs";import{isAbsolute,join,relative}from"node:path";import{defaultConfig,getCommits,groupCommits}from"@stacksjs/logsmith";export const TESTFLIGHT_NOTES_LIMIT=4000,XCODE_CLOUD_NOTES_LIMIT=1000,PLAY_NOTES_LIMIT=500,DEFAULT_NOTE_TYPES=["feat","fix","perf","revert"],DEFAULT_EXCLUDED_SCOPES=["release","ci","deps","deps-dev","test","tests","docs","lint"];const SECTION_TITLES={feat:"Features",fix:"Fixes",perf:"Performance",refactor:"Changes",revert:"Reverted",style:"Styles",build:"Build",docs:"Documentation"},BANG=/^(\w+)(?:\(([^)]+)\))?!: (.+)$/;function normalized(commit){const bang=commit.type==="misc"?BANG.exec(commit.message):null;return bang?{...commit,type:bang[1],scope:bang[2]||void 0,description:bang[3],breaking:!0}:commit}function line(description,scope){const text=description.replace(/\s*\((?:#\d+(?:,\s*)?)+\)\s*$/,"").replace(/\s+/g," ").trim(),sentence=text.charAt(0).toUpperCase()+text.slice(1),context=scope?.split(",").map((part)=>part.trim()).filter(Boolean).join(", ");return context?`${sentence} (${context})`:sentence}export function testerNotes(commits,options={}){const types=options.types?.length?options.types:DEFAULT_NOTE_TYPES,sections=groupCommits(commits.map(normalized),{...defaultConfig,verbose:!1,includeCommitTypes:types,excludeCommitTypes:[],excludeScopes:options.excludeScopes??DEFAULT_EXCLUDED_SCOPES,includeScopes:[],excludeAuthors:[],includeAuthors:[],excludeMessages:[],groupBreakingChanges:!1,maxCommitsPerSection:0,minCommitsForSection:1,maxDescriptionLength:0}),blocks=[];for(const section of sections){const type=section.commits[0]?.type??"",seen=new Set,lines=section.commits.map((entry)=>line(entry.description,entry.scope)).filter((text)=>text&&!seen.has(text.toLowerCase())&&seen.add(text.toLowerCase())).map((text)=>`- ${text}`);if(!lines.length)continue;const title=SECTION_TITLES[type]??type.charAt(0).toUpperCase()+type.slice(1);blocks.push([options.markdown?`**${title}**`:title,...options.markdown?[""]:[],...lines].join(`
+`))}return blocks.join(`
+
+`)}export const NO_VISIBLE_CHANGES="Maintenance build: no visible changes since the previous build.";export function fitNotes(text,limit){const notes=text.trim();if(notes.length<=limit)return notes;const lines=notes.split(`
+`),isItem=(value)=>/^\s*(?:[-*\u2022]|\d+\.)\s/.test(value),suffix=(omitted)=>omitted>0?`
+\u2026and ${omitted} more`:"\u2026",kept=[];let index=0;for(;index<lines.length;index++){const rest=lines.slice(index+1).filter(isItem).length;if([...kept,lines[index]].join(`
+`).length+suffix(rest).length>limit)break;kept.push(lines[index])}const trim=()=>{while(kept.length&&!kept[kept.length-1].trim())kept.pop()};trim();if(kept.length&&!isItem(kept[kept.length-1])&&lines[kept.length]!==void 0&&isItem(lines[kept.length])&&kept.some(isItem)){kept.pop();trim()}const omitted=lines.slice(kept.length).filter(isItem).length;if(!kept.length||omitted===0&&!kept.some(isItem)){const room=limit-1,cut=notes.slice(0,room),word=cut.lastIndexOf(" ");return`${(word>room/2?cut.slice(0,word):cut).trimEnd()}\u2026`}return`${kept.join(`
+`)}${suffix(omitted)}`}function git(cwd,args){const result=Bun.spawnSync(["git",...args],{cwd,stdout:"pipe",stderr:"ignore"});return result.exitCode===0?result.stdout.toString().trim():null}export function previousMobileTag(cwd,ref="HEAD"){return git(cwd,["describe","--tags","--match","v*-build.*","--abbrev=0",ref])||void 0}export function commitsBetween(cwd,from,to="HEAD"){return getCommits(from,to,cwd)}function readNotesFile(cwd,path,origin){const absolute=isAbsolute(path)?path:join(cwd,path);if(!existsSync(absolute))throw Error(`${origin} names ${path}, which does not exist`);return readFileSync(absolute,"utf8")}export function resolveNotes(options){const{cwd,flags={},env=process.env,config={}}=options,pick=(text,file,origin,source)=>{if(text?.trim()&&file?.trim())throw Error(`give either ${origin[0]} or ${origin[1]}, not both`);const value=text?.trim()?text:file?.trim()?readNotesFile(cwd,file.trim(),origin[1]):void 0;return value?.trim()?{text:value.trim(),source}:null},notes=typeof flags.notes==="string"?flags.notes:void 0,notesFile=typeof flags.notesFile==="string"?flags.notesFile:void 0;return pick(notes,notesFile,["--notes","--notes-file"],"flag")??pick(env.RELEASE_NOTES,env.RELEASE_NOTES_FILE,["RELEASE_NOTES","RELEASE_NOTES_FILE"],"env")??pick(config.notes,config.notesFile,["release.notes","release.notesFile"],"config")??{text:options.generate().trim()||NO_VISIBLE_CHANGES,source:"generated"}}const APP_STORE_LOCALES={en:"en-US",de:"de-DE",fr:"fr-FR",es:"es-ES",nl:"nl-NL",pt:"pt-BR",zh:"zh-Hans"};export function appStoreLocales(languages){const locales=(languages??[]).map((language)=>language.trim().replace("_","-")).filter(Boolean).map((language)=>language.includes("-")?language:APP_STORE_LOCALES[language.toLowerCase()]??language.toLowerCase());return[...new Set(["en-US",...locales])]}export function writeWhatToTest(root,projectDir,notes,locales){const dir=join(isAbsolute(projectDir)?projectDir:join(root,projectDir),"TestFlight");mkdirSync(dir,{recursive:!0});const text=`${fitNotes(notes,XCODE_CLOUD_NOTES_LIMIT)}
+`;return locales.map((locale)=>{const path=join(dir,`WhatToTest.${locale}.txt`);writeFileSync(path,text);return relative(root,path)})}export function committedWhatToTest(cwd,tag,projectDir,locale="en-US"){const path=`${projectDir.replace(/\/$/,"")}/TestFlight/WhatToTest.${locale}.txt`;return git(cwd,["show",`${tag}:${path}`])}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/actions",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.257",
+  "version": "0.75.259",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -66,55 +66,55 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/action-runner": "0.75.257",
-    "@stacksjs/ai": "0.75.257",
-    "@stacksjs/analytics": "0.75.257",
-    "@stacksjs/api": "0.75.257",
-    "@stacksjs/auth": "0.75.257",
-    "@stacksjs/build": "0.75.257",
+    "@stacksjs/action-runner": "0.75.259",
+    "@stacksjs/ai": "0.75.259",
+    "@stacksjs/analytics": "0.75.259",
+    "@stacksjs/api": "0.75.259",
+    "@stacksjs/auth": "0.75.259",
+    "@stacksjs/build": "0.75.259",
     "@stacksjs/bumpx": "^0.2.25",
     "@stacksjs/bunpress": "^0.2.15",
-    "@stacksjs/cli": "0.75.257",
-    "@stacksjs/cloud": "0.75.257",
-    "@stacksjs/cms": "0.75.257",
-    "@stacksjs/components": "0.2.644",
-    "@stacksjs/config": "0.75.257",
-    "@stacksjs/database": "0.75.257",
-    "@stacksjs/desktop-build": "0.75.257",
-    "@stacksjs/dns": "0.75.257",
-    "@stacksjs/enums": "0.75.257",
-    "@stacksjs/env": "0.75.257",
-    "@stacksjs/error-handling": "0.75.257",
-    "@stacksjs/github": "0.75.257",
+    "@stacksjs/cli": "0.75.259",
+    "@stacksjs/cloud": "0.75.259",
+    "@stacksjs/cms": "0.75.259",
+    "@stacksjs/components": "0.2.656",
+    "@stacksjs/config": "0.75.259",
+    "@stacksjs/database": "0.75.259",
+    "@stacksjs/desktop-build": "0.75.259",
+    "@stacksjs/dns": "0.75.259",
+    "@stacksjs/enums": "0.75.259",
+    "@stacksjs/env": "0.75.259",
+    "@stacksjs/error-handling": "0.75.259",
+    "@stacksjs/github": "0.75.259",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/i18n": "0.75.257",
-    "@stacksjs/image": "0.75.257",
-    "@stacksjs/logging": "0.75.257",
+    "@stacksjs/i18n": "0.75.259",
+    "@stacksjs/image": "0.75.259",
+    "@stacksjs/logging": "0.75.259",
     "@stacksjs/logsmith": "^0.2.11",
-    "@stacksjs/mobile": "0.75.257",
-    "@stacksjs/orm": "0.75.257",
-    "@stacksjs/path": "0.75.257",
-    "@stacksjs/payments": "0.75.257",
-    "@stacksjs/queue": "0.75.257",
-    "@stacksjs/registry": "0.75.257",
-    "@stacksjs/router": "0.75.257",
+    "@stacksjs/mobile": "0.75.259",
+    "@stacksjs/orm": "0.75.259",
+    "@stacksjs/path": "0.75.259",
+    "@stacksjs/payments": "0.75.259",
+    "@stacksjs/queue": "0.75.259",
+    "@stacksjs/registry": "0.75.259",
+    "@stacksjs/router": "0.75.259",
     "@stacksjs/rpx": "^0.11.54",
-    "@stacksjs/scheduler": "0.75.257",
-    "@stacksjs/search-engine": "0.75.257",
-    "@stacksjs/security": "0.75.257",
-    "@stacksjs/server": "0.75.257",
-    "@stacksjs/sites": "0.75.257",
-    "@stacksjs/storage": "0.75.257",
-    "@stacksjs/strings": "0.75.257",
-    "@stacksjs/stx": "0.2.644",
+    "@stacksjs/scheduler": "0.75.259",
+    "@stacksjs/search-engine": "0.75.259",
+    "@stacksjs/security": "0.75.259",
+    "@stacksjs/server": "0.75.259",
+    "@stacksjs/sites": "0.75.259",
+    "@stacksjs/storage": "0.75.259",
+    "@stacksjs/strings": "0.75.259",
+    "@stacksjs/stx": "0.2.656",
     "@stacksjs/tlsx": "^0.13.19",
     "@stacksjs/ts-cloud": "^0.16.58",
     "@stacksjs/ts-md": "^0.1.1",
-    "@stacksjs/tunnel": "0.75.257",
-    "@stacksjs/types": "0.75.257",
-    "@stacksjs/utils": "0.75.257",
-    "@stacksjs/whois": "0.75.257",
-    "bun-plugin-stx": "0.2.644"
+    "@stacksjs/tunnel": "0.75.259",
+    "@stacksjs/types": "0.75.259",
+    "@stacksjs/utils": "0.75.259",
+    "@stacksjs/whois": "0.75.259",
+    "bun-plugin-stx": "0.2.656"
   },
   "peerDependencies": {
     "craft-native": ">=0.0.272",
@@ -129,7 +129,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.75.257",
+    "@stacksjs/validation": "0.75.259",
     "better-dx": "^0.2.24"
   }
 }