waybetter 0.1.1 → 0.7.0

package/dist/runtime/featureTable.d.ts

@@ -0,0 +1,144 @@
+/** Flags a store may hold (the native cap, waybetter-host `settings::MAX_FEATURES`). */
+export declare const FLAG_LIMIT = 256;
+/** Characters in a flag key (the native cap). */
+export declare const FLAG_KEY_LIMIT = 64;
+export type FeatureBacking = 'module' | 'app' | 'plugin';
+export type FeatureSpec = {
+    /** The flag key. Existing names stay as they are; new ones are `<area>.<feature>`. */
+    id: string;
+    /** The owning area, or null for a core flag. */
+    area: string | null;
+    /** The rows it is listed with inside its card (words: `features.group.<group>`). */
+    group?: string;
+    /** Its value when nothing is stored. */
+    default: boolean;
+    /**
+     * Where its code lives: `module` = a feature module (featureModules.ts); `app` = a part of the
+     * app runtime that installs on the flag; `plugin` = an old plugin file until it is ported.
+     */
+    backing: FeatureBacking;
+    /** `backing: 'plugin'`: that file. Its enabled state is the switch; `id` is the flag it becomes. */
+    file?: string;
+    /** The old plugin file this feature replaces: the one-time migration turns its enabled state into this flag. */
+    supersedes?: string;
+    /** Surfaces it runs on (ids from the app's surface classifier); omitted = every page. */
+    surfaces?: readonly string[];
+    /** Also runs on the site's heavy pages (domHub `heavyPath`). */
+    heavy?: boolean;
+    /** Catalog key of its label (default `features.<id>.label`). */
+    label?: string;
+    /** Catalog key of its description (default `features.<id>.description`). */
+    description?: string;
+    /** It has settings of its own (a settings schema on its module): the card offers "Settings". */
+    settings?: boolean;
+    /** Extra words the panel search matches (an old plugin's name). */
+    keywords?: string;
+    /** The gated plugin API it uses (shown on the card). */
+    permissions?: readonly string[];
+};
+export type AreaSpec = {
+    /** `navigation`: lowercase letters, digits and `-`. */
+    id: string;
+    /** The card's name: a product name, the same in every language. */
+    name: string;
+    /** Catalog key of the card's description. */
+    description: string;
+    /** A 16x16 stroke path for the card's icon. */
+    icon?: string;
+    /**
+     * The owner of its palette commands and the file it ships as once it is a plugin file
+     * (`bt-navigation-plus.plugin.js`). A valid plugin file name.
+     */
+    owner: string;
+    /** Its words in the page: `plugin.<namespace>.*` (`navigation-plus`). */
+    namespace: string;
+};
+export type ModeSpec = {
+    id: string;
+    /** Catalog keys of its name and one-line description. */
+    name: string;
+    description: string;
+    /** The preselected one on the first-run screen. */
+    recommended?: boolean;
+    /** Flag values that differ from the table's defaults. */
+    flags: Readonly<Record<string, boolean>>;
+};
+export type FeatureTable = {
+    areas: readonly AreaSpec[];
+    features: readonly FeatureSpec[];
+    modes: readonly ModeSpec[];
+};
+export type Flags = Record<string, boolean>;
+/** The flag that is an area's master switch. */
+export declare const areaFlag: (area: string) => string;
+/** Features that are flags (everything but the ones still backed by an old plugin file). */
+export declare const flagFeatures: (table: FeatureTable) => FeatureSpec[];
+export declare const areaFeatures: (table: FeatureTable, area: string) => FeatureSpec[];
+export declare const coreFeatures: (table: FeatureTable) => FeatureSpec[];
+/** The catalog keys of a feature's label and description. */
+export declare function featureWords(feature: FeatureSpec): {
+    label: string;
+    description: string;
+};
+/** Every flag with its default: the features that are flags, and each area's switch (on). */
+export declare function tableDefaults(table: FeatureTable): Flags;
+/** The full flag map for `input`: unknown keys are dropped, anything not a boolean takes the default. */
+export declare function normalizeFlags(table: FeatureTable, input: unknown): Flags;
+/** What is stored: only the flags whose value differs from the default. */
+export declare function sparseFlags(table: FeatureTable, flags: Readonly<Record<string, unknown>>): Flags;
+/**
+ * What runs: a feature owned by an area is off while that area's switch is off. Core flags and the
+ * area switches themselves pass through.
+ */
+export declare function effectiveFlags(table: FeatureTable, flags: Readonly<Flags>): Flags;
+export declare const modeById: (table: FeatureTable, id: string | null | undefined) => ModeSpec | null;
+/** The full flag map a mode starts from (an unknown or null mode: the defaults). */
+export declare function modeFlags(table: FeatureTable, mode: string | null | undefined): Flags;
+/** The flags whose value is not what `mode` starts from: the owner's own changes. */
+export declare function manualChanges(table: FeatureTable, flags: Readonly<Flags>, mode: string | null | undefined): string[];
+/**
+ * The flags after choosing mode `to` while on mode `from` (null = never chosen). `keep`: the
+ * owner's own changes (whatever differs from `from`) stay on top of the new mode; otherwise the
+ * new mode's values apply as they are.
+ */
+export declare function switchMode(table: FeatureTable, flags: Readonly<Flags>, from: string | null | undefined, to: string, keep: boolean): Flags;
+export type ModeStatus = {
+    /** The flags differ from what the mode starts from: "Custom (based on <mode>)". */
+    custom: boolean;
+    /** What applying the mode again would turn on and off (flag ids, in table order). */
+    on: string[];
+    off: string[];
+    /**
+     * Of those, the ones the mode gained since it was applied (an update made its preset larger).
+     * Empty when nothing is known about the preset of that time.
+     */
+    added: string[];
+};
+/**
+ * How the stored flags relate to mode `mode` (null or unknown: no mode, nothing to say). A mode is
+ * a starting point: nothing here applies anything. `applied` is the mode's `flags` as they were
+ * when it was applied (the shell stores it with the choice); without it a difference is simply the
+ * owner's own change.
+ */
+export declare function modeStatus(table: FeatureTable, flags: Readonly<Flags>, mode: string | null | undefined, applied?: Readonly<Record<string, boolean>> | null): ModeStatus;
+/**
+ * Feature health, as the panel learns it. A feature that paused itself (featureModules.ts: its
+ * selector probes failed) is named by its area's `health` palette command in the page: the entry
+ * opens the notes there, and its keywords carry the paused flags. The panel reads the focused
+ * tab's command list (it already has it for the palette), so no new report crosses to the host.
+ */
+export declare const HEALTH_COMMAND = "health";
+/** The keywords of an area's health command: the paused flags of that area. */
+export declare const healthKeywords: (ids: readonly string[]) => string;
+/** The flags of `table` a tab's reported commands say are paused (unknown words are ignored). */
+export declare function pausedFeatures(table: FeatureTable, commands: ReadonlyArray<{
+    id: string;
+    keywords?: string;
+}> | null | undefined): Set<string>;
+/** The old plugin files the table's features replace, for the app's native migration list. */
+export declare function supersededFiles(table: FeatureTable): {
+    file: string;
+    flag: string;
+}[];
+/** Problems in a table (an empty list: valid). Run it in the app's tests. */
+export declare function validateTable(table: FeatureTable): string[];

