@mapples/types 2.1.0-beta.20261114113226 → 2.1.0-beta.20261114131316

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @mapples/types
2
2
 
3
- ## 2.1.0-beta.20261114113226
3
+ ## 2.1.0-beta.20261114131316
4
4
 
5
5
  ### Patch Changes
6
6
 
@@ -36,6 +36,7 @@
36
36
 
37
37
  Vertical bar (Apple's "Designing for iPhone Duo"): `@mapples/navigation` exports `VerticalBarProvider`, `useVerticalBar`, `RailTabBar` and `RailBackButton`. Under a `VerticalBarProvider` a tabs navigator draws its stock bar as a column of icons at the bottom of the device's rail instead of along the bottom of the screen (a designed bar and `placement: 'sidebar'` keep their place), and with `navigation: true` the stack and tab headers are left out and a pushed stack screen gets its back button at the top of the rail. Play provides the bar for iPhone Duo in both postures; nothing changes where no provider is mounted. The unfolded iPhone Duo is drawn without a camera cutout: the inner camera is hidden until it is in use.
38
38
 
39
+ - ea76bd9: Navigation texts can be translated. `HeaderOptions.titleKey` and `ScreenOptions.tabLabelKey` / `drawerLabelKey` name a message of the project's locales document (`home.title`, read as `t.home.title`); while the key has a message in the active locale it is shown instead of `title` / `tabLabel` / `drawerLabel`, which stay as the text of a single-language project and the fallback. `routeTitle` and `routeItemLabel` take an optional `MessageText` reader, and `@mapples/state` exports `useMessageText()`, which reads a message key the way a `t.*` binding does. `@mapples/navigation` resolves the keys in every navigator, so headers, tab bars and drawers follow a locale switch; the Creator draws them on the canvas in the previewed language, the navigator inspector picks the key from the project's messages, and the AI navigation tools accept the three fields. The Preview app's single-screen view now provides the project's locales, so `t.*` texts are translated there as in Full flow.
39
40
  - dd68ce2: No-code animations.
40
41
  - `@mapples/style`: a style can carry motion: CSS-style transitions (`transitionProperty`, `transitionDuration`, …) and keyframe animations (`animationName` with a preset from `ANIMATION_PRESETS` or keyframes written in place, `animationDuration`, `animationIterationCount`, …). `styled()` renders such an element through Reanimated's animated component and drops the motion keys when the OS asks for reduced motion. A style value may also be a selector value (`{ default, ':active' }`).
41
42
  - `@mapples/render`: interaction states. A `styled` key can name `$pressed`, `$hovered` or `$focused` after `::` (`style::$pressed`); `applyStateVariants` turns it into selector values, and `MapplesElement` applies it in generated apps.
@@ -255,6 +255,12 @@ export interface HeaderOptions {
255
255
  visible?: boolean;
256
256
  /** Header title text. */
257
257
  title?: string;
258
+ /**
259
+ * The message key of the title in the project's locales document
260
+ * (`home.title`, read as `t.home.title`). While the key resolves in the
261
+ * active locale its message is shown; otherwise {@link title} is.
262
+ */
263
+ titleKey?: string;
258
264
  /** Header background — raw value or `ref(theme:<uuid>:<name>)`. */
259
265
  backgroundColor?: string;
260
266
  /** Tint applied to header buttons/icons. */
@@ -371,10 +377,14 @@ export interface ScreenOptions extends Partial<HeaderOptions> {
371
377
  tabIcon?: string;
372
378
  /** Tab bar label override. */
373
379
  tabLabel?: string;
380
+ /** Message key of the tab label; shown instead of {@link tabLabel} while it resolves. */
381
+ tabLabelKey?: string;
374
382
  /** Drawer icon — `ref(icon:<uuid>:<name>)` or `ref(glyph:<family>:<name>)`. */
375
383
  drawerIcon?: string;
376
384
  /** Drawer label override. */
377
385
  drawerLabel?: string;
386
+ /** Message key of the drawer label; shown instead of {@link drawerLabel} while it resolves. */
387
+ drawerLabelKey?: string;
378
388
  }
379
389
  /**
380
390
  * A built-in font glyph used as a tab / drawer icon: the icon family's key as
@@ -408,14 +418,22 @@ export declare const parseGlyphRef: (value?: string) => GlyphRef | null;
408
418
  * layouts (the `mapples` CLI mirrors it) both apply.
409
419
  */
410
420
  export declare const routeHeaderVisible: (navigator: NavigatorNode, route: RouteNode) => boolean;
421
+ /**
422
+ * Reads a message of the project's locales document in the active locale:
423
+ * the formatted text of a message key, `undefined` when the key does not
424
+ * resolve (an unknown key, or a host with no locale runtime).
425
+ */
426
+ export type MessageText = (key: string) => string | undefined;
411
427
  /**
412
428
  * The title a route's screen shows in its header: the route's own, else the
413
- * navigator's, else the route name.
429
+ * navigator's, else the route name. At each level a title's message key
430
+ * (`titleKey`) wins over its literal while `text` resolves it.
414
431
  */
415
- export declare const routeTitle: (navigator: NavigatorNode, route: RouteNode) => string;
432
+ export declare const routeTitle: (navigator: NavigatorNode, route: RouteNode, text?: MessageText) => string;
416
433
  /**
417
- * The label a route's tab or drawer item shows: the route's `tabLabel` /
418
- * `drawerLabel`, else the route name — never the header title, which a
434
+ * The label a route's tab or drawer item shows ({@link routeItemLabel}): the
435
+ * route's `tabLabel` / `drawerLabel` (its message key first, while `text`
436
+ * resolves it), else the route name — never the header title, which a
419
437
  * navigator-wide title would otherwise put on every item.
420
438
  */
421
439
  /**
@@ -424,5 +442,5 @@ export declare const routeTitle: (navigator: NavigatorNode, route: RouteNode) =>
424
442
  * the generated layouts, so a screen is designed against the bar it gets.
425
443
  */
426
444
  export declare const tabBarSide: (tabBar: TabBarOptions | undefined, width: number) => "bottom" | "left";
427
- export declare const routeItemLabel: (kind: "tabs" | "drawer", route: RouteNode) => string;
445
+ export declare const routeItemLabel: (kind: "tabs" | "drawer", route: RouteNode, text?: MessageText) => string;
428
446
  //# sourceMappingURL=navigation.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC;IACX,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,aAAa,CAAC;IACpB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gLAYnB,CAAC;AAEX,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,EACF;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,kBAAkB,CAAC;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AASnC;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAAM,EAOrD,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OACjB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,sDAAsD;IACtD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAI/C,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,UAAU,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACxC,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,aAAa,CAAC;IAC3D,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MAC7B,CAAC;AAEjC,kFAAkF;AAClF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,QAAQ,GAAG,IAIzD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,aAAa,EACxB,OAAO,SAAS,KACf,OAIgD,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,aAAa,EACxB,OAAO,SAAS,KACf,MACqE,CAAC;AAEzE;;;;GAIG;AACH;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,GAAG,SAAS,EACjC,OAAO,MAAM,KACZ,QAAQ,GAAG,MAOb,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,GAAG,QAAQ,EACvB,OAAO,SAAS,KACf,MAES,CAAC"}
1
+ {"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"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"}
@@ -101,14 +101,23 @@ export const routeHeaderVisible = (navigator, route) => route.options?.visible ?
101
101
  (route.target.kind === 'navigator'
102
102
  ? false
103
103
  : (navigator.options?.header?.visible ?? true));
104
+ /** The message of `key` when it resolves, else the literal text. */
105
+ const localizedText = (key, literal, text) => {
106
+ const translated = key && text ? text(key) : undefined;
107
+ return translated ?? literal;
108
+ };
104
109
  /**
105
110
  * The title a route's screen shows in its header: the route's own, else the
106
- * navigator's, else the route name.
111
+ * navigator's, else the route name. At each level a title's message key
112
+ * (`titleKey`) wins over its literal while `text` resolves it.
107
113
  */
108
- export const routeTitle = (navigator, route) => route.options?.title ?? navigator.options?.header?.title ?? route.name;
114
+ export const routeTitle = (navigator, route, text) => localizedText(route.options?.titleKey, route.options?.title, text) ??
115
+ localizedText(navigator.options?.header?.titleKey, navigator.options?.header?.title, text) ??
116
+ route.name;
109
117
  /**
110
- * The label a route's tab or drawer item shows: the route's `tabLabel` /
111
- * `drawerLabel`, else the route name — never the header title, which a
118
+ * The label a route's tab or drawer item shows ({@link routeItemLabel}): the
119
+ * route's `tabLabel` / `drawerLabel` (its message key first, while `text`
120
+ * resolves it), else the route name — never the header title, which a
112
121
  * navigator-wide title would otherwise put on every item.
113
122
  */
114
123
  /**
@@ -126,6 +135,7 @@ export const tabBarSide = (tabBar, width) => {
126
135
  }
127
136
  return 'bottom';
128
137
  };
129
- export const routeItemLabel = (kind, route) => (kind === 'tabs' ? route.options?.tabLabel : route.options?.drawerLabel) ??
130
- route.name;
138
+ export const routeItemLabel = (kind, route, text) => (kind === 'tabs'
139
+ ? localizedText(route.options?.tabLabelKey, route.options?.tabLabel, text)
140
+ : localizedText(route.options?.drawerLabelKey, route.options?.drawerLabel, text)) ?? route.name;
131
141
  //# sourceMappingURL=navigation.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mapples/types",
3
- "version": "2.1.0-beta.20261114113226",
3
+ "version": "2.1.0-beta.20261114131316",
4
4
  "main": "dist/index.js",
5
5
  "types": "dist/index.d.ts",
6
6
  "scripts": {