@webround/core 0.3.2 → 0.3.3

package/dist/theme.d.ts

@@ -19,4 +19,10 @@ export declare function wrThemeHasDark(css: string): boolean;
 export declare function wrThemeStartsFromSystem(css: string): boolean;
 /** Whether the page's stylesheets have a `.dark` rule: the same definition as `wrThemeHasDark`, read from the page the visitor has (the toggle is only there when it can do something). */
 export declare function wrThemeSiteHasDark(doc: Document): boolean;
+/** The weights as they are written into the theme: only what is a weight, once each, in order; nothing left is `undefined` (Google's own default). */
+export declare function wrGoogleWeights(weights: string | undefined): string | undefined;
+/** The `family=…` part of the address of Google's stylesheet for one family: `family=Inter:wght@400;700`, and with an italic one `family=Inter:ital,wght@0,400;1,400`. */
+export declare function wrGoogleFamilyParam(family: string, weights?: string): string;
+/** The weights of a family in the address of a stylesheet (what follows the `:` of `family=Inter:ital,wght@0,400;1,400`), as the theme says them. */
+export declare function wrGoogleWeightsOfParam(axes: string | undefined): string | undefined;
 //# sourceMappingURL=theme.d.ts.map

package/dist/theme.js

@@ -42,4 +42,50 @@ export function wrThemeSiteHasDark(doc) {
         return false;
     } });
 }
+const GOOGLE_WEIGHT = /^(\d{1,4})(?:\.\.(\d{1,4}))?(i?)$/;
+function wrGoogleWeightsParsed(weights) {
+    const found = new Map();
+    for (const part of (weights ?? '').split(';')) {
+        const match = GOOGLE_WEIGHT.exec(part.trim());
+        if (!match)
+            continue;
+        const from = Number(match[1]);
+        const to = match[2] === undefined ? null : Number(match[2]);
+        if (from < 1 || from > 1000 || (to !== null && (to > 1000 || to < from)))
+            continue;
+        const weight = { from, to: to === from ? null : to, italic: match[3] === 'i' };
+        found.set(wrGoogleWeightText(weight), weight);
+    }
+    // Upright first, then italic, each by weight: the order Google asks for
+    return [...found.values()].sort((a, b) => Number(a.italic) - Number(b.italic) || a.from - b.from);
+}
+const wrGoogleWeightValue = ({ from, to }) => (to === null ? `${from}` : `${from}..${to}`);
+const wrGoogleWeightText = (weight) => `${wrGoogleWeightValue(weight)}${weight.italic ? 'i' : ''}`;
+/** The weights as they are written into the theme: only what is a weight, once each, in order; nothing left is `undefined` (Google's own default). */
+export function wrGoogleWeights(weights) {
+    const parsed = wrGoogleWeightsParsed(weights);
+    return parsed.length > 0 ? parsed.map(wrGoogleWeightText).join(';') : undefined;
+}
+/** The `family=…` part of the address of Google's stylesheet for one family: `family=Inter:wght@400;700`, and with an italic one `family=Inter:ital,wght@0,400;1,400`. */
+export function wrGoogleFamilyParam(family, weights) {
+    const name = encodeURIComponent(family.trim()).replace(/%20/g, '+');
+    const parsed = wrGoogleWeightsParsed(weights);
+    if (parsed.length === 0)
+        return `family=${name}`;
+    if (parsed.some(weight => weight.italic))
+        return `family=${name}:ital,wght@${parsed.map(weight => `${weight.italic ? 1 : 0},${wrGoogleWeightValue(weight)}`).join(';')}`;
+    return `family=${name}:wght@${parsed.map(wrGoogleWeightValue).join(';')}`;
+}
+/** The weights of a family in the address of a stylesheet (what follows the `:` of `family=Inter:ital,wght@0,400;1,400`), as the theme says them. */
+export function wrGoogleWeightsOfParam(axes) {
+    if (!axes)
+        return undefined;
+    if (axes.startsWith('wght@'))
+        return wrGoogleWeights(axes.slice('wght@'.length));
+    if (axes.startsWith('ital,wght@')) {
+        const parts = axes.slice('ital,wght@'.length).split(';').map(tuple => tuple.split(','));
+        return wrGoogleWeights(parts.map(([ital, value]) => `${value}${ital === '1' ? 'i' : ''}`).join(';'));
+    }
+    return undefined;
+}
 //# sourceMappingURL=theme.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@webround/core",
-    "version": "0.3.2",
+    "version": "0.3.3",
     "type": "module",
     "main": "./dist/index.js",
     "module": "./dist/index.js",