package/dist/runtime/featureTable.js

@@ -0,0 +1,223 @@
+// The feature table: one data description of everything an app lets its owner switch, shared by the
+// page runtime (which flags exist, who owns them), the panel (the area cards, the Fixes list, the
+// onboarding modes) and the app's native side (the migration list it generates from it). Pure data
+// and pure functions: no DOM, no storage.
+//
+// - An AREA is one card in the Plugins list ("Navigation+"): a master switch and the features it
+//   owns. Its switch is the flag `area.<id>`.
+// - A FEATURE is one on/off flag. It belongs to an area, or to nobody (`area: null`: a core flag
+//   such as a reliability fix, which no plugin switch can turn off). Where its code lives is its
+//   `backing`: a feature module in the registry (featureModules.ts), a part of the app runtime
+//   (request hubs, native commands, document-start timing), or an old plugin file that has not
+//   been ported yet (then it is not a flag at all: its switch is that file's enabled state).
+// - A MODE is a preset (Basic / Advanced / Power User): the flag values it starts from. A mode is a
+//   starting point, not a lock: every flag stays individually switchable afterwards.
+//
+// Flags are stored sparsely (`sparseFlags`): only values that differ from the table's defaults.
+/** Flags a store may hold (the native cap, waybetter-host `settings::MAX_FEATURES`). */
+export const FLAG_LIMIT = 256;
+/** Characters in a flag key (the native cap). */
+export const FLAG_KEY_LIMIT = 64;
+/** The flag that is an area's master switch. */
+export const areaFlag = (area) => `area.${area}`;
+/** Features that are flags (everything but the ones still backed by an old plugin file). */
+export const flagFeatures = (table) => table.features.filter(feature => feature.backing !== 'plugin');
+export const areaFeatures = (table, area) => table.features.filter(feature => feature.area === area);
+export const coreFeatures = (table) => table.features.filter(feature => feature.area === null);
+/** The catalog keys of a feature's label and description. */
+export function featureWords(feature) {
+    return { label: feature.label ?? `features.${feature.id}.label`, description: feature.description ?? `features.${feature.id}.description` };
+}
+/** Every flag with its default: the features that are flags, and each area's switch (on). */
+export function tableDefaults(table) {
+    const out = {};
+    for (const feature of flagFeatures(table))
+        out[feature.id] = feature.default;
+    for (const area of table.areas)
+        out[areaFlag(area.id)] = true;
+    return out;
+}
+/** The full flag map for `input`: unknown keys are dropped, anything not a boolean takes the default. */
+export function normalizeFlags(table, input) {
+    const source = input && typeof input === 'object' ? input : {};
+    const out = tableDefaults(table);
+    for (const key of Object.keys(out))
+        if (typeof source[key] === 'boolean')
+            out[key] = source[key];
+    return out;
+}
+/** What is stored: only the flags whose value differs from the default. */
+export function sparseFlags(table, flags) {
+    const defaults = tableDefaults(table);
+    const out = {};
+    for (const [key, fallback] of Object.entries(defaults)) {
+        const value = flags[key];
+        if (typeof value === 'boolean' && value !== fallback)
+            out[key] = value;
+    }
+    return out;
+}
+/**
+ * What runs: a feature owned by an area is off while that area's switch is off. Core flags and the
+ * area switches themselves pass through.
+ */
+export function effectiveFlags(table, flags) {
+    const out = { ...flags };
+    for (const feature of flagFeatures(table)) {
+        if (feature.area !== null && flags[areaFlag(feature.area)] === false)
+            out[feature.id] = false;
+    }
+    return out;
+}
+export const modeById = (table, id) => table.modes.find(mode => mode.id === id) ?? null;
+/** The full flag map a mode starts from (an unknown or null mode: the defaults). */
+export function modeFlags(table, mode) {
+    const out = tableDefaults(table);
+    const preset = modeById(table, mode)?.flags ?? {};
+    for (const [key, value] of Object.entries(preset))
+        if (key in out)
+            out[key] = value;
+    return out;
+}
+/** The flags whose value is not what `mode` starts from: the owner's own changes. */
+export function manualChanges(table, flags, mode) {
+    const preset = modeFlags(table, mode);
+    return Object.keys(preset).filter(key => typeof flags[key] === 'boolean' && flags[key] !== preset[key]);
+}
+/**
+ * The flags after choosing mode `to` while on mode `from` (null = never chosen). `keep`: the
+ * owner's own changes (whatever differs from `from`) stay on top of the new mode; otherwise the
+ * new mode's values apply as they are.
+ */
+export function switchMode(table, flags, from, to, keep) {
+    const next = modeFlags(table, to);
+    if (keep)
+        for (const key of manualChanges(table, flags, from))
+            next[key] = flags[key];
+    return next;
+}
+/**
+ * How the stored flags relate to mode `mode` (null or unknown: no mode, nothing to say). A mode is
+ * a starting point: nothing here applies anything. `applied` is the mode's `flags` as they were
+ * when it was applied (the shell stores it with the choice); without it a difference is simply the
+ * owner's own change.
+ */
+export function modeStatus(table, flags, mode, applied) {
+    const spec = modeById(table, mode);
+    if (!spec)
+        return { custom: false, on: [], off: [], added: [] };
+    const preset = modeFlags(table, spec.id);
+    const defaults = tableDefaults(table);
+    const differs = Object.keys(preset).filter(key => typeof flags[key] === 'boolean' && flags[key] !== preset[key]);
+    const was = (key) => typeof applied?.[key] === 'boolean' ? applied[key] : defaults[key];
+    return {
+        custom: differs.length > 0,
+        on: differs.filter(key => preset[key]),
+        off: differs.filter(key => !preset[key]),
+        added: applied ? differs.filter(key => was(key) !== preset[key]) : [],
+    };
+}
+/**
+ * Feature health, as the panel learns it. A feature that paused itself (featureModules.ts: its
+ * selector probes failed) is named by its area's `health` palette command in the page: the entry
+ * opens the notes there, and its keywords carry the paused flags. The panel reads the focused
+ * tab's command list (it already has it for the palette), so no new report crosses to the host.
+ */
+export const HEALTH_COMMAND = 'health';
+const HEALTH_WORD = 'paused';
+/** The keywords of an area's health command: the paused flags of that area. */
+export const healthKeywords = (ids) => [HEALTH_WORD, ...ids].join(' ');
+/** The flags of `table` a tab's reported commands say are paused (unknown words are ignored). */
+export function pausedFeatures(table, commands) {
+    const paused = new Set();
+    for (const area of table.areas) {
+        const words = commands?.find(command => command.id === `${area.owner}:${HEALTH_COMMAND}`)?.keywords?.split(' ') ?? [];
+        if (words[0] !== HEALTH_WORD)
+            continue;
+        for (const feature of table.features)
+            if (feature.area === area.id && words.includes(feature.id))
+                paused.add(feature.id);
+    }
+    return paused;
+}
+/** The old plugin files the table's features replace, for the app's native migration list. */
+export function supersededFiles(table) {
+    return table.features.filter(feature => feature.supersedes && feature.backing !== 'plugin').map(feature => ({ file: feature.supersedes, flag: feature.id }));
+}
+const FLAG_ID = /^[A-Za-z][A-Za-z0-9]*(?:\.[A-Za-z][A-Za-z0-9]*)?$/;
+const AREA_ID = /^[a-z][a-z0-9-]{0,31}$/;
+const MODE_ID = /^[a-z][a-z0-9-]{0,31}$/;
+const PLUGIN_FILE = /^[A-Za-z0-9_\- ][A-Za-z0-9_.\- ]{0,117}\.plugin\.js$/;
+/** Problems in a table (an empty list: valid). Run it in the app's tests. */
+export function validateTable(table) {
+    const problems = [];
+    const areas = new Set();
+    for (const area of table.areas) {
+        if (!AREA_ID.test(area.id))
+            problems.push(`area ${JSON.stringify(area.id)}: invalid id`);
+        if (areas.has(area.id))
+            problems.push(`area ${area.id}: listed twice`);
+        areas.add(area.id);
+        if (!PLUGIN_FILE.test(area.owner))
+            problems.push(`area ${area.id}: owner must be a plugin file name`);
+        if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(area.namespace))
+            problems.push(`area ${area.id}: invalid namespace`);
+        if (!area.name.trim() || !area.description.trim())
+            problems.push(`area ${area.id}: name and description are required`);
+    }
+    const ids = new Set();
+    const files = new Set();
+    for (const feature of table.features) {
+        if (!FLAG_ID.test(feature.id) || feature.id.length > FLAG_KEY_LIMIT)
+            problems.push(`feature ${JSON.stringify(feature.id)}: invalid id`);
+        if (feature.id.startsWith('area.'))
+            problems.push(`feature ${feature.id}: "area." is kept for the area switches`);
+        if (ids.has(feature.id))
+            problems.push(`feature ${feature.id}: owned twice`);
+        ids.add(feature.id);
+        if (feature.area !== null && !areas.has(feature.area))
+            problems.push(`feature ${feature.id}: unknown area ${feature.area}`);
+        if (feature.backing === 'plugin') {
+            if (!feature.file || !PLUGIN_FILE.test(feature.file))
+                problems.push(`feature ${feature.id}: a plugin-backed feature names its file`);
+            if (feature.area === null)
+                problems.push(`feature ${feature.id}: a plugin-backed feature belongs to an area`);
+            if (feature.default)
+                problems.push(`feature ${feature.id}: a plugin file is off until its owner turns it on`);
+        }
+        else if (feature.file)
+            problems.push(`feature ${feature.id}: only a plugin-backed feature names a file`);
+        for (const file of [feature.file, feature.supersedes]) {
+            if (!file)
+                continue;
+            if (!PLUGIN_FILE.test(file))
+                problems.push(`feature ${feature.id}: invalid file ${JSON.stringify(file)}`);
+            if (files.has(file))
+                problems.push(`feature ${feature.id}: ${file} is named twice`);
+            files.add(file);
+        }
+        if (feature.backing !== 'module' && feature.settings)
+            problems.push(`feature ${feature.id}: only a feature module has a settings schema`);
+    }
+    const defaults = tableDefaults(table);
+    if (Object.keys(defaults).length > FLAG_LIMIT)
+        problems.push(`${Object.keys(defaults).length} flags: at most ${FLAG_LIMIT}`);
+    const modes = new Set();
+    for (const mode of table.modes) {
+        if (!MODE_ID.test(mode.id))
+            problems.push(`mode ${JSON.stringify(mode.id)}: invalid id`);
+        if (modes.has(mode.id))
+            problems.push(`mode ${mode.id}: listed twice`);
+        modes.add(mode.id);
+        for (const [key, value] of Object.entries(mode.flags)) {
+            if (!(key in defaults))
+                problems.push(`mode ${mode.id}: unknown flag ${key}`);
+            else if (value === defaults[key])
+                problems.push(`mode ${mode.id}: ${key} is already the default`);
+        }
+    }
+    if (table.modes.length && table.modes.filter(mode => mode.recommended).length !== 1)
+        problems.push('exactly one mode is the recommended one');
+    return problems;
+}
+//# sourceMappingURL=featureTable.js.map

