@stacksjs/defaults 0.75.145 → 0.75.147

package/ai/skills/stacks-native/CATALOG.md

@@ -35,7 +35,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/composables` | [`stacks-composables`](../stacks-composables/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/composables/src/index.ts) | 18 |
 | `@stacksjs/config` | [`stacks-config`](../stacks-config/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/config/src/index.ts) | 15 |
 | `@stacksjs/cron` | [`stacks-cron`](../stacks-cron/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cron/src/index.ts) | 4 |
-| `@stacksjs/database` | [`stacks-database`](../stacks-database/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/index.ts) | 114 |
+| `@stacksjs/database` | [`stacks-database`](../stacks-database/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/index.ts) | 115 |
 | `@stacksjs/datetime` | [`stacks-datetime`](../stacks-datetime/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/datetime/src/index.ts) | 12 |
 | `@stacksjs/defaults` | [`stacks-build`](../stacks-build/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/defaults/package.json) | 1 |
 | `@stacksjs/deploy` | [`stacks-deploy`](../stacks-deploy/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/deploy/package.json) | 1 |
@@ -63,7 +63,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/mobile` | [`stacks-mobile`](../stacks-mobile/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/mobile/src/index.ts) | 12 |
 | `@stacksjs/model-meta` | [`stacks-models`](../stacks-models/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/model-meta/src/index.ts) | 1 |
 | `@stacksjs/newsletter` | [`stacks-newsletter`](../stacks-newsletter/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/newsletter/src/index.ts) | 7 |
-| `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 13 |
+| `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 14 |
 | `@stacksjs/objects` | [`stacks-objects`](../stacks-objects/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/objects/src/index.ts) | 4 |
 | `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 60 |
 | `@stacksjs/pagination` | [`stacks-pagination`](../stacks-pagination/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/pagination/src/index.ts) | 0 |
@@ -351,7 +351,7 @@ Declared runtime exports: `BUN_BROKEN_MYSQL_POOL_MESSAGE`, `BUN_BROKEN_POSTGRES_
 
 Local source modules: [src/affected-rows.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/affected-rows.ts), [src/auth-tables.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/auth-tables.ts), [src/broken-pool.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/broken-pool.ts), [src/custom/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/custom/index.ts), [src/database.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/database.ts), [src/datetime-columns.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/datetime-columns.ts), [src/ddl-constraints.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/ddl-constraints.ts), [src/defaults.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/defaults.ts), [src/dialect.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/dialect.ts), [src/driver-config.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/driver-config.ts), [src/drivers/dynamodb.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/drivers/dynamodb.ts), [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/drivers/index.ts), [src/ensure-database.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/ensure-database.ts), [src/erd.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/erd.ts), [src/fk-audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/fk-audit.ts), [src/framework-renames.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/framework-renames.ts), [src/hand-written-migrations.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/hand-written-migrations.ts), [src/ignored-migrations.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/ignored-migrations.ts), [src/index-shape.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/index-shape.ts), [src/managed-columns.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/managed-columns.ts), [src/migration-dialect.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/migration-dialect.ts), [src/migration-ledger.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/migration-ledger.ts), [src/migration-path.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/migration-path.ts), [src/migrations.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/migrations.ts), [src/model-sources.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/model-sources.ts), [src/notification-tables.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/notification-tables.ts), [src/package-migrations.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/package-migrations.ts), [src/package-models.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/package-models.ts), [src/query-logger.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/query-logger.ts), [src/rbac-tables.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/rbac-tables.ts), [src/relation-columns.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/relation-columns.ts), [src/replicas.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/replicas.ts), [src/row-lock.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/row-lock.ts), [src/safe-migrations.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/safe-migrations.ts), [src/schema-align.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/schema-align.ts), [src/schema-drift.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/schema-drift.ts), [src/seeder.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/seeder.ts), [src/shadowed-models.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/shadowed-models.ts), [src/sql-helpers.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/sql-helpers.ts), [src/trait-tables.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/trait-tables.ts), [src/transaction-context.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/transaction-context.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/types.ts), [src/unique-audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/unique-audit.ts), [src/utc-defaults.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/utc-defaults.ts), [src/utils.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/utils.ts), [src/uuid-columns.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/uuid-columns.ts), [src/vschema.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/src/vschema.ts).
 
