@gjsify/adwaita-core 0.64.33-next.323 → 0.64.34

package/lib/esm/app-scale.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const e=360,t=1,n=1.5,r=600;function clampAppScale(e){return Number.isFinite(e)?Math.round(Math.min(n,Math.max(1,e))*1e3)/1e3:1}function deriveAppScale(e){let t=Math.min(e.widthDips,e.heightDips);return!Number.isFinite(t)||t<=0||t>=600?1:clampAppScale(t/360)}function resolveAppScale(e,t){return clampAppScale(e===`auto`?t:e)}function scaleDip(e,t){return!Number.isFinite(e)||!Number.isFinite(t)?e:Math.round(e*t*1e3)/1e3}function appScaleChoices(e=.1){let t=Number.isFinite(e)&&e>0?e:.1,r=Math.floor((n-1)/t+1e-9),i=[];for(let e=0;e<=r;e++)i.push(clampAppScale(1+e*t));return i[i.length-1]!==1.5&&i.push(n),i}function parseAppScaleSetting(e){if(typeof e==`number`)return clampAppScale(e);if(typeof e==`string`&&e.trim()!==``&&e!==`auto`){let t=Number(e);if(Number.isFinite(t))return clampAppScale(t)}return`auto`}export{n as APP_SCALE_MAX,t as APP_SCALE_MIN,e as APP_SCALE_REFERENCE_WIDTH,r as APP_SCALE_WIDE_WIDTH,appScaleChoices,clampAppScale,deriveAppScale,parseAppScaleSetting,resolveAppScale,scaleDip};

package/lib/esm/css-length.js