package/dist/runtime/featureTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureTable.js","sourceRoot":"","sources":["../../../runtime/src/featureTable.ts"],"names":[],"mappings":"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","sourcesContent":["// The feature table: one data description of everything an app lets its owner switch, shared by the\n// page runtime (which flags exist, who owns them), the panel (the area cards, the Fixes list, the\n// onboarding modes) and the app's native side (the migration list it generates from it). Pure data\n// and pure functions: no DOM, no storage.\n//\n// - An AREA is one card in the Plugins list (\"Navigation+\"): a master switch and the features it\n//   owns. Its switch is the flag `area.<id>`.\n// - A FEATURE is one on/off flag. It belongs to an area, or to nobody (`area: null`: a core flag\n//   such as a reliability fix, which no plugin switch can turn off). Where its code lives is its\n//   `backing`: a feature module in the registry (featureModules.ts), a part of the app runtime\n//   (request hubs, native commands, document-start timing), or an old plugin file that has not\n//   been ported yet (then it is not a flag at all: its switch is that file's enabled state).\n// - A MODE is a preset (Basic / Advanced / Power User): the flag values it starts from. A mode is a\n//   starting point, not a lock: every flag stays individually switchable afterwards.\n//\n// Flags are stored sparsely (`sparseFlags`): only values that differ from the table's defaults.\n\n/** Flags a store may hold (the native cap, waybetter-host `settings::MAX_FEATURES`). */\nexport const FLAG_LIMIT = 256;\n/** Characters in a flag key (the native cap). */\nexport const FLAG_KEY_LIMIT = 64;\n\nexport type FeatureBacking = 'module' | 'app' | 'plugin';\n\nexport type FeatureSpec = {\n  /** The flag key. Existing names stay as they are; new ones are `<area>.<feature>`. */\n  id: string;\n  /** The owning area, or null for a core flag. */\n  area: string | null;\n  /** The rows it is listed with inside its card (words: `features.group.<group>`). */\n  group?: string;\n  /** Its value when nothing is stored. */\n  default: boolean;\n  /**\n   * Where its code lives: `module` = a feature module (featureModules.ts); `app` = a part of the\n   * app runtime that installs on the flag; `plugin` = an old plugin file until it is ported.\n   */\n  backing: FeatureBacking;\n  /** `backing: 'plugin'`: that file. Its enabled state is the switch; `id` is the flag it becomes. */\n  file?: string;\n  /** The old plugin file this feature replaces: the one-time migration turns its enabled state into this flag. */\n  supersedes?: string;\n  /** Surfaces it runs on (ids from the app's surface classifier); omitted = every page. */\n  surfaces?: readonly string[];\n  /** Also runs on the site's heavy pages (domHub `heavyPath`). */\n  heavy?: boolean;\n  /** Catalog key of its label (default `features.<id>.label`). */\n  label?: string;\n  /** Catalog key of its description (default `features.<id>.description`). */\n  description?: string;\n  /** It has settings of its own (a settings schema on its module): the card offers \"Settings\". */\n  settings?: boolean;\n  /** Extra words the panel search matches (an old plugin's name). */\n  keywords?: string;\n  /** The gated plugin API it uses (shown on the card). */\n  permissions?: readonly string[];\n};\n\nexport type AreaSpec = {\n  /** `navigation`: lowercase letters, digits and `-`. */\n  id: string;\n  /** The card's name: a product name, the same in every language. */\n  name: string;\n  /** Catalog key of the card's description. */\n  description: string;\n  /** A 16x16 stroke path for the card's icon. */\n  icon?: string;\n  /**\n   * The owner of its palette commands and the file it ships as once it is a plugin file\n   * (`bt-navigation-plus.plugin.js`). A valid plugin file name.\n   */\n  owner: string;\n  /** Its words in the page: `plugin.<namespace>.*` (`navigation-plus`). */\n  namespace: string;\n};\n\nexport type ModeSpec = {\n  id: string;\n  /** Catalog keys of its name and one-line description. */\n  name: string;\n  description: string;\n  /** The preselected one on the first-run screen. */\n  recommended?: boolean;\n  /** Flag values that differ from the table's defaults. */\n  flags: Readonly<Record<string, boolean>>;\n};\n\nexport type FeatureTable = {\n  areas: readonly AreaSpec[];\n  features: readonly FeatureSpec[];\n  modes: readonly ModeSpec[];\n};\n\nexport type Flags = Record<string, boolean>;\n\n/** The flag that is an area's master switch. */\nexport const areaFlag = (area: string) => `area.${area}`;\n\n/** Features that are flags (everything but the ones still backed by an old plugin file). */\nexport const flagFeatures = (table: FeatureTable) => table.features.filter(feature => feature.backing !== 'plugin');\n\nexport const areaFeatures = (table: FeatureTable, area: string) => table.features.filter(feature => feature.area === area);\nexport const coreFeatures = (table: FeatureTable) => table.features.filter(feature => feature.area === null);\n\n/** The catalog keys of a feature's label and description. */\nexport function featureWords(feature: FeatureSpec): { label: string; description: string } {\n  return { label: feature.label ?? `features.${feature.id}.label`, description: feature.description ?? `features.${feature.id}.description` };\n}\n\n/** Every flag with its default: the features that are flags, and each area's switch (on). */\nexport function tableDefaults(table: FeatureTable): Flags {\n  const out: Flags = {};\n  for (const feature of flagFeatures(table)) out[feature.id] = feature.default;\n  for (const area of table.areas) out[areaFlag(area.id)] = true;\n  return out;\n}\n\n/** The full flag map for `input`: unknown keys are dropped, anything not a boolean takes the default. */\nexport function normalizeFlags(table: FeatureTable, input: unknown): Flags {\n  const source = input && typeof input === 'object' ? input as Record<string, unknown> : {};\n  const out = tableDefaults(table);\n  for (const key of Object.keys(out)) if (typeof source[key] === 'boolean') out[key] = source[key] as boolean;\n  return out;\n}\n\n/** What is stored: only the flags whose value differs from the default. */\nexport function sparseFlags(table: FeatureTable, flags: Readonly<Record<string, unknown>>): Flags {\n  const defaults = tableDefaults(table);\n  const out: Flags = {};\n  for (const [key, fallback] of Object.entries(defaults)) {\n    const value = flags[key];\n    if (typeof value === 'boolean' && value !== fallback) out[key] = value;\n  }\n  return out;\n}\n\n/**\n * What runs: a feature owned by an area is off while that area's switch is off. Core flags and the\n * area switches themselves pass through.\n */\nexport function effectiveFlags(table: FeatureTable, flags: Readonly<Flags>): Flags {\n  const out: Flags = { ...flags };\n  for (const feature of flagFeatures(table)) {\n    if (feature.area !== null && flags[areaFlag(feature.area)] === false) out[feature.id] = false;\n  }\n  return out;\n}\n\nexport const modeById = (table: FeatureTable, id: string | null | undefined) => table.modes.find(mode => mode.id === id) ?? null;\n\n/** The full flag map a mode starts from (an unknown or null mode: the defaults). */\nexport function modeFlags(table: FeatureTable, mode: string | null | undefined): Flags {\n  const out = tableDefaults(table);\n  const preset = modeById(table, mode)?.flags ?? {};\n  for (const [key, value] of Object.entries(preset)) if (key in out) out[key] = value;\n  return out;\n}\n\n/** The flags whose value is not what `mode` starts from: the owner's own changes. */\nexport function manualChanges(table: FeatureTable, flags: Readonly<Flags>, mode: string | null | undefined): string[] {\n  const preset = modeFlags(table, mode);\n  return Object.keys(preset).filter(key => typeof flags[key] === 'boolean' && flags[key] !== preset[key]);\n}\n\n/**\n * The flags after choosing mode `to` while on mode `from` (null = never chosen). `keep`: the\n * owner's own changes (whatever differs from `from`) stay on top of the new mode; otherwise the\n * new mode's values apply as they are.\n */\nexport function switchMode(table: FeatureTable, flags: Readonly<Flags>, from: string | null | undefined, to: string, keep: boolean): Flags {\n  const next = modeFlags(table, to);\n  if (keep) for (const key of manualChanges(table, flags, from)) next[key] = flags[key]!;\n  return next;\n}\n\nexport type ModeStatus = {\n  /** The flags differ from what the mode starts from: \"Custom (based on <mode>)\". */\n  custom: boolean;\n  /** What applying the mode again would turn on and off (flag ids, in table order). */\n  on: string[];\n  off: string[];\n  /**\n   * Of those, the ones the mode gained since it was applied (an update made its preset larger).\n   * Empty when nothing is known about the preset of that time.\n   */\n  added: string[];\n};\n\n/**\n * How the stored flags relate to mode `mode` (null or unknown: no mode, nothing to say). A mode is\n * a starting point: nothing here applies anything. `applied` is the mode's `flags` as they were\n * when it was applied (the shell stores it with the choice); without it a difference is simply the\n * owner's own change.\n */\nexport function modeStatus(table: FeatureTable, flags: Readonly<Flags>, mode: string | null | undefined, applied?: Readonly<Record<string, boolean>> | null): ModeStatus {\n  const spec = modeById(table, mode);\n  if (!spec) return { custom: false, on: [], off: [], added: [] };\n  const preset = modeFlags(table, spec.id);\n  const defaults = tableDefaults(table);\n  const differs = Object.keys(preset).filter(key => typeof flags[key] === 'boolean' && flags[key] !== preset[key]);\n  const was = (key: string) => typeof applied?.[key] === 'boolean' ? applied[key] : defaults[key];\n  return {\n    custom: differs.length > 0,\n    on: differs.filter(key => preset[key]),\n    off: differs.filter(key => !preset[key]),\n    added: applied ? differs.filter(key => was(key) !== preset[key]) : [],\n  };\n}\n\n/**\n * Feature health, as the panel learns it. A feature that paused itself (featureModules.ts: its\n * selector probes failed) is named by its area's `health` palette command in the page: the entry\n * opens the notes there, and its keywords carry the paused flags. The panel reads the focused\n * tab's command list (it already has it for the palette), so no new report crosses to the host.\n */\nexport const HEALTH_COMMAND = 'health';\nconst HEALTH_WORD = 'paused';\n\n/** The keywords of an area's health command: the paused flags of that area. */\nexport const healthKeywords = (ids: readonly string[]) => [HEALTH_WORD, ...ids].join(' ');\n\n/** The flags of `table` a tab's reported commands say are paused (unknown words are ignored). */\nexport function pausedFeatures(table: FeatureTable, commands: ReadonlyArray<{ id: string; keywords?: string }> | null | undefined): Set<string> {\n  const paused = new Set<string>();\n  for (const area of table.areas) {\n    const words = commands?.find(command => command.id === `${area.owner}:${HEALTH_COMMAND}`)?.keywords?.split(' ') ?? [];\n    if (words[0] !== HEALTH_WORD) continue;\n    for (const feature of table.features) if (feature.area === area.id && words.includes(feature.id)) paused.add(feature.id);\n  }\n  return paused;\n}\n\n/** The old plugin files the table's features replace, for the app's native migration list. */\nexport function supersededFiles(table: FeatureTable): { file: string; flag: string }[] {\n  return table.features.filter(feature => feature.supersedes && feature.backing !== 'plugin').map(feature => ({ file: feature.supersedes!, flag: feature.id }));\n}\n\nconst FLAG_ID = /^[A-Za-z][A-Za-z0-9]*(?:\\.[A-Za-z][A-Za-z0-9]*)?$/;\nconst AREA_ID = /^[a-z][a-z0-9-]{0,31}$/;\nconst MODE_ID = /^[a-z][a-z0-9-]{0,31}$/;\nconst PLUGIN_FILE = /^[A-Za-z0-9_\\- ][A-Za-z0-9_.\\- ]{0,117}\\.plugin\\.js$/;\n\n/** Problems in a table (an empty list: valid). Run it in the app's tests. */\nexport function validateTable(table: FeatureTable): string[] {\n  const problems: string[] = [];\n  const areas = new Set<string>();\n  for (const area of table.areas) {\n    if (!AREA_ID.test(area.id)) problems.push(`area ${JSON.stringify(area.id)}: invalid id`);\n    if (areas.has(area.id)) problems.push(`area ${area.id}: listed twice`);\n    areas.add(area.id);\n    if (!PLUGIN_FILE.test(area.owner)) problems.push(`area ${area.id}: owner must be a plugin file name`);\n    if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(area.namespace)) problems.push(`area ${area.id}: invalid namespace`);\n    if (!area.name.trim() || !area.description.trim()) problems.push(`area ${area.id}: name and description are required`);\n  }\n  const ids = new Set<string>();\n  const files = new Set<string>();\n  for (const feature of table.features) {\n    if (!FLAG_ID.test(feature.id) || feature.id.length > FLAG_KEY_LIMIT) problems.push(`feature ${JSON.stringify(feature.id)}: invalid id`);\n    if (feature.id.startsWith('area.')) problems.push(`feature ${feature.id}: \"area.\" is kept for the area switches`);\n    if (ids.has(feature.id)) problems.push(`feature ${feature.id}: owned twice`);\n    ids.add(feature.id);\n    if (feature.area !== null && !areas.has(feature.area)) problems.push(`feature ${feature.id}: unknown area ${feature.area}`);\n    if (feature.backing === 'plugin') {\n      if (!feature.file || !PLUGIN_FILE.test(feature.file)) problems.push(`feature ${feature.id}: a plugin-backed feature names its file`);\n      if (feature.area === null) problems.push(`feature ${feature.id}: a plugin-backed feature belongs to an area`);\n      if (feature.default) problems.push(`feature ${feature.id}: a plugin file is off until its owner turns it on`);\n    } else if (feature.file) problems.push(`feature ${feature.id}: only a plugin-backed feature names a file`);\n    for (const file of [feature.file, feature.supersedes]) {\n      if (!file) continue;\n      if (!PLUGIN_FILE.test(file)) problems.push(`feature ${feature.id}: invalid file ${JSON.stringify(file)}`);\n      if (files.has(file)) problems.push(`feature ${feature.id}: ${file} is named twice`);\n      files.add(file);\n    }\n    if (feature.backing !== 'module' && feature.settings) problems.push(`feature ${feature.id}: only a feature module has a settings schema`);\n  }\n  const defaults = tableDefaults(table);\n  if (Object.keys(defaults).length > FLAG_LIMIT) problems.push(`${Object.keys(defaults).length} flags: at most ${FLAG_LIMIT}`);\n  const modes = new Set<string>();\n  for (const mode of table.modes) {\n    if (!MODE_ID.test(mode.id)) problems.push(`mode ${JSON.stringify(mode.id)}: invalid id`);\n    if (modes.has(mode.id)) problems.push(`mode ${mode.id}: listed twice`);\n    modes.add(mode.id);\n    for (const [key, value] of Object.entries(mode.flags)) {\n      if (!(key in defaults)) problems.push(`mode ${mode.id}: unknown flag ${key}`);\n      else if (value === defaults[key]) problems.push(`mode ${mode.id}: ${key} is already the default`);\n    }\n  }\n  if (table.modes.length && table.modes.filter(mode => mode.recommended).length !== 1) problems.push('exactly one mode is the recommended one');\n  return problems;\n}\n"]}