-Evidence directory: [114 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [115 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/database/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/datetime
 
@@ -607,11 +607,11 @@ Evidence directory: [7 retained tests](https://github.com/stacksjs/stacks/blob/m
 
 Guidance: [`stacks-notifications`](../stacks-notifications/SKILL.md). Source: [storage/framework/core/notifications/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts).
 
-Declared runtime exports: `BroadcastNotificationDriver`, `DEFAULT_SMS_OPT_OUT`, `DEFAULT_UNSUBSCRIBE_NOTICE`, `DatabaseNotificationDriver`, `SMS_SENDER_MAX_LENGTH`, `accountNotificationTemplates`, `bulkSetPreferences`, `commerceNotificationTemplates`, `createNotificationTemplates`, `defineNotificationTemplates`, `emailParagraphs`, `ensureSuccessfulEmailResult`, `ensureSuccessfulNotificationResults`, `filterChannelsByPreferences`, `getNotificationPreferences`, `interpolateNotificationText`, `listUnsubscribeHeaders`, `makeDeliveryRecord`, `notification`, `notificationChannel`, `notificationEmailHtml`, `notificationEmailMessage`, `notificationEmailText`, `notificationSmsBody`, `notificationTemplateVariables`, `notificationUnsubscribeLinks`, `notificationUnsubscribeToken`, `notify`, `parseNotificationUnsubscribeToken`, `recordNotificationDelivery`, `renderNotificationTemplate`, `resolveDeliveryRecipient`, `resolveNotificationLocale`, `setNotificationPreference`, `smsSenderPrefix`, `subscriptionNotificationTemplates`, `unsubscribeTokenFromRequest`, `unsubscribeWithToken`, `useBroadcast`, `useChat`, `useDatabase`, `useEmail`, `useNotification`, `usePush`, `useSMS`, `wherePreferenceCategory`.
+Declared runtime exports: `BroadcastNotificationDriver`, `DEFAULT_SMS_OPT_OUT`, `DEFAULT_UNSUBSCRIBE_NOTICE`, `DatabaseNotificationDriver`, `NOTIFICATION_FRAME_STRINGS`, `SMS_SENDER_MAX_LENGTH`, `accountNotificationTemplates`, `bulkSetPreferences`, `commerceNotificationTemplates`, `createNotificationTemplates`, `defineNotificationTemplates`, `emailParagraphs`, `ensureSuccessfulEmailResult`, `ensureSuccessfulNotificationResults`, `filterChannelsByPreferences`, `getNotificationPreferences`, `interpolateNotificationText`, `listUnsubscribeHeaders`, `makeDeliveryRecord`, `notification`, `notificationChannel`, `notificationEmailHtml`, `notificationEmailMessage`, `notificationEmailText`, `notificationFrameStrings`, `notificationLanguageTag`, `notificationSmsBody`, `notificationTemplateVariables`, `notificationUnsubscribeLinks`, `notificationUnsubscribeToken`, `notify`, `parseNotificationUnsubscribeToken`, `recordNotificationDelivery`, `renderNotificationTemplate`, `resolveDeliveryRecipient`, `resolveNotificationLocale`, `setNotificationPreference`, `smsSenderPrefix`, `subscriptionNotificationTemplates`, `unsubscribeTokenFromRequest`, `unsubscribeWithToken`, `useBroadcast`, `useChat`, `useDatabase`, `useEmail`, `useNotification`, `usePush`, `useSMS`, `wherePreferenceCategory`.
 
-Local source modules: [src/delivery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/delivery.ts), [src/drivers/broadcast.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/broadcast.ts), [src/drivers/database.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/database.ts), [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/index.ts), [src/email-body.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/email-body.ts), [src/preferences.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/preferences.ts), [src/templates.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/templates.ts), [src/unsubscribe.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/unsubscribe.ts).
+Local source modules: [src/delivery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/delivery.ts), [src/drivers/broadcast.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/broadcast.ts), [src/drivers/database.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/database.ts), [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/drivers/index.ts), [src/email-body.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/email-body.ts), [src/frame-strings.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/frame-strings.ts), [src/preferences.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/preferences.ts), [src/templates.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/templates.ts), [src/unsubscribe.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/unsubscribe.ts).
 
-Evidence directory: [13 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [14 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/objects
 
@@ -807,7 +807,7 @@ Guidance: [`stacks-sms`](../stacks-sms/SKILL.md). Source: [storage/framework/cor
 
 Declared runtime exports: `SMS`, `TwilioDriver`, `VonageDriver`, `createTwilioDriver`, `createVonageDriver`.
 
-Local source modules: [src/compliance.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/compliance.ts), [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/index.ts), [src/drivers/twilio.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/twilio.ts), [src/drivers/vonage.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/vonage.ts), [src/inbound.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/inbound.ts), [src/opt-out.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/opt-out.ts), [src/sms.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/sms.ts).
+Local source modules: [src/compliance.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/compliance.ts), [src/drivers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/index.ts), [src/drivers/twilio.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/twilio.ts), [src/drivers/vonage.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/drivers/vonage.ts), [src/inbound.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/inbound.ts), [src/keywords.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/keywords.ts), [src/opt-out.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/opt-out.ts), [src/sms.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/src/sms.ts).
 
 Evidence directory: [5 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/sms/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 

package/ai/skills/stacks-notifications/SKILL.md

@@ -41,8 +41,9 @@ optional `error`. A resolved call does not imply every channel succeeded.
 | push | pushTokens, a string or string array | `@stacksjs/push`, default Expo |
 | broadcast | broadcastChannel or userId | `@stacksjs/realtime` |
 
-Payload: `{ body, subject?, data?, action? }`. Email treats body as text and
-renders it through the framework layout. Use the exported `NotificationAction`
+Payload: `{ body, subject?, data?, action?, locale?, strings? }`. Email treats
+body as text and renders it through the framework layout (see "The frame's
+language" for `locale`). Use the exported `NotificationAction`
 type for an action link. The broadcast fallback is `private-user.{userId}` or
 public `notifications` when no user/channel is supplied. Its delivery is
 best-effort; a missing realtime server is not a durable notification queue.
@@ -119,6 +120,37 @@ body already starts with it); pass it whenever several businesses share one
 sending number, so the person can tell who wrote. STOP only becomes an opt-out the app sees when inbound
 SMS is wired up; see `stacks-sms`.
 
+## The frame's language
+
+The subject, body and button label are the caller's. The words around them
+are the frame's: the transactional footer ("This is an automated message from
+{app}. Please do not reply to this email."), the copyright line, the marketing
+notice, the **Unsubscribe** / **Email preferences** labels (also in the text
+part), the button label when the action has none ("Open") and a marketing
+text's opt-out line. `payload.locale` puts all of them in the reader's
+language and sets the email's `<html lang>`:
+
+```ts
+const language = user.locale // 'de', 'de-AT', 'en', ...
+await notify({ userId, email }, { ...templates.render('order_receipt', variables, language), locale: language }, ['email'])
+```
+
+- Built in: `en` and `de` (`NOTIFICATION_FRAME_STRINGS`). Fallback like the
+  templates: `de-AT` → `de` → `en`. No locale renders exactly the English the
+  frame always had (a fixture test holds it byte for byte).
+- Another language: pass the whole set as `payload.strings`
+  (`NotificationFrameStrings`: `automatedNotice`, `copyright`,
+  `unsubscribeNotice`, `unsubscribe`, `preferences`, `action`, `smsOptOut`). A
+  partial set overrides only what it names. `{app}` and `{year}` are filled in.
+- Precedence: `unsubscribe.notice` and `payload.smsOptOut` still win over the
+  frame's notice and opt-out line.
+- The builders take the same fields: `notificationEmailMessage`,
+  `notificationEmailHtml`, `notificationEmailText`, `notificationSmsBody`;
+  `notificationFrameStrings(locale, overrides)` resolves a set.
+- An app's own `resources/emails/notification.stx` must read the new props
+  (`lang`, `automatedNotice`, `copyrightNotice`, `unsubscribeLabel`,
+  `preferencesLabel`) to be localized; `<EmailLayout lang>` sets `<html lang>`.
+
 ## Templates: one catalog of localized messages
 
 `@stacksjs/notifications/templates` (pure, browser-safe; also exported from the
@@ -200,7 +232,8 @@ delivery log, not extra columns on the inbox.
 signatures. `preferences.ts`, `delivery.ts` and `drivers/database.ts`
 own their persistence; the query builder is bun-query-builder.
 `notifications.test.ts`, `delivery-tracking.test.ts`,
-`broadcast.test.ts` and `email-body.test.ts` cover retained behavior.
+`broadcast.test.ts`, `email-body.test.ts` and `frame-locale.test.ts` cover
+retained behavior; `frame-strings.ts` holds the frame's languages.
 For provider status, consult `config/src/capabilities.ts` and each channel
 skill; a constructed send request is not a live delivery assertion.
 

package/ai/skills/stacks-sms/SKILL.md

@@ -393,7 +393,10 @@ interface VerificationResult {
 STOP/START/HELP, persists opt-out or opt-in, and returns the reply an inbound
 webhook should send. `optOutPhone`, `optInPhone`,
 `isPhoneOptedOut` and `normalizePhone` use the persistent
-`sms_opt_outs` table. Apply its model migration first. Sending through the
+`sms_opt_outs` table. Apply its model migration first. `optOutPhone` is one
+insert-or-ignore on the unique `phone` (`ON CONFLICT DO NOTHING`, `INSERT
+IGNORE` on MySQL), so repeated or concurrent STOPs leave one row and keep the
+first opt-out's time and reason. Sending through the
 generic notification SMS channel checks opt-outs; inspect the selected direct
 send path before assuming a low-level provider call applies that policy.
 
@@ -403,6 +406,15 @@ normalizes its payload. `classifySmsIntent/smsComplianceReply` are pure helpers;
 they do not themselves persist consent. Use the persistent handleInboundSms
 workflow when consent state must affect future sends.
 
+Keywords are recognised in every language `SMS_KEYWORDS` has, on every
+message (`matchSmsKeyword(body)` returns the kind and the language): English
+`STOP`/`STOPALL`/`UNSUBSCRIBE`/`CANCEL`/`END`/`QUIT`, `START`/`YES`/`UNSTOP`,
+`HELP`/`INFO`, and German `STOPP`/`ABMELDEN`/`ABBESTELLEN`, `STARTEN`,
+`HILFE`. Only the first word counts, in any case. `classifyInboundSms`,
+`handleInboundSms` and `classifySmsIntent` all use these lists, and
+`inboundSmsReply(kind, { locale })` answers in the keyword's language. Add a
+language by adding its keywords and replies in `src/keywords.ts`.
+
 For a Twilio incoming-message webhook, `handleTwilioInbound(request, options)`
 does the whole job and returns the TwiML `Response`: it reads the form body,
 verifies `X-Twilio-Signature` with `TWILIO_AUTH_TOKEN` against `APP_URL` plus
@@ -411,8 +423,12 @@ URL is not what Twilio signed), records STOP/START in `sms_opt_outs`, then
 calls `onConsentChange({ phone, kind })` so the app can switch its own
 preferences, and `onMessage(message)` for every verified text. Without a token
 it answers 503, and a bad signature 403, changing nothing. It does not reply to
-keywords unless `reply: true`, because Twilio's own opt-out handling already
-answers STOP/START/HELP and a second reply arrives twice. Twilio Advanced
+keywords unless asked, because Twilio's own opt-out handling already answers
+the English STOP/START/HELP and a second reply arrives twice. `reply:
+'unhandled'` confirms only the keywords Twilio does not know (STOPP and the
+other German ones), in their language, so every keyword gets exactly one
+confirmation; `reply: true` answers all of them. `onConsentChange` and
+`onMessage` receive the keyword's `locale`. Twilio Advanced
 Opt-Out's `OptOutType` field wins over the keyword list (`inboundSmsKind`), so
 custom keywords configured there count. `inboundSmsReply(kind)` is the reply
 copy `handleInboundSms` uses. Route it with `skipCsrf()` and point the number's

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.145",
+  "version": "0.75.147",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.145",
+  "version": "0.75.147",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.145",
+    "@stacksjs/mobile": "0.75.147",
     "@stacksjs/sanitizer": "^0.2.422",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",

package/resources/components/Email/EmailLayout.stx

@@ -37,6 +37,7 @@ interface EmailLayoutProps {
   brandUrl?: string
   accent?: string
   footer?: string
+  lang?: string
 }
 
 const props = defineProps<EmailLayoutProps>()
@@ -49,6 +50,9 @@ const brand = props.brand || ''
 const brandUrl = props.brandUrl || ''
 const accent = props.accent || '#3451b2'
 const footer = props.footer || ''
+// The language the email is written in (`<html lang>`), for screen readers
+// and mail clients' translate offers.
+const lang = props.lang || 'en'
 const fontStack = '-apple-system,BlinkMacSystemFont,\'Segoe UI\',Roboto,\'Helvetica Neue\',Arial,sans-serif'
 
 const responsiveCss = [
@@ -73,7 +77,7 @@ const responsiveCss = [
 </script>
 
 <!DOCTYPE html>
-<html lang="en">
+<html lang="{{ lang }}">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">

package/resources/components/NativeComponents.test.ts

@@ -84,7 +84,9 @@ describe('Native components', () => {
   it('backs out through history, and sticks within the page rather than its wrapper', () => {
     const bar = read('NativeNavBar')
     expect(bar).toContain('if (goBack()) event.preventDefault()')
-    expect(bar).toContain('[data-stx-scope]:has(> .native-nav) { display: contents; }')
+    expect(bar).toContain('[data-stx-scope]:has(> .native-nav),')
+    // A header component wrapping the bar adds a wrapper of its own.
+    expect(bar).toContain('[data-stx-scope]:has(> [data-stx-scope] > .native-nav) { display: contents; }')
     expect(bar).toContain("useReactiveProp<string>('title', '')")
   })
 

package/resources/components/NativeNavBar.stx

@@ -105,9 +105,12 @@ function tapBack(event: MouseEvent): void {
 <style>
   /* The element stx wraps each component in is a box too, as tall as the bar
      and its title; the bar stuck inside it and scrolled away with the title.
-     Both boxes step aside so the bar sticks to the page. */
+     Both boxes step aside so the bar sticks to the page, and so does the
+     wrapper of an app's own header component around this one (HQ's
+     MobileHeader): one box more, and the bar scrolled away again. */
   .native-nav,
-  [data-stx-scope]:has(> .native-nav) { display: contents; }
+  [data-stx-scope]:has(> .native-nav),
+  [data-stx-scope]:has(> [data-stx-scope] > .native-nav) { display: contents; }
 
   .native-nav-bar {
     position: sticky;

package/resources/emails/notification.stx

@@ -6,6 +6,8 @@
 // mailers (stacksjs/stacks#1901); an app's own resources/emails/notification
 // wins over this one. A notification with `unsubscribe` (marketing) says why
 // it came and links to Unsubscribe in the footer instead of "do not reply".
+// Every fixed word of the frame comes in as a prop, so a `locale` passed to
+// notify() makes the whole email that language.
 const appName = props.appName || 'Stacks'
 const primaryColor = props.primaryColor || '#3451b2'
 const subject = props.subject || appName
@@ -17,9 +19,19 @@ const unsubscribeUrl = props.unsubscribeUrl || ''
 const unsubscribeNotice = props.unsubscribeNotice || 'You are receiving this because these emails are turned on in your settings.'
 const preferencesUrl = props.preferencesUrl || ''
 const year = props.year || new Date().getFullYear()
+// The frame's fixed words, in the reader's language when notify() was given
+// a `locale` (see NotificationFrameStrings in @stacksjs/notifications). The
+// English here is only for a render without them. `{app}` and `{year}` are
+// filled in below.
+const lang = props.lang || 'en'
+const fill = text => String(text).split('{app}').join(appName).split('{year}').join(String(year))
+const automatedNotice = fill(props.automatedNotice || 'This is an automated message from {app}. Please do not reply to this email.')
+const copyrightNotice = fill(props.copyrightNotice || '{year} {app}. All rights reserved.')
+const unsubscribeLabel = props.unsubscribeLabel || 'Unsubscribe'
+const preferencesLabel = props.preferencesLabel || 'Email preferences'
 </script>
 
-<EmailLayout title="{{ subject }}" preheader="{{ preheader }}">
+<EmailLayout title="{{ subject }}" preheader="{{ preheader }}" lang="{{ lang }}">
   <template #header>
     <tr>
       <td style="background-color:{{ primaryColor }};padding:30px 40px;text-align:center;">
@@ -42,11 +54,11 @@ const year = props.year || new Date().getFullYear()
       <td style="padding:20px 40px;background-color:#f9fafb;border-top:1px solid #e5e7eb;">
         @if(unsubscribeUrl)
           <p style="margin:0;color:#6b7280;font-size:12px;text-align:center;">{{ unsubscribeNotice }}</p>
-          <p style="margin:8px 0 0 0;color:#6b7280;font-size:12px;text-align:center;"><a href="{{ unsubscribeUrl }}" style="color:#6b7280;text-decoration:underline;">Unsubscribe</a>@if(preferencesUrl) &middot; <a href="{{ preferencesUrl }}" style="color:#6b7280;text-decoration:underline;">Email preferences</a>@endif</p>
+          <p style="margin:8px 0 0 0;color:#6b7280;font-size:12px;text-align:center;"><a href="{{ unsubscribeUrl }}" style="color:#6b7280;text-decoration:underline;">{{ unsubscribeLabel }}</a>@if(preferencesUrl) &middot; <a href="{{ preferencesUrl }}" style="color:#6b7280;text-decoration:underline;">{{ preferencesLabel }}</a>@endif</p>
         @else
-          <p style="margin:0;color:#6b7280;font-size:12px;text-align:center;">This is an automated message from {{ appName }}. Please do not reply to this email.</p>
+          <p style="margin:0;color:#6b7280;font-size:12px;text-align:center;">{{ automatedNotice }}</p>
         @endif
-        <p style="margin:10px 0 0 0;color:#9ca3af;font-size:11px;text-align:center;">&copy; {{ year }} {{ appName }}. All rights reserved.</p>
+        <p style="margin:10px 0 0 0;color:#9ca3af;font-size:11px;text-align:center;">&copy; {{ copyrightNotice }}</p>
       </td>
     </tr>
   </template>