@multiplatform.one/theme 7.2.2 → 7.4.0

package/types/theme/sizeRecipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sizeRecipes.d.ts","sourceRoot":"","sources":["../../src/theme/sizeRecipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAyBxB;;;GAGG;AACH,eAAO,MAAM,cAAc,yCAAmB,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,WAAW,4BAAiC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,+DAAqC,CAAC;AACxE,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,mBAAmB,wBAAiC,CAAC;AAClE,eAAO,MAAM,yBAAyB,wBAAsC,CAAC;AAC7E,eAAO,MAAM,kBAAkB,2CAAgC,CAAC;AAChE,eAAO,MAAM,0BAA0B,2CAAuC,CAAC;AAE/E,eAAO,MAAM,wBAAwB,wCAAyC,CAAC;AAmB/E,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,oBAAoB,CAE7F;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAyB,GACrD,UAAU,CAEZ;AAOD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAC3C,UAAU,CAWZ;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;CAAE,GAC1E,UAAU,CAKZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE/C"}
+{"version":3,"file":"sizeRecipes.d.ts","sourceRoot":"","sources":["../../src/theme/sizeRecipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAyBxB;;;GAGG;AACH,eAAO,MAAM,cAAc,yCAAmB,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,WAAW,4BAAiC,CAAC;AAC1D,eAAO,MAAM,qBAAqB,+DAAqC,CAAC;AACxE,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,sBAAsB,gEAAsC,CAAC;AAC1E,eAAO,MAAM,mBAAmB,wBAAiC,CAAC;AAClE,eAAO,MAAM,yBAAyB,wBAAsC,CAAC;AAC7E,eAAO,MAAM,kBAAkB,2CAAgC,CAAC;AAChE,eAAO,MAAM,0BAA0B,2CAAuC,CAAC;AAE/E,eAAO,MAAM,wBAAwB,wCAAyC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,cAAc,sCAAgB,CAAC;AAE5C,wBAAgB,iBAAiB,IAAI,OAAO,cAAc,CAEzD;AAwBD,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,oBAAoB,CAE7F;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAyB,GACrD,UAAU,CAEZ;AAOD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAC3C,UAAU,CAQZ;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;CAAE,GAC1E,UAAU,CAKZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE/C"}

package/types/theme/tileSizes.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Tile-size ladder + media-aspect vocabulary (MPO-31, design-system/12 D.3
+ * holes H1/H2).
+ *
+ * Every tile wall needs the same two decisions: HOW BIG is a tile (a small
+ * named ladder a person can pick from — the user-facing S/M/L/XL control)
+ * and WHAT SHAPE is its media (so the loading skeleton is the same shape as
+ * the image that replaces it). Before this module both were app-invented:
+ * the console's `launcherGeometry.ts` (03-our-surfaces.md DL-9) and
+ * Lookout's private `TILE_SIZES` were the same gap twice.
+ *
+ * Like the control-size recipes (LC-70 RECIPE-INPUTS), STORED INPUTS are the
+ * source of truth and the ladder table is DERIVED — never handwritten at a
+ * call site. The default rung values are the MEASURED ladders from the two
+ * real consumers, not invented numbers:
+ *
+ * | rung | minWidth | maxWidth | measured from                                  |
+ * |------|----------|----------|------------------------------------------------|
+ * | xs   | 104      | 143      | launcher icon-plate track `minmax(104px,1fr)`  |
+ * | sm   | 220      | 300      | Lookout `TILE_SIZES.s` / SPA `TILE_MIN.s`      |
+ * | md   | 320      | 440      | Lookout `TILE_SIZES.m` / SPA `TILE_MIN.m`      |
+ * | lg   | 480      | 720      | Lookout `TILE_SIZES.l` / SPA `TILE_MIN.l`      |
+ * | xl   | 720      | 1400     | Lookout `TILE_SIZES.xl` / SPA `TILE_MIN.xl`    |
+ *
+ * `{ baseWidth: 280 }` (no rungWidths / widthFactors) regenerates the whole
+ * ladder geometrically from `baseWidth * stepRatio ** step`, the same
+ * override contract `resolveSizeRecipeInputs` gives `baseHeight`.
+ *
+ * OWNERSHIP (12-one-design.md Part B): the RUNGS are universal — generated
+ * here, restyled only through recipe inputs
+ * (`setSizeRecipeInputs({ tile })` / `createDefaultThemeConfig({ recipeInputs:
+ * { tile } })`). WHICH rung a surface shows is per-app (a prop, often
+ * persisted per user). Tile gutters stay on the space knob and tile rounding
+ * on the borderRadius knob — this module never emits a gap or a radius.
+ *
+ * DENSITY (LC-76): density moves SPACE only. A compact density steps the
+ * gutters between tiles (via the space knob) and must never re-rung the
+ * ladder — tile magnitude is content scale, not chrome scale, so nothing
+ * here reads the density knob.
+ */
+export declare const tileSizeRungs: readonly ["xs", "sm", "md", "lg", "xl"];
+export type TileSizeRung = (typeof tileSizeRungs)[number];
+/** One rung: the narrowest a tile may render, and the widest. */
+export type TileSizeStop = {
+    minWidth: number;
+    maxWidth: number;
+};
+export type TileSizeLadder = Record<TileSizeRung, TileSizeStop>;
+export type TileSizeInputs = {
+    /** Desktop px min-width of the `md` rung. */
+    baseWidth: number;
+    /** Rung-to-rung ratio when regenerating geometrically. */
+    stepRatio: number;
+    /** Exponent of each rung relative to `md` (0). */
+    rungSteps: Record<TileSizeRung, number>;
+    /**
+     * Absolute desktop px min-widths. When omitted, min-widths come from
+     * `baseWidth * stepRatio ** step` (or `widthFactors`).
+     */
+    rungWidths?: Partial<Record<TileSizeRung, number>>;
+    /**
+     * Optional per-rung scale relative to `baseWidth`. Used only when
+     * `rungWidths` is omitted. Factors are `stepRatio ** exponent` otherwise.
+     */
+    widthFactors?: Partial<Record<TileSizeRung, number>>;
+    /** maxWidth = minWidth * maxRatio for any rung `rungMaxWidths` does not pin. */
+    maxRatio: number;
+    /** Absolute desktop px max-widths (measured pins win over `maxRatio`). */
+    rungMaxWidths?: Partial<Record<TileSizeRung, number>>;
+};
+export declare const tileSizeStepExponents: Record<TileSizeRung, number>;
+/** Lossless relative table: the measured 104/220/320/480/720 ramp at baseWidth 320. */
+export declare const defaultWidthFactors: Record<TileSizeRung, number>;
+export declare const defaultTileSizeInputs: TileSizeInputs;
+/**
+ * Deep copy that PRESERVES partiality: keys the caller never set stay
+ * unset, so a later `resolveTileSizeInputs` still sees them as defaults
+ * rather than explicit undefineds.
+ */
+export declare function cloneTileSizeInputs<T extends Partial<TileSizeInputs>>(inputs: T): T;
+/**
+ * Fill defaults. `{ baseWidth: 280 }` (any scaling override without explicit
+ * tables) drops the measured rungWidths/widthFactors/rungMaxWidths so every
+ * rung regenerates from `stepRatio` — the `resolveSizeRecipeInputs` contract.
+ */
+export declare function resolveTileSizeInputs(partial?: Partial<TileSizeInputs>): TileSizeInputs;
+/** Derive the full ladder from resolved inputs. Tables are generated, never handwritten. */
+export declare function generateTileSizeLadder(inputs: TileSizeInputs): TileSizeLadder;
+export type TileRungFlexProps = {
+    flexGrow: number;
+    flexBasis: number;
+    minWidth: number;
+    maxWidth: number;
+};
+/**
+ * Style fragment for a tile in a wrapping flex wall (the Lookout idiom:
+ * tiles grow from `minWidth` and stop at `maxWidth`). Spread it on the tile
+ * surface; gutters stay on the container's space-knob gap.
+ */
+export declare function tileRungFlexProps(stop: TileSizeStop): TileRungFlexProps;
+/**
+ * Column count for a fixed-column tile grid (the ImageGrid / springboard
+ * idiom): as many columns as fit at the rung's minWidth. `gutter` is the
+ * inter-column gap (the space knob's value), never baked into the rung.
+ *
+ * The count is min-driven on purpose: adding a column to honor `maxWidth`
+ * would, by construction of the fit, drop every cell below `minWidth`
+ * (`(fit+1)` cells at minWidth already overflow the width). `maxWidth`
+ * binds in the wrapping-flex idiom (`tileRungFlexProps`), where a tile can
+ * stop growing without forcing a new column.
+ *
+ * At the springboard's own numbers this reproduces the launcher's split:
+ * `xs` (104) with the 8px launcher gutter yields 6 columns at the 700px
+ * wide-breakpoint and 4 in the phone band.
+ */
+export declare function tileColumnsForWidth(width: number, stop: TileSizeStop, gutter?: number): number;
+/**
+ * Named media aspect ratios (width / height). A skeleton twin drawn at the
+ * wrong aspect produces the exact layout jump it exists to prevent
+ * (ImageGrid hardcoded 1; Lookout frames are 16:10).
+ */
+export declare const mediaAspectRatios: {
+    /** Album art, avatars, icon plates. */
+    readonly square: 1;
+    /** Stills cameras, 4:3. */
+    readonly photo: number;
+    /** Desktop screen captures, 16:10 — the Lookout frame shape. */
+    readonly screen: number;
+    /** Video stills, 16:9. */
+    readonly video: number;
+    /** Portrait media, 3:4. */
+    readonly portrait: number;
+};
+export type MediaAspectName = keyof typeof mediaAspectRatios;
+/** A named aspect or an explicit width/height number. */
+export type MediaAspect = MediaAspectName | number;
+/** Resolve a name or number to a positive width/height ratio (default `square`). */
+export declare function resolveMediaAspect(aspect?: MediaAspect | null): number;
+//# sourceMappingURL=tileSizes.d.ts.map

package/types/theme/tileSizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileSizes.d.ts","sourceRoot":"","sources":["../../src/theme/tileSizes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,eAAO,MAAM,aAAa,yCAA0C,CAAC;AAErE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAIhE,MAAM,MAAM,cAAc,GAAG;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM9D,CAAC;AAeF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAM5D,CAAC;AAYF,eAAO,MAAM,qBAAqB,EAAE,cASnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAOnF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAiC3F;AAiBD,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAY7E;AAID,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAOvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,SAAI,GAAG,MAAM,CAGzF;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,uCAAuC;;IAEvC,2BAA2B;;IAE3B,gEAAgE;;IAEhE,0BAA0B;;IAE1B,2BAA2B;;CAEnB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE7D,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;AAEnD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAMtE"}