@@ -1 +1,2 @@
-import"./_virtual/_rolldown/runtime.js";const e=String.raw`\/\*[\s\S]*?\*\/|"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|url\([^)]*\)`,t=String.raw`(?<![\w.#-])([+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?)px(?![\w-])`;function cssPxToDip(n){return n.replace(RegExp(`${e}|${t}`,`gi`),(e,t)=>t===void 0?e:t)}export{cssPxToDip};
+import"./_virtual/_rolldown/runtime.js";const e=String.raw`\/\*[\s\S]*?\*\/|"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|url\([^)]*\)`,t=String.raw`(?<![\w.#-])([+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?)px(?![\w-])`;function cssPxToDip(n){return n.replace(RegExp(`${e}|${t}`,`gi`),(e,t)=>t===void 0?e:t)}const n=`font-size.line-height.margin.margin-top.margin-right.margin-bottom.margin-left.padding.padding-top.padding-right.padding-bottom.padding-left.width.height.min-width.min-height.border-radius.border-top-left-radius.border-top-right-radius.border-bottom-right-radius.border-bottom-left-radius.border-width.border-top-width.border-right-width.border-bottom-width.border-left-width`.split(`.`),r=new Set(n),i=String.raw`(?<![\w.#-])([+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?)(px)?(?![\w%.-])`;function roundLength(e){return String(Math.round(e*1e3)/1e3)}function scaleLengthValue(t,n){let r=!1;return{text:t.replace(RegExp(`${e}|${i}`,`gi`),(e,t,i)=>t===void 0?e:(r=!0,`${roundLength(Number(t)*n)}${i??``}`)),scaled:r}}function stripComments(e){return e.replace(/\/\*[\s\S]*?\*\//g,` `)}function closingBrace(e,t){let n=0;for(let r=t;r<e.length;r++){let t=e[r];if(t===`/`&&e[r+1]===`*`){let t=e.indexOf(`*/`,r+2);r=t===-1?e.length:t+1}else if(t===`"`||t===`'`)for(r++;r<e.length&&e[r]!==t;r++)e[r]===`\\`&&r++;else if(t===`{`)n++;else if(t===`}`&&--n===0)return r+1}return e.length}function splitDeclarations(e){let t=[],n=0,r=0;for(let i=0;i<e.length;i++){let a=e[i];if(a===`/`&&e[i+1]===`*`){let t=e.indexOf(`*/`,i+2);i=t===-1?e.length:t+1}else if(a===`"`||a===`'`)for(i++;i<e.length&&e[i]!==a;i++)e[i]===`\\`&&i++;else a===`(`?n++:a===`)`?n--:a===`;`&&n===0&&(t.push(e.slice(r,i)),r=i+1)}return t.push(e.slice(r)),t}function scaleDeclarations(e,t){let n=[];for(let i of splitDeclarations(e)){let e=stripComments(i),a=e.indexOf(`:`);if(a===-1)continue;let o=e.slice(0,a).trim().toLowerCase();if(!r.has(o))continue;let{text:s,scaled:c}=scaleLengthValue(e.slice(a+1),t);c&&n.push(`${o}:${s.replace(/\s+$/,``)}`)}return n.join(`; `)}function scaleAdwaitaCss(e,t){if(!Number.isFinite(t)||t<=0)return``;let n=[],r=0;for(let i=0;i<e.length;i++){let a=e[i];if(a===`/`&&e[i+1]===`*`){let t=e.indexOf(`*/`,i+2);i=t===-1?e.length:t+1}else if(a===`"`||a===`'`)for(i++;i<e.length&&e[i]!==a;i++)e[i]===`\\`&&i++;else if(a===`;`)r=i+1;else if(a===`{`){let a=closingBrace(e,i),o=stripComments(e.slice(r,i)).trim(),s=e.slice(i+1,a-1);if(o.startsWith(`@`)){let e=/^@[\w-]*/.exec(o)?.[0].toLowerCase();if(e===`@media`||e===`@supports`){let e=scaleAdwaitaCss(s,t);e!==``&&n.push(`${o} { ${e} }`)}}else if(o!==``){let e=scaleDeclarations(s,t);e!==``&&n.push(`${o} { ${e} }`)}i=a-1,r=a}}return n.join(`
+`)}export{n as SCALED_CSS_PROPERTIES,cssPxToDip,scaleAdwaitaCss};

package/lib/types/app-scale.d.ts

@@ -0,0 +1,47 @@
+/** What the interface scale is set to: a factor, or `'auto'` for the one derived from the screen. */
+export type AppScaleSetting = 'auto' | number;
+/** The logical width a libadwaita stylesheet is authored for. */
+export declare const APP_SCALE_REFERENCE_WIDTH = 360;
+/** The authored size. Below it the app would be smaller than the stylesheet means it to be. */
+export declare const APP_SCALE_MIN = 1;
+/** Past this a phone layout no longer fits the breakpoints it declares. */
+export declare const APP_SCALE_MAX = 1.5;
+/** Android's `sw600dp`: at or above this shortest edge the window is wide enough as authored. */
+export declare const APP_SCALE_WIDE_WIDTH = 600;
+/** The screen the scale is derived from, in device-independent pixels. */
+export interface AppScaleScreen {
+    readonly widthDips: number;
+    readonly heightDips: number;
+}
+/** `scale` held to `[APP_SCALE_MIN, APP_SCALE_MAX]` and three decimals; a non-number becomes 1. */
+export declare function clampAppScale(scale: number): number;
+/**
+ * The scale a screen asks for: its shortest edge over the authored width, clamped.
+ *
+ * The SHORTEST edge, so that turning the device does not resize the interface — a phone is a
+ * phone in landscape too. A screen at or past {@link APP_SCALE_WIDE_WIDTH} is left at 1.
+ */
+export declare function deriveAppScale(screen: AppScaleScreen): number;
+/** The factor to apply: the user's number when they set one, otherwise the derived default. */
+export declare function resolveAppScale(setting: AppScaleSetting, derived: number): number;
+/**
+ * A length the code sets itself, scaled — the counterpart to `scaleAdwaitaCss` for the sizes no
+ * stylesheet reaches: an icon's rendered square, a drag grip's height, an avatar's side.
+ *
+ * Rounded the way the CSS lengths are, so a constant and the rule drawn next to it agree. The
+ * scale is used as given, not clamped: it comes from `resolveAppScale`, which already clamped it.
+ *
+ * NOT for breakpoints. A width a layout DECIDES by (`sw600dp`, a dialog's max width, a carousel's
+ * fallback page) describes the screen, not the drawing on it, and scaling it would move the line
+ * the layout switches at.
+ */
+export declare function scaleDip(length: number, scale: number): number;
+/**
+ * The factors a chooser can offer, from {@link APP_SCALE_MIN} to {@link APP_SCALE_MAX}.
+ *
+ * Here rather than in the app, so a setting cannot offer a factor the clamp refuses: a list that
+ * went past the ceiling would show an entry that silently selects a different one.
+ */
+export declare function appScaleChoices(step?: number): number[];
+/** `'auto'`, or the clamped number — what a stored setting means after it is read back. */
+export declare function parseAppScaleSetting(value: unknown): AppScaleSetting;

package/lib/types/app-scale.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/css-length.d.ts

@@ -1,2 +1,24 @@
 /** `12px` -> `12`, `0 -4.5px` -> `0 -4.5`; everything else, and anything quoted or commented, as is. */
 export declare function cssPxToDip(css: string): string;
+/**
+ * The declarations an app scale multiplies: lengths, and nothing that only looks like one.
+ *
+ * `letter-spacing` is absent on purpose — NativeScript reads it as a multiple of the font size,
+ * so it already follows a scaled `font-size` and scaling it again would widen the tracking.
+ */
+export declare const SCALED_CSS_PROPERTIES: readonly string[];
+/**
+ * The override sheet that puts `scale` over every length of `css`.
+ *
+ * Style rules keep their selector; `@media` and `@supports` keep their condition, so a rule that
+ * only applies on a wide window still only applies there. `@keyframes`, `@font-face` and the
+ * other at-rules carry no layout length and are dropped. A rule left with no length declaration
+ * is dropped too, so the sheet is always a fraction of the one it came from.
+ *
+ * Pure, and length-only by construction: it can never clobber the append-only accent and named
+ * colour overrides (`widgets/named-colors-theme.ts`), because it emits no colour.
+ *
+ * @param css    a stylesheet whose `px` have already been dropped (see {@link cssPxToDip}).
+ * @param scale  the factor; `1` emits the original lengths, which is how a scale is taken back.
+ */
+export declare function scaleAdwaitaCss(css: string, scale: number): string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/adwaita-core",
-    "version": "0.64.33-next.323",
+    "version": "0.64.34",
     "description": "Headless Adwaita widget behavior (breakpoint condition grammar + apply/unapply state machine, color-scheme observable, avatar derivation) shared by the web and NativeScript Adwaita renderers — pure TS, no platform imports",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -33,6 +33,10 @@
         "./css-length": {
             "types": "./lib/types/css-length.d.ts",
             "default": "./lib/esm/css-length.js"
+        },
+        "./app-scale": {
+            "types": "./lib/types/app-scale.d.ts",
+            "default": "./lib/esm/app-scale.js"
         }
     },
     "files": [
@@ -71,9 +75,9 @@
         "headless"
     ],
     "devDependencies": {
-        "@gjsify/cli": "0.64.33-next.323",
+        "@gjsify/cli": "^0.64.34",
         "@gjsify/node-gi": "file:../../../packages/node-gi/node-gi",
-        "@gjsify/unit": "0.64.33-next.323",
+        "@gjsify/unit": "^0.64.34",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -96,6 +100,5 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-core#readme",
-    "gitHead": "603d30dc7b5600376fca2b715ecc154cc12b4b31"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/web/adwaita-core#readme"
 }