package/dist/runtime/fonts.d.ts

@@ -0,0 +1,22 @@
+/** Unicode ranges of the Latin and Latin Extended subsets (@fontsource file names `latin`, `latin-ext`). */
+export declare const LATIN_RANGE = "U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD";
+export declare const LATIN_EXT_RANGE = "U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF";
+/** A bundled family's files: base64 woff2 (variable, weights 100-900) with the unicode range each covers. */
+export type BundledFontFiles = Record<string, Array<[base64: string, unicodeRange: string]>>;
+/** Registers the bundled families `names` (BUNDLED_FONTS) from `files`, once per document. */
+export declare function loadBundledFonts(doc: Document, names: string[], files: BundledFontFiles): void;
+/**
+ * Google Fonts the owner downloaded: native code validates and caches the woff2 files and hands
+ * their bytes to site tabs whose theme uses them. The page never requests a font; each family is
+ * registered once per document (again only when its bytes change, e.g. after picking other weights).
+ */
+export type ProvidedFont = {
+    family: string;
+    faces: Array<{
+        weight: [number, number];
+        unicodeRange: string | null;
+        data: string;
+    }>;
+};
+/** Registers the provided families (validated again; at most 8 families of 24 faces); returns the families added. */
+export declare function provideFonts(doc: Document, fonts: unknown): string[];

package/dist/runtime/fonts.js

@@ -0,0 +1,72 @@
+// Theme fonts in a site's page. Sites usually block remote and `data:` font URLs (CSP `font-src`),
+// but a FontFace built from bytes performs no fetch, so bundled families (Geist and Geist Mono: the
+// app embeds their woff2 files in its page runtime) are registered only when a theme uses them, and
+// Google Fonts the owner downloaded arrive as bytes from native code (`provideFonts`).
+import { BUNDLED_FONTS } from "./themeSpec.js";
+/** Unicode ranges of the Latin and Latin Extended subsets (@fontsource file names `latin`, `latin-ext`). */
+export const LATIN_RANGE = 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD';
+export const LATIN_EXT_RANGE = 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF';
+const loaded = new WeakMap();
+const log = (family, error) => console.error(`[wayBetter] font ${family} failed`, error);
+/** Registers the bundled families `names` (BUNDLED_FONTS) from `files`, once per document. */
+export function loadBundledFonts(doc, names, files) {
+    let done = loaded.get(doc);
+    if (!done)
+        loaded.set(doc, done = new Set());
+    for (const name of names) {
+        const faces = files[name];
+        const family = BUNDLED_FONTS[name];
+        if (!faces || !family || done.has(name))
+            continue;
+        done.add(name);
+        for (const [base64, unicodeRange] of faces) {
+            const bytes = Uint8Array.from(atob(base64), char => char.charCodeAt(0));
+            const face = new FontFace(family, bytes.buffer, { weight: '100 900', style: 'normal', unicodeRange, display: 'swap' });
+            doc.fonts.add(face);
+            face.load().catch(error => log(name, error));
+        }
+    }
+}
+const provided = new WeakMap();
+const FAMILY = /^[A-Za-z0-9][A-Za-z0-9 ]{0,47}$/;
+/** Registers the provided families (validated again; at most 8 families of 24 faces); returns the families added. */
+export function provideFonts(doc, fonts) {
+    const added = [];
+    if (!Array.isArray(fonts))
+        return added;
+    let known = provided.get(doc);
+    if (!known)
+        provided.set(doc, known = new Map());
+    for (const font of fonts.slice(0, 8)) {
+        if (!font || typeof font.family !== 'string' || !FAMILY.test(font.family) || !Array.isArray(font.faces))
+            continue;
+        const key = font.faces.map(face => `${face?.weight}|${typeof face?.data === 'string' ? face.data.length : 0}`).join(',');
+        if (known.get(font.family) === key)
+            continue;
+        // Other weights of a family replace its earlier faces.
+        for (const face of [...doc.fonts])
+            if (face.family.replace(/"/g, '') === font.family && face.wbGoogle)
+                doc.fonts.delete(face);
+        known.set(font.family, key);
+        for (const face of font.faces.slice(0, 24)) {
+            if (!face || typeof face.data !== 'string' || !Array.isArray(face.weight))
+                continue;
+            try {
+                const bytes = Uint8Array.from(atob(face.data), char => char.charCodeAt(0));
+                const [min, max] = face.weight.map(Number);
+                const descriptors = { weight: min === max ? String(min) : `${min} ${max}`, style: 'normal', display: 'swap' };
+                if (typeof face.unicodeRange === 'string' && /^[U+0-9A-Fa-f?, -]{1,4000}$/.test(face.unicodeRange))
+                    descriptors.unicodeRange = face.unicodeRange;
+                const fontFace = Object.assign(new FontFace(font.family, bytes.buffer, descriptors), { wbGoogle: true });
+                doc.fonts.add(fontFace);
+                fontFace.load().catch(error => log(font.family, error));
+            }
+            catch (error) {
+                log(font.family, error);
+            }
+        }
+        added.push(font.family);
+    }
+    return added;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/runtime/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../../runtime/src/fonts.ts"],"names":[],"mappings":"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","sourcesContent":["// Theme fonts in a site's page. Sites usually block remote and `data:` font URLs (CSP `font-src`),\n// but a FontFace built from bytes performs no fetch, so bundled families (Geist and Geist Mono: the\n// app embeds their woff2 files in its page runtime) are registered only when a theme uses them, and\n// Google Fonts the owner downloaded arrive as bytes from native code (`provideFonts`).\n\nimport { BUNDLED_FONTS } from './themeSpec.ts';\n\n/** Unicode ranges of the Latin and Latin Extended subsets (@fontsource file names `latin`, `latin-ext`). */\nexport const LATIN_RANGE = 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD';\nexport const LATIN_EXT_RANGE = 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF';\n\n/** A bundled family's files: base64 woff2 (variable, weights 100-900) with the unicode range each covers. */\nexport type BundledFontFiles = Record<string, Array<[base64: string, unicodeRange: string]>>;\n\nconst loaded = new WeakMap<Document, Set<string>>();\nconst log = (family: string, error: unknown) => console.error(`[wayBetter] font ${family} failed`, error);\n\n/** Registers the bundled families `names` (BUNDLED_FONTS) from `files`, once per document. */\nexport function loadBundledFonts(doc: Document, names: string[], files: BundledFontFiles): void {\n  let done = loaded.get(doc);\n  if (!done) loaded.set(doc, done = new Set());\n  for (const name of names) {\n    const faces = files[name];\n    const family = BUNDLED_FONTS[name];\n    if (!faces || !family || done.has(name)) continue;\n    done.add(name);\n    for (const [base64, unicodeRange] of faces) {\n      const bytes = Uint8Array.from(atob(base64), char => char.charCodeAt(0));\n      const face = new FontFace(family, bytes.buffer, { weight: '100 900', style: 'normal', unicodeRange, display: 'swap' });\n      doc.fonts.add(face);\n      face.load().catch(error => log(name, error));\n    }\n  }\n}\n\n/**\n * Google Fonts the owner downloaded: native code validates and caches the woff2 files and hands\n * their bytes to site tabs whose theme uses them. The page never requests a font; each family is\n * registered once per document (again only when its bytes change, e.g. after picking other weights).\n */\nexport type ProvidedFont = { family: string; faces: Array<{ weight: [number, number]; unicodeRange: string | null; data: string }> };\nconst provided = new WeakMap<Document, Map<string, string>>();\nconst FAMILY = /^[A-Za-z0-9][A-Za-z0-9 ]{0,47}$/;\n\n/** Registers the provided families (validated again; at most 8 families of 24 faces); returns the families added. */\nexport function provideFonts(doc: Document, fonts: unknown): string[] {\n  const added: string[] = [];\n  if (!Array.isArray(fonts)) return added;\n  let known = provided.get(doc);\n  if (!known) provided.set(doc, known = new Map());\n  for (const font of fonts.slice(0, 8) as ProvidedFont[]) {\n    if (!font || typeof font.family !== 'string' || !FAMILY.test(font.family) || !Array.isArray(font.faces)) continue;\n    const key = font.faces.map(face => `${face?.weight}|${typeof face?.data === 'string' ? face.data.length : 0}`).join(',');\n    if (known.get(font.family) === key) continue;\n    // Other weights of a family replace its earlier faces.\n    for (const face of [...doc.fonts]) if ((face as FontFace).family.replace(/\"/g, '') === font.family && (face as FontFace & { wbGoogle?: boolean }).wbGoogle) doc.fonts.delete(face as FontFace);\n    known.set(font.family, key);\n    for (const face of font.faces.slice(0, 24)) {\n      if (!face || typeof face.data !== 'string' || !Array.isArray(face.weight)) continue;\n      try {\n        const bytes = Uint8Array.from(atob(face.data), char => char.charCodeAt(0));\n        const [min, max] = face.weight.map(Number) as [number, number];\n        const descriptors: FontFaceDescriptors = { weight: min === max ? String(min) : `${min} ${max}`, style: 'normal', display: 'swap' };\n        if (typeof face.unicodeRange === 'string' && /^[U+0-9A-Fa-f?, -]{1,4000}$/.test(face.unicodeRange)) descriptors.unicodeRange = face.unicodeRange;\n        const fontFace = Object.assign(new FontFace(font.family, bytes.buffer, descriptors), { wbGoogle: true });\n        doc.fonts.add(fontFace);\n        fontFace.load().catch(error => log(font.family, error));\n      } catch (error) { log(font.family, error); }\n    }\n    added.push(font.family);\n  }\n  return added;\n}\n"]}