waybetter 0.1.1 → 0.6.0

package/dist/shell/storeModel.d.ts

@@ -0,0 +1,181 @@
+import { type StoreText } from './storeMessages.ts';
+import type { StringsInfo } from './stringPacksModel.ts';
+export type InstallKind = 'theme' | 'plugin' | 'strings';
+export type SourceKind = 'store' | 'link' | 'file';
+export type PermissionTone = 'plain' | 'warn' | 'ok';
+export type PermissionBadge = {
+    id: string;
+    label: string;
+    detail: string;
+    tone: PermissionTone;
+};
+/** A store catalog item (waybetter-host `CatalogItem`; the catalog format is documented in docs/STORE.md). */
+export type StoreItem = {
+    /** The wayBetter apps it is for; native code only hands an app its own items. */
+    apps?: string[];
+    kind: InstallKind;
+    id: string;
+    name: string;
+    author: string;
+    version: string;
+    description: string;
+    category: string;
+    tags: string[];
+    url: string;
+    file?: string;
+    sha256: string;
+    size: number;
+    preview?: string;
+    permissions?: string[] | null;
+    colors?: {
+        bg: string;
+        surface?: string;
+        text: string;
+        accent: string;
+    } | null;
+    /** String packs: the pack's language tag. */
+    language?: string;
+    /** Any kind: its licence and who made, translated or reviewed it. */
+    license?: string;
+    credits?: string;
+};
+export type InstallRecord = {
+    kind: InstallKind;
+    source: SourceKind;
+    url?: string;
+    storeId?: string;
+    version: string;
+    sha256: string;
+    installedAt: string;
+};
+export type InstalledPlugin = {
+    version: string;
+    sha256: string;
+    enabled: boolean;
+};
+/** What `store_catalog` returns (waybetter-host `StoreView`): this app's items and what is installed. */
+export type StoreCatalogView = {
+    catalog: {
+        format?: number;
+        name: string;
+        generatedAt: string;
+        items: StoreItem[];
+    } | null;
+    fetchedAt: string | null;
+    error: string | null;
+    plugins: Record<string, InstalledPlugin>;
+    records: {
+        items: Record<string, InstallRecord>;
+    };
+};
+export type ScriptPluginMeta = {
+    file: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    enabled: boolean;
+    permissions: string[] | null;
+    problems?: string[];
+};
+/** What `install_stage_*` / `store_stage` return (waybetter-host `InstallPreview`). */
+export type InstallPreview = {
+    token: string;
+    kind: InstallKind;
+    source: {
+        kind: SourceKind;
+        url: string | null;
+        label: string;
+        signed: boolean;
+    };
+    sha256: string;
+    size: number;
+    file: string | null;
+    /** The exact text that will be written. */
+    text: string;
+    version: string;
+    plugin: ScriptPluginMeta | null;
+    theme: {
+        name: string;
+        author: string;
+        description: string;
+        cssChars: number;
+    } | null;
+    /** String packs: what the pack says about itself (coverage comes from the site's inventory). */
+    strings?: StringsInfo | null;
+    findings: string[];
+    existing: {
+        version: string;
+        enabled: boolean;
+        same: boolean;
+    } | null;
+    store: StoreItem | null;
+};
+/** The `install-link` event and `install_pending` entries (waybetter-host `LinkEvent`). */
+export type LinkEvent = {
+    link?: {
+        kind: InstallKind;
+        url: string;
+    };
+    error?: string;
+    setup?: string;
+};
+/** Plugin permissions (waybetter-host `PERMISSIONS`, runtime `permissions.ts`) and how much they allow. */
+export declare const PERMISSION_TONES: Readonly<Record<string, PermissionTone>>;
+/** Badges for a plugin's declared permissions; `null` = no `@permissions` line (legacy). `site`: the site's name. */
+export declare function permissionBadges(permissions: readonly string[] | null | undefined, t: StoreText, site: string): PermissionBadge[];
+/** A store category's name (`wb.store.category.<id>`); unknown ones show their id. */
+export declare function categoryLabel(id: string, t: StoreText): string;
+/** What a dropped file is, by name: `.plugin.js` → plugin, `.strings.json` → string pack, `.json` → theme, else nothing. */
+export declare function kindForFile(name: string): InstallKind | null;
+/** Largest file the shell reads before handing it to native validation (same caps as native). */
+export declare const MAX_FILE_BYTES: Readonly<Record<InstallKind, number>>;
+/** A free theme id: `wanted`, else `wanted-2`, `-3`, … (the way an import names copies). */
+export declare function freeThemeId(wanted: string, taken: Iterable<string>): string;
+/** `a` newer than `b` (numeric dot parts; same rule as native `newer_version`). */
+export declare function newerVersion(a: string, b: string): boolean;
+export type ItemState = {
+    state: 'install';
+} | {
+    state: 'builtin';
+} | {
+    state: 'installed';
+    version: string;
+    enabled?: boolean;
+} | {
+    state: 'update';
+    version: string;
+    enabled?: boolean;
+}
+/** Installed but changed locally (edited file, or a copy from somewhere else): the store leaves it alone unless asked. */
+ | {
+    state: 'modified';
+    version: string;
+    enabled?: boolean;
+};
+export type ItemContext = {
+    plugins: Record<string, InstalledPlugin>;
+    records: Record<string, InstallRecord>;
+    /** Theme ids that ship with the app (a store copy of one is "built in"). */
+    builtinThemes: readonly string[];
+    /** The owner's own theme ids right now. */
+    userThemes: readonly string[];
+};
+/**
+ * Where a store item stands on this machine. Plugins: by their file in the plugins folder.
+ * Themes: built-in ids are part of the app; otherwise the install record for a theme the owner
+ * still has.
+ */
+export declare function itemState(item: StoreItem, context: ItemContext): ItemState;
+/** The installed user theme id a store theme item was installed as (for updates in place). */
+export declare function installedThemeId(item: StoreItem, records: Record<string, InstallRecord>, userThemes: readonly string[]): string | null;
+/** Search and category filter for the store list. */
+export declare function filterItems(items: readonly StoreItem[], query: string, kind: InstallKind | 'all', category: string | 'all'): StoreItem[];
+export declare const formatBytes: (bytes: number) => string;
+/** Lines of a preview with their numbers, the first `limit` only unless `all`. */
+export declare function previewLines(text: string, limit: number, all?: boolean): {
+    lines: string[];
+    hidden: number;
+};
+/** An error from a native command, without its `CODE: ` prefix. */
+export declare const errorText: (error: unknown) => string;

package/dist/shell/storeModel.js

@@ -0,0 +1,133 @@
+// The wayBetter Store and install screen, pure part: the wire types of the native store commands
+// (waybetter-host `store`), what each plugin permission means, where a dropped file goes, which id a
+// new theme gets, whether a store item is installed, current or has an update, search, and preview
+// lines. Native code validates everything again; nothing here decides what may be installed.
+import { STORE_MESSAGES } from "./storeMessages.js";
+/** Plugin permissions (waybetter-host `PERMISSIONS`, runtime `permissions.ts`) and how much they allow. */
+export const PERMISSION_TONES = {
+    storage: 'plain',
+    ui: 'plain',
+    clipboard: 'plain',
+    account: 'warn',
+    commands: 'plain',
+    users: 'warn',
+    network: 'warn',
+    'network:none': 'ok',
+};
+/** `t(key)` for a key assembled at runtime, or `fallback` when the framework has no such message. */
+function lookup(t, key, params, fallback) {
+    return key in STORE_MESSAGES ? t(key, params) : fallback;
+}
+/** Badges for a plugin's declared permissions; `null` = no `@permissions` line (legacy). `site`: the site's name. */
+export function permissionBadges(permissions, t, site) {
+    if (permissions == null)
+        return [{ id: 'legacy', label: t('wb.permission.legacy.label'), detail: t('wb.permission.legacy.detail'), tone: 'warn' }];
+    if (permissions.length === 0)
+        return [{ id: 'none', label: t('wb.permission.none.label'), detail: t('wb.permission.none.detail'), tone: 'ok' }];
+    return permissions.map(id => {
+        const tone = PERMISSION_TONES[id];
+        if (!tone)
+            return { id, label: id, detail: t('wb.permission.unknown'), tone: 'warn' };
+        const name = id.replace(':none', 'None');
+        return { id, label: lookup(t, `wb.permission.${name}.label`, undefined, id), detail: lookup(t, `wb.permission.${name}.detail`, { site }, ''), tone };
+    });
+}
+/** A store category's name (`wb.store.category.<id>`); unknown ones show their id. */
+export function categoryLabel(id, t) {
+    return lookup(t, `wb.store.category.${id}`, undefined, id);
+}
+/** What a dropped file is, by name: `.plugin.js` → plugin, `.strings.json` → string pack, `.json` → theme, else nothing. */
+export function kindForFile(name) {
+    const lower = name.toLowerCase();
+    if (lower.endsWith('.plugin.js'))
+        return 'plugin';
+    if (lower.endsWith('.strings.json'))
+        return 'strings';
+    if (lower.endsWith('.json'))
+        return 'theme';
+    return null;
+}
+/** Largest file the shell reads before handing it to native validation (same caps as native). */
+export const MAX_FILE_BYTES = { theme: 2 * 1024 * 1024, plugin: 2 * 1024 * 1024, strings: 2 * 1024 * 1024 };
+/** A free theme id: `wanted`, else `wanted-2`, `-3`, … (the way an import names copies). */
+export function freeThemeId(wanted, taken) {
+    const used = new Set(taken);
+    if (!used.has(wanted))
+        return wanted;
+    for (let n = 2;; n += 1) {
+        const id = `${wanted.slice(0, 36)}-${n}`;
+        if (!used.has(id))
+            return id;
+    }
+}
+/** `a` newer than `b` (numeric dot parts; same rule as native `newer_version`). */
+export function newerVersion(a, b) {
+    const parts = (value) => value.split(/[.+-]/).map(part => Number.parseInt(part, 10) || 0);
+    const [x, y] = [parts(a), parts(b)];
+    for (let i = 0; i < Math.max(x.length, y.length); i += 1) {
+        const [p, q] = [x[i] ?? 0, y[i] ?? 0];
+        if (p !== q)
+            return p > q;
+    }
+    return false;
+}
+/**
+ * Where a store item stands on this machine. Plugins: by their file in the plugins folder.
+ * Themes: built-in ids are part of the app; otherwise the install record for a theme the owner
+ * still has.
+ */
+export function itemState(item, context) {
+    if (item.kind === 'plugin') {
+        const installed = item.file ? context.plugins[item.file] : undefined;
+        if (!installed)
+            return { state: 'install' };
+        const base = { version: installed.version, enabled: installed.enabled };
+        if (installed.sha256 === item.sha256)
+            return { state: 'installed', ...base };
+        if (newerVersion(item.version, installed.version))
+            return { state: 'update', ...base };
+        return { state: 'modified', ...base };
+    }
+    if (item.kind === 'strings') {
+        const record = context.records[`strings:${item.id}`];
+        if (!record)
+            return { state: 'install' };
+        if (record.sha256 === item.sha256)
+            return { state: 'installed', version: record.version };
+        return newerVersion(item.version, record.version) ? { state: 'update', version: record.version } : { state: 'installed', version: record.version };
+    }
+    if (context.builtinThemes.includes(item.id))
+        return { state: 'builtin' };
+    const id = installedThemeId(item, context.records, context.userThemes);
+    if (!id)
+        return { state: 'install' };
+    const value = context.records[`theme:${id}`];
+    if (value.sha256 === item.sha256)
+        return { state: 'installed', version: value.version };
+    return newerVersion(item.version, value.version) ? { state: 'update', version: value.version } : { state: 'installed', version: value.version };
+}
+/** The installed user theme id a store theme item was installed as (for updates in place). */
+export function installedThemeId(item, records, userThemes) {
+    for (const [key, value] of Object.entries(records)) {
+        if (key.startsWith('theme:') && value.storeId === item.id && userThemes.includes(key.slice(6)))
+            return key.slice(6);
+    }
+    return null;
+}
+/** Search and category filter for the store list. */
+export function filterItems(items, query, kind, category) {
+    const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+    return items.filter(item => (kind === 'all' || item.kind === kind) && (category === 'all' || item.category === category)
+        && words.every(word => [item.name, item.description, item.author, item.category, item.language ?? '', ...item.tags, ...(item.permissions ?? [])].join(' ').toLowerCase().includes(word)));
+}
+export const formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+/** Lines of a preview with their numbers, the first `limit` only unless `all`. */
+export function previewLines(text, limit, all = false) {
+    const lines = text.replace(/\r\n?/g, '\n').split('\n');
+    if (all || lines.length <= limit)
+        return { lines, hidden: 0 };
+    return { lines: lines.slice(0, limit), hidden: lines.length - limit };
+}
+/** An error from a native command, without its `CODE: ` prefix. */
+export const errorText = (error) => (error instanceof Error ? error.message : String(error)).replace(/^[A-Z]+: /, '');
+//# sourceMappingURL=storeModel.js.map

package/dist/shell/storeModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeModel.js","sourceRoot":"","sources":["../../../../../shell/src/storeModel.ts"],"names":[],"mappings":"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","sourcesContent":["// The wayBetter Store and install screen, pure part: the wire types of the native store commands\n// (waybetter-host `store`), what each plugin permission means, where a dropped file goes, which id a\n// new theme gets, whether a store item is installed, current or has an update, search, and preview\n// lines. Native code validates everything again; nothing here decides what may be installed.\n\nimport { STORE_MESSAGES, type StoreKey, type StoreText } from './storeMessages.ts';\nimport type { StringsInfo } from './stringPacksModel.ts';\n\nexport type InstallKind = 'theme' | 'plugin' | 'strings';\nexport type SourceKind = 'store' | 'link' | 'file';\nexport type PermissionTone = 'plain' | 'warn' | 'ok';\nexport type PermissionBadge = { id: string; label: string; detail: string; tone: PermissionTone };\n\n/** A store catalog item (waybetter-host `CatalogItem`; the catalog format is documented in docs/STORE.md). */\nexport type StoreItem = {\n  /** The wayBetter apps it is for; native code only hands an app its own items. */\n  apps?: string[];\n  kind: InstallKind; id: string; name: string; author: string; version: string; description: string;\n  category: string; tags: string[]; url: string; file?: string; sha256: string; size: number;\n  preview?: string; permissions?: string[] | null; colors?: { bg: string; surface?: string; text: string; accent: string } | null;\n  /** String packs: the pack's language tag. */\n  language?: string;\n  /** Any kind: its licence and who made, translated or reviewed it. */\n  license?: string; credits?: string;\n};\nexport type InstallRecord = { kind: InstallKind; source: SourceKind; url?: string; storeId?: string; version: string; sha256: string; installedAt: string };\nexport type InstalledPlugin = { version: string; sha256: string; enabled: boolean };\n\n/** What `store_catalog` returns (waybetter-host `StoreView`): this app's items and what is installed. */\nexport type StoreCatalogView = {\n  catalog: { format?: number; name: string; generatedAt: string; items: StoreItem[] } | null;\n  fetchedAt: string | null;\n  error: string | null;\n  plugins: Record<string, InstalledPlugin>;\n  records: { items: Record<string, InstallRecord> };\n};\n\nexport type ScriptPluginMeta = {\n  file: string; name: string; description: string; version: string; author: string; enabled: boolean;\n  permissions: string[] | null; problems?: string[];\n};\n\n/** What `install_stage_*` / `store_stage` return (waybetter-host `InstallPreview`). */\nexport type InstallPreview = {\n  token: string;\n  kind: InstallKind;\n  source: { kind: SourceKind; url: string | null; label: string; signed: boolean };\n  sha256: string;\n  size: number;\n  file: string | null;\n  /** The exact text that will be written. */\n  text: string;\n  version: string;\n  plugin: ScriptPluginMeta | null;\n  theme: { name: string; author: string; description: string; cssChars: number } | null;\n  /** String packs: what the pack says about itself (coverage comes from the site's inventory). */\n  strings?: StringsInfo | null;\n  findings: string[];\n  existing: { version: string; enabled: boolean; same: boolean } | null;\n  store: StoreItem | null;\n};\n\n/** The `install-link` event and `install_pending` entries (waybetter-host `LinkEvent`). */\nexport type LinkEvent = { link?: { kind: InstallKind; url: string }; error?: string; setup?: string };\n\n/** Plugin permissions (waybetter-host `PERMISSIONS`, runtime `permissions.ts`) and how much they allow. */\nexport const PERMISSION_TONES: Readonly<Record<string, PermissionTone>> = {\n  storage: 'plain',\n  ui: 'plain',\n  clipboard: 'plain',\n  account: 'warn',\n  commands: 'plain',\n  users: 'warn',\n  network: 'warn',\n  'network:none': 'ok',\n};\n\n/** `t(key)` for a key assembled at runtime, or `fallback` when the framework has no such message. */\nfunction lookup(t: StoreText, key: string, params: Record<string, string> | undefined, fallback: string): string {\n  return key in STORE_MESSAGES ? t(key as StoreKey, params) : fallback;\n}\n\n/** Badges for a plugin's declared permissions; `null` = no `@permissions` line (legacy). `site`: the site's name. */\nexport function permissionBadges(permissions: readonly string[] | null | undefined, t: StoreText, site: string): PermissionBadge[] {\n  if (permissions == null) return [{ id: 'legacy', label: t('wb.permission.legacy.label'), detail: t('wb.permission.legacy.detail'), tone: 'warn' }];\n  if (permissions.length === 0) return [{ id: 'none', label: t('wb.permission.none.label'), detail: t('wb.permission.none.detail'), tone: 'ok' }];\n  return permissions.map(id => {\n    const tone = PERMISSION_TONES[id];\n    if (!tone) return { id, label: id, detail: t('wb.permission.unknown'), tone: 'warn' as const };\n    const name = id.replace(':none', 'None');\n    return { id, label: lookup(t, `wb.permission.${name}.label`, undefined, id), detail: lookup(t, `wb.permission.${name}.detail`, { site }, ''), tone };\n  });\n}\n\n/** A store category's name (`wb.store.category.<id>`); unknown ones show their id. */\nexport function categoryLabel(id: string, t: StoreText): string {\n  return lookup(t, `wb.store.category.${id}`, undefined, id);\n}\n\n/** What a dropped file is, by name: `.plugin.js` → plugin, `.strings.json` → string pack, `.json` → theme, else nothing. */\nexport function kindForFile(name: string): InstallKind | null {\n  const lower = name.toLowerCase();\n  if (lower.endsWith('.plugin.js')) return 'plugin';\n  if (lower.endsWith('.strings.json')) return 'strings';\n  if (lower.endsWith('.json')) return 'theme';\n  return null;\n}\n\n/** Largest file the shell reads before handing it to native validation (same caps as native). */\nexport const MAX_FILE_BYTES: Readonly<Record<InstallKind, number>> = { theme: 2 * 1024 * 1024, plugin: 2 * 1024 * 1024, strings: 2 * 1024 * 1024 };\n\n/** A free theme id: `wanted`, else `wanted-2`, `-3`, … (the way an import names copies). */\nexport function freeThemeId(wanted: string, taken: Iterable<string>): string {\n  const used = new Set(taken);\n  if (!used.has(wanted)) return wanted;\n  for (let n = 2; ; n += 1) {\n    const id = `${wanted.slice(0, 36)}-${n}`;\n    if (!used.has(id)) return id;\n  }\n}\n\n/** `a` newer than `b` (numeric dot parts; same rule as native `newer_version`). */\nexport function newerVersion(a: string, b: string): boolean {\n  const parts = (value: string) => value.split(/[.+-]/).map(part => Number.parseInt(part, 10) || 0);\n  const [x, y] = [parts(a), parts(b)];\n  for (let i = 0; i < Math.max(x.length, y.length); i += 1) {\n    const [p, q] = [x[i] ?? 0, y[i] ?? 0];\n    if (p !== q) return p > q;\n  }\n  return false;\n}\n\nexport type ItemState =\n  | { state: 'install' }\n  | { state: 'builtin' }\n  | { state: 'installed'; version: string; enabled?: boolean }\n  | { state: 'update'; version: string; enabled?: boolean }\n  /** Installed but changed locally (edited file, or a copy from somewhere else): the store leaves it alone unless asked. */\n  | { state: 'modified'; version: string; enabled?: boolean };\n\nexport type ItemContext = {\n  plugins: Record<string, InstalledPlugin>;\n  records: Record<string, InstallRecord>;\n  /** Theme ids that ship with the app (a store copy of one is \"built in\"). */\n  builtinThemes: readonly string[];\n  /** The owner's own theme ids right now. */\n  userThemes: readonly string[];\n};\n\n/**\n * Where a store item stands on this machine. Plugins: by their file in the plugins folder.\n * Themes: built-in ids are part of the app; otherwise the install record for a theme the owner\n * still has.\n */\nexport function itemState(item: StoreItem, context: ItemContext): ItemState {\n  if (item.kind === 'plugin') {\n    const installed = item.file ? context.plugins[item.file] : undefined;\n    if (!installed) return { state: 'install' };\n    const base = { version: installed.version, enabled: installed.enabled };\n    if (installed.sha256 === item.sha256) return { state: 'installed', ...base };\n    if (newerVersion(item.version, installed.version)) return { state: 'update', ...base };\n    return { state: 'modified', ...base };\n  }\n  if (item.kind === 'strings') {\n    const record = context.records[`strings:${item.id}`];\n    if (!record) return { state: 'install' };\n    if (record.sha256 === item.sha256) return { state: 'installed', version: record.version };\n    return newerVersion(item.version, record.version) ? { state: 'update', version: record.version } : { state: 'installed', version: record.version };\n  }\n  if (context.builtinThemes.includes(item.id)) return { state: 'builtin' };\n  const id = installedThemeId(item, context.records, context.userThemes);\n  if (!id) return { state: 'install' };\n  const value = context.records[`theme:${id}`]!;\n  if (value.sha256 === item.sha256) return { state: 'installed', version: value.version };\n  return newerVersion(item.version, value.version) ? { state: 'update', version: value.version } : { state: 'installed', version: value.version };\n}\n\n/** The installed user theme id a store theme item was installed as (for updates in place). */\nexport function installedThemeId(item: StoreItem, records: Record<string, InstallRecord>, userThemes: readonly string[]): string | null {\n  for (const [key, value] of Object.entries(records)) {\n    if (key.startsWith('theme:') && value.storeId === item.id && userThemes.includes(key.slice(6))) return key.slice(6);\n  }\n  return null;\n}\n\n/** Search and category filter for the store list. */\nexport function filterItems(items: readonly StoreItem[], query: string, kind: InstallKind | 'all', category: string | 'all'): StoreItem[] {\n  const words = query.toLowerCase().split(/\\s+/).filter(Boolean);\n  return items.filter(item => (kind === 'all' || item.kind === kind) && (category === 'all' || item.category === category)\n    && words.every(word => [item.name, item.description, item.author, item.category, item.language ?? '', ...item.tags, ...(item.permissions ?? [])].join(' ').toLowerCase().includes(word)));\n}\n\nexport const formatBytes = (bytes: number) => bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(2)} MB`;\n\n/** Lines of a preview with their numbers, the first `limit` only unless `all`. */\nexport function previewLines(text: string, limit: number, all = false): { lines: string[]; hidden: number } {\n  const lines = text.replace(/\\r\\n?/g, '\\n').split('\\n');\n  if (all || lines.length <= limit) return { lines, hidden: 0 };\n  return { lines: lines.slice(0, limit), hidden: lines.length - limit };\n}\n\n/** An error from a native command, without its `CODE: ` prefix. */\nexport const errorText = (error: unknown) => (error instanceof Error ? error.message : String(error)).replace(/^[A-Z]+: /, '');\n"]}

package/dist/shell/stringPacksModel.d.ts

@@ -0,0 +1,44 @@
+import { type PageInventory } from '../runtime/stringPacks.ts';
+/** What `strings_list` returns per pack (waybetter-host `InstalledStrings`). */
+export type InstalledStrings = {
+    id: string;
+    site: string;
+    catalog: string;
+    language: string;
+    name: string;
+    authors: string[];
+    version: string;
+    description: string;
+    strings: number;
+    sha256: string;
+    enabled: boolean;
+};
+/** The pack as the install screen gets it from native code (waybetter-host `StringsInfo`). */
+export type StringsInfo = Omit<InstalledStrings, 'id' | 'sha256' | 'enabled'>;
+export type StringsSummary = {
+    language: string;
+    /** Strings of the site the pack replaces / strings a pack can replace. */
+    translated: number;
+    translatable: number;
+    /** Keys the site has but no pack can replace yet (rich text, formatters). */
+    closed: number;
+    /** Keys the site does not have: ignored. */
+    unknown: number;
+    /** Values that do not fit the site's own string (parameters, plural forms, markup): not used. */
+    refused: number;
+    /** A few of the pack's own texts, for the screen. */
+    sample: string[];
+    /** The pack is for another catalog of the site than this inventory. */
+    otherCatalog: boolean;
+};
+/** Coverage and a sample of a pack's text; `null` when the text is not a pack at all. */
+export declare function packSummary(text: string, inventory: PageInventory): StringsSummary | null;
+/** `translated / translatable` as a percentage with one decimal. */
+export declare const coveragePercent: (summary: Pick<StringsSummary, "translated" | "translatable">) => string;
+/**
+ * What the site tabs get: the texts of the packs that are on, in application order, with the slice
+ * of the inventory their keys need. `null` when no usable pack is on (the tabs then drop theirs).
+ */
+export declare function buildDelivery(texts: readonly string[], inventory: PageInventory, options?: {
+    translate?: boolean;
+}): string | null;

package/dist/shell/stringPacksModel.js

@@ -0,0 +1,94 @@
+// String packs in the shell, pure part (waybetter/docs/STRING-PACKS.md): what the install screen and
+// the Languages section say about a pack (coverage against the site's inventory, what is ignored, a
+// sample), and the delivery the site tabs get (the packs that are on, in order, with the slice of the
+// inventory their keys need). Native code only keeps the data; it never sees the inventory.
+import { compilePack, inventoryLookup, sliceInventory, translatable, } from "../runtime/stringPacks.js";
+const MAX_SAMPLE = 6;
+/** Coverage and a sample of a pack's text; `null` when the text is not a pack at all. */
+export function packSummary(text, inventory) {
+    let pack;
+    try {
+        pack = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    const record = pack;
+    if (!record || typeof record !== 'object' || typeof record.strings !== 'object' || record.strings === null)
+        return null;
+    const language = typeof record.language === 'string' ? record.language : '';
+    const lookup = inventoryLookup(inventory);
+    let translatableCount = 0;
+    let closed = 0;
+    // The page inventory lists every key once, in its groups: count what a pack can replace.
+    for (const ids of [inventory.text, inventory.closed])
+        if (ids)
+            for (const id of ids.split(' ')) {
+                if (lookup(id) && translatable(lookup(id).kind))
+                    translatableCount += 1;
+                else
+                    closed += 1;
+            }
+    translatableCount += Object.keys(inventory.message).length;
+    if (record.catalog !== inventory.catalog) {
+        return { language, translated: 0, translatable: translatableCount, closed, unknown: Object.keys(record.strings).length, refused: 0, sample: [], otherCatalog: true };
+    }
+    let compiled;
+    try {
+        compiled = compilePack(pack, inventory);
+    }
+    catch {
+        return null;
+    }
+    const sample = [];
+    for (const [id, value] of Object.entries(record.strings)) {
+        if (sample.length >= MAX_SAMPLE)
+            break;
+        if (compiled.values.has(id) && typeof value === 'string' && !value.includes('{') && value.length <= 40)
+            sample.push(value);
+    }
+    return {
+        language, translated: compiled.values.size, translatable: translatableCount, closed,
+        unknown: compiled.report.unknown.length, refused: compiled.report.rejected.length, sample, otherCatalog: false,
+    };
+}
+/** `translated / translatable` as a percentage with one decimal. */
+export const coveragePercent = (summary) => summary.translatable ? `${(Math.round(summary.translated / summary.translatable * 1000) / 10).toFixed(1)}%` : '0%';
+/**
+ * What the site tabs get: the texts of the packs that are on, in application order, with the slice
+ * of the inventory their keys need. `null` when no usable pack is on (the tabs then drop theirs).
+ */
+export function buildDelivery(texts, inventory, options = {}) {
+    const packs = [];
+    const ids = new Set();
+    for (const text of texts) {
+        let pack;
+        try {
+            pack = JSON.parse(text);
+        }
+        catch {
+            continue;
+        }
+        let compiled;
+        try {
+            compiled = compilePack(pack, inventory);
+        }
+        catch {
+            continue;
+        }
+        if (!compiled.values.size)
+            continue;
+        packs.push(pack);
+        for (const id of compiled.values.keys())
+            ids.add(id);
+        if (packs.length >= 8)
+            break;
+    }
+    // Translate mode: the whole inventory (the author may change any string), packs or not.
+    if (options.translate)
+        return JSON.stringify({ inventory, packs, translate: true });
+    if (!packs.length)
+        return null;
+    return JSON.stringify({ inventory: sliceInventory(inventory, ids), packs });
+}
+//# sourceMappingURL=stringPacksModel.js.map

package/dist/shell/stringPacksModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringPacksModel.js","sourceRoot":"","sources":["../../../../../shell/src/stringPacksModel.ts"],"names":[],"mappings":"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","sourcesContent":["// String packs in the shell, pure part (waybetter/docs/STRING-PACKS.md): what the install screen and\n// the Languages section say about a pack (coverage against the site's inventory, what is ignored, a\n// sample), and the delivery the site tabs get (the packs that are on, in order, with the slice of the\n// inventory their keys need). Native code only keeps the data; it never sees the inventory.\nimport {\n  compilePack, inventoryLookup, sliceInventory, translatable, type PageInventory,\n} from '../../runtime/src/stringPacks.ts';\n\n/** What `strings_list` returns per pack (waybetter-host `InstalledStrings`). */\nexport type InstalledStrings = {\n  id: string; site: string; catalog: string; language: string; name: string; authors: string[];\n  version: string; description: string; strings: number; sha256: string; enabled: boolean;\n};\n/** The pack as the install screen gets it from native code (waybetter-host `StringsInfo`). */\nexport type StringsInfo = Omit<InstalledStrings, 'id' | 'sha256' | 'enabled'>;\n\nexport type StringsSummary = {\n  language: string;\n  /** Strings of the site the pack replaces / strings a pack can replace. */\n  translated: number;\n  translatable: number;\n  /** Keys the site has but no pack can replace yet (rich text, formatters). */\n  closed: number;\n  /** Keys the site does not have: ignored. */\n  unknown: number;\n  /** Values that do not fit the site's own string (parameters, plural forms, markup): not used. */\n  refused: number;\n  /** A few of the pack's own texts, for the screen. */\n  sample: string[];\n  /** The pack is for another catalog of the site than this inventory. */\n  otherCatalog: boolean;\n};\n\nconst MAX_SAMPLE = 6;\n\n/** Coverage and a sample of a pack's text; `null` when the text is not a pack at all. */\nexport function packSummary(text: string, inventory: PageInventory): StringsSummary | null {\n  let pack: unknown;\n  try { pack = JSON.parse(text); } catch { return null; }\n  const record = pack as { catalog?: unknown; language?: unknown; strings?: unknown };\n  if (!record || typeof record !== 'object' || typeof record.strings !== 'object' || record.strings === null) return null;\n  const language = typeof record.language === 'string' ? record.language : '';\n  const lookup = inventoryLookup(inventory);\n  let translatableCount = 0;\n  let closed = 0;\n  // The page inventory lists every key once, in its groups: count what a pack can replace.\n  for (const ids of [inventory.text, inventory.closed]) if (ids) for (const id of ids.split(' ')) { if (lookup(id) && translatable(lookup(id)!.kind)) translatableCount += 1; else closed += 1; }\n  translatableCount += Object.keys(inventory.message).length;\n  if (record.catalog !== inventory.catalog) {\n    return { language, translated: 0, translatable: translatableCount, closed, unknown: Object.keys(record.strings).length, refused: 0, sample: [], otherCatalog: true };\n  }\n  let compiled;\n  try { compiled = compilePack(pack, inventory); } catch { return null; }\n  const sample: string[] = [];\n  for (const [id, value] of Object.entries(record.strings as Record<string, unknown>)) {\n    if (sample.length >= MAX_SAMPLE) break;\n    if (compiled.values.has(id) && typeof value === 'string' && !value.includes('{') && value.length <= 40) sample.push(value);\n  }\n  return {\n    language, translated: compiled.values.size, translatable: translatableCount, closed,\n    unknown: compiled.report.unknown.length, refused: compiled.report.rejected.length, sample, otherCatalog: false,\n  };\n}\n\n/** `translated / translatable` as a percentage with one decimal. */\nexport const coveragePercent = (summary: Pick<StringsSummary, 'translated' | 'translatable'>) =>\n  summary.translatable ? `${(Math.round(summary.translated / summary.translatable * 1000) / 10).toFixed(1)}%` : '0%';\n\n/**\n * What the site tabs get: the texts of the packs that are on, in application order, with the slice\n * of the inventory their keys need. `null` when no usable pack is on (the tabs then drop theirs).\n */\nexport function buildDelivery(texts: readonly string[], inventory: PageInventory, options: { translate?: boolean } = {}): string | null {\n  const packs: unknown[] = [];\n  const ids = new Set<string>();\n  for (const text of texts) {\n    let pack: unknown;\n    try { pack = JSON.parse(text); } catch { continue; }\n    let compiled;\n    try { compiled = compilePack(pack, inventory); } catch { continue; }\n    if (!compiled.values.size) continue;\n    packs.push(pack);\n    for (const id of compiled.values.keys()) ids.add(id);\n    if (packs.length >= 8) break;\n  }\n  // Translate mode: the whole inventory (the author may change any string), packs or not.\n  if (options.translate) return JSON.stringify({ inventory, packs, translate: true });\n  if (!packs.length) return null;\n  return JSON.stringify({ inventory: sliceInventory(inventory, ids), packs });\n}\n"]}

package/dist/shell/updateModel.d.ts

@@ -1,3 +1,4 @@
+import { type ShellText } from './messages.ts';
 /** Mirrors `UpdateStatus` in waybetter-host `update.rs` (serde tag "state"). */
 export type UpdateStatus = {
     state: 'idle' | 'checking' | 'upToDate';
@@ -32,4 +33,4 @@ export type UpdateChip = {
 /** Accepts only well-formed status payloads; anything else is treated as idle. */
 export declare function parseUpdateStatus(value: unknown): UpdateStatus;
 /** Unobtrusive: nothing while checking/downloading/erroring; a chip only when action is useful. */
-export declare function chipFor(status: UpdateStatus, product: string): UpdateChip | null;
+export declare function chipFor(status: UpdateStatus, product: string, text?: ShellText): UpdateChip | null;

package/dist/shell/updateModel.js

@@ -1,4 +1,5 @@
 // Pure model for the titlebar update chip (no Tauri imports, so it is unit-tested under node).
+import { shellText } from "./messages.js";
 const STATES = new Set(['idle', 'checking', 'upToDate', 'downloading', 'installing', 'ready', 'error', 'problem']);
 /** Accepts only well-formed status payloads; anything else is treated as idle. */
 export function parseUpdateStatus(value) {
@@ -21,11 +22,11 @@ export function parseUpdateStatus(value) {
     }
 }
 /** Unobtrusive: nothing while checking/downloading/erroring; a chip only when action is useful. */
-export function chipFor(status, product) {
+export function chipFor(status, product, text) {
     switch (status.state) {
-        case 'ready': return { kind: 'restart', label: 'Update ready · restart', title: `Restart to update to ${product} ${status.version}. Tabs are restored.` };
-        case 'installing': return { kind: 'installing', label: 'Updating…', title: `Installing ${product} ${status.version}` };
-        case 'problem': return { kind: 'problem', label: 'Update problem', title: 'The last update did not start correctly. Download the current version.', href: status.downloadUrl };
+        case 'ready': return { kind: 'restart', label: shellText('wb.update.readyLabel', {}, text), title: shellText('wb.update.readyTitle', { product, version: status.version }, text) };
+        case 'installing': return { kind: 'installing', label: shellText('wb.update.installingLabel', {}, text), title: shellText('wb.update.installingTitle', { product, version: status.version }, text) };
+        case 'problem': return { kind: 'problem', label: shellText('wb.update.problemLabel', {}, text), title: shellText('wb.update.problemTitle', {}, text), href: status.downloadUrl };
         default: return null;
     }
 }

package/dist/shell/updateModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateModel.js","sourceRoot":"","sources":["../../../shell/src/updateModel.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAe/F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnH,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClE,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClF,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpF,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACtF,KAAK,aAAa,CAAC;QAAC,KAAK,YAAY,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1F,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACnG,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAyC,EAAE,CAAC;IACzE,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,OAAO,CAAC,MAAoB,EAAE,OAAe;IAC3D,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,wBAAwB,OAAO,IAAI,MAAM,CAAC,OAAO,sBAAsB,EAAE,CAAC;QAC1J,KAAK,YAAY,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACvH,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,wEAAwE,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/K,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC","sourcesContent":["// Pure model for the titlebar update chip (no Tauri imports, so it is unit-tested under node).\n\n/** Mirrors `UpdateStatus` in waybetter-host `update.rs` (serde tag \"state\"). */\nexport type UpdateStatus =\n  | { state: 'idle' | 'checking' | 'upToDate' }\n  | { state: 'downloading' | 'installing'; version: string }\n  | { state: 'ready'; version: string; notes: string }\n  | { state: 'error'; message: string }\n  | { state: 'problem'; downloadUrl: string };\n\nexport type UpdateChip =\n  | { kind: 'restart'; label: string; title: string }\n  | { kind: 'installing'; label: string; title: string }\n  | { kind: 'problem'; label: string; title: string; href: string };\n\nconst STATES = new Set(['idle', 'checking', 'upToDate', 'downloading', 'installing', 'ready', 'error', 'problem']);\n\n/** Accepts only well-formed status payloads; anything else is treated as idle. */\nexport function parseUpdateStatus(value: unknown): UpdateStatus {\n  if (!value || typeof value !== 'object') return { state: 'idle' };\n  const v = value as Record<string, unknown>;\n  if (typeof v.state !== 'string' || !STATES.has(v.state)) return { state: 'idle' };\n  const str = (key: string) => (typeof v[key] === 'string' ? (v[key] as string) : '');\n  switch (v.state) {\n    case 'ready': return { state: 'ready', version: str('version'), notes: str('notes') };\n    case 'downloading': case 'installing': return { state: v.state, version: str('version') };\n    case 'error': return { state: 'error', message: str('message') };\n    case 'problem': {\n      const href = str('downloadUrl');\n      return href.startsWith('https://') ? { state: 'problem', downloadUrl: href } : { state: 'idle' };\n    }\n    default: return { state: v.state as 'idle' | 'checking' | 'upToDate' };\n  }\n}\n\n/** Unobtrusive: nothing while checking/downloading/erroring; a chip only when action is useful. */\nexport function chipFor(status: UpdateStatus, product: string): UpdateChip | null {\n  switch (status.state) {\n    case 'ready': return { kind: 'restart', label: 'Update ready · restart', title: `Restart to update to ${product} ${status.version}. Tabs are restored.` };\n    case 'installing': return { kind: 'installing', label: 'Updating…', title: `Installing ${product} ${status.version}` };\n    case 'problem': return { kind: 'problem', label: 'Update problem', title: 'The last update did not start correctly. Download the current version.', href: status.downloadUrl };\n    default: return null;\n  }\n}\n"]}
+{"version":3,"file":"updateModel.js","sourceRoot":"","sources":["../../../../../shell/src/updateModel.ts"],"names":[],"mappings":"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","sourcesContent":["// Pure model for the titlebar update chip (no Tauri imports, so it is unit-tested under node).\n\nimport { shellText, type ShellText } from './messages.ts';\n\n/** Mirrors `UpdateStatus` in waybetter-host `update.rs` (serde tag \"state\"). */\nexport type UpdateStatus =\n  | { state: 'idle' | 'checking' | 'upToDate' }\n  | { state: 'downloading' | 'installing'; version: string }\n  | { state: 'ready'; version: string; notes: string }\n  | { state: 'error'; message: string }\n  | { state: 'problem'; downloadUrl: string };\n\nexport type UpdateChip =\n  | { kind: 'restart'; label: string; title: string }\n  | { kind: 'installing'; label: string; title: string }\n  | { kind: 'problem'; label: string; title: string; href: string };\n\nconst STATES = new Set(['idle', 'checking', 'upToDate', 'downloading', 'installing', 'ready', 'error', 'problem']);\n\n/** Accepts only well-formed status payloads; anything else is treated as idle. */\nexport function parseUpdateStatus(value: unknown): UpdateStatus {\n  if (!value || typeof value !== 'object') return { state: 'idle' };\n  const v = value as Record<string, unknown>;\n  if (typeof v.state !== 'string' || !STATES.has(v.state)) return { state: 'idle' };\n  const str = (key: string) => (typeof v[key] === 'string' ? (v[key] as string) : '');\n  switch (v.state) {\n    case 'ready': return { state: 'ready', version: str('version'), notes: str('notes') };\n    case 'downloading': case 'installing': return { state: v.state, version: str('version') };\n    case 'error': return { state: 'error', message: str('message') };\n    case 'problem': {\n      const href = str('downloadUrl');\n      return href.startsWith('https://') ? { state: 'problem', downloadUrl: href } : { state: 'idle' };\n    }\n    default: return { state: v.state as 'idle' | 'checking' | 'upToDate' };\n  }\n}\n\n/** Unobtrusive: nothing while checking/downloading/erroring; a chip only when action is useful. */\nexport function chipFor(status: UpdateStatus, product: string, text?: ShellText): UpdateChip | null {\n  switch (status.state) {\n    case 'ready': return { kind: 'restart', label: shellText('wb.update.readyLabel', {}, text), title: shellText('wb.update.readyTitle', { product, version: status.version }, text) };\n    case 'installing': return { kind: 'installing', label: shellText('wb.update.installingLabel', {}, text), title: shellText('wb.update.installingTitle', { product, version: status.version }, text) };\n    case 'problem': return { kind: 'problem', label: shellText('wb.update.problemLabel', {}, text), title: shellText('wb.update.problemTitle', {}, text), href: status.downloadUrl };\n    default: return null;\n  }\n}\n"]}

package/dist/shell/windowControls.d.ts

@@ -5,6 +5,8 @@ export type NativeWindow = {
     toggleMaximize(): Promise<void>;
     close(): Promise<void>;
     startResizeDragging(direction: ResizeDirection): Promise<void>;
+    /** Moves the window with the pointer (the titlebar logo, once a press on it becomes a drag). */
+    startDragging?(): Promise<void>;
     isMaximized(): Promise<boolean>;
     onResized(handler: () => void): Promise<() => void>;
 };
@@ -18,6 +20,8 @@ export declare function createWindowControls(invoke: Invoke, currentWindow: () =
     toggleMaximize: () => Promise<void>;
     close: () => Promise<void>;
     startResize: (direction: ResizeDirection) => Promise<void>;
+    /** Starts a native window move while the pointer is down (nothing where the app's window lacks it, or in a preview). */
+    startDrag: () => void;
     onMaximizedChange: (cb: (maximized: boolean) => void) => Promise<() => void>;
     /** The native system menu at a screen position (host `system_menu`; Windows only). */
     systemMenu: (x: number, y: number) => Promise<unknown>;

package/dist/shell/windowControls.js

@@ -10,6 +10,11 @@ export function createWindowControls(invoke, currentWindow) {
         toggleMaximize: () => currentWindow().toggleMaximize().catch(() => { }),
         close: () => currentWindow().close().catch(() => { }),
         startResize: (direction) => currentWindow().startResizeDragging(direction).catch(() => { }),
+        /** Starts a native window move while the pointer is down (nothing where the app's window lacks it, or in a preview). */
+        startDrag: () => { try {
+            void currentWindow().startDragging?.().catch(() => { });
+        }
+        catch { /* No native window. */ } },
         onMaximizedChange: (cb) => {
             const read = () => { currentWindow().isMaximized().then(cb).catch(() => { }); };
             read();

package/dist/shell/windowControls.js.map

@@ -1 +1 @@
-{"version":3,"file":"windowControls.js","sourceRoot":"","sources":["../../../shell/src/windowControls.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,8FAA8F;AAe9F,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,qBAAqB,IAAI,MAAM,CAAC;AACxF,mHAAmH;AACnH,MAAM,CAAC,MAAM,EAAE,GAAwB,OAAO,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClI,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,aAAiC;IACpF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC1D,cAAc,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QACtE,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QACpD,WAAW,EAAE,CAAC,SAA0B,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC3G,iBAAiB,EAAE,CAAC,EAAgC,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,IAAI,EAAE,CAAC;YACP,OAAO,aAAa,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,sFAAsF;QACtF,UAAU,EAAE,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;KAC7F,CAAC;AACJ,CAAC","sourcesContent":["// Native window calls for the custom titlebar, resize grips and caption buttons. The Tauri API is\n// passed in (the app owns its `@tauri-apps/api` version), so this module has no dependencies.\n\nexport type ResizeDirection = 'North' | 'South' | 'East' | 'West' | 'NorthEast' | 'NorthWest' | 'SouthEast' | 'SouthWest';\n\n/** The subset of Tauri's `Window` the shell uses. */\nexport type NativeWindow = {\n  minimize(): Promise<void>;\n  toggleMaximize(): Promise<void>;\n  close(): Promise<void>;\n  startResizeDragging(direction: ResizeDirection): Promise<void>;\n  isMaximized(): Promise<boolean>;\n  onResized(handler: () => void): Promise<() => void>;\n};\nexport type Invoke = (command: string, args?: Record<string, unknown>) => Promise<unknown>;\n\nexport const isTauri = typeof window !== 'undefined' && '__TAURI_INTERNALS__' in window;\n/** macOS keeps a native (overlay) frame with traffic lights; Windows is frameless with our own caption buttons. */\nexport const os: 'macos' | 'windows' = typeof navigator !== 'undefined' && /Mac/i.test(navigator.userAgent) ? 'macos' : 'windows';\nexport const frameless = isTauri && os !== 'macos';\n\nexport function createWindowControls(invoke: Invoke, currentWindow: () => NativeWindow) {\n  return {\n    minimize: () => currentWindow().minimize().catch(() => {}),\n    toggleMaximize: () => currentWindow().toggleMaximize().catch(() => {}),\n    close: () => currentWindow().close().catch(() => {}),\n    startResize: (direction: ResizeDirection) => currentWindow().startResizeDragging(direction).catch(() => {}),\n    onMaximizedChange: (cb: (maximized: boolean) => void) => {\n      const read = () => { currentWindow().isMaximized().then(cb).catch(() => {}); };\n      read();\n      return currentWindow().onResized(read);\n    },\n    /** The native system menu at a screen position (host `system_menu`; Windows only). */\n    systemMenu: (x: number, y: number) => invoke('window_system_menu', { x, y }).catch(() => {}),\n  };\n}\n"]}
+{"version":3,"file":"windowControls.js","sourceRoot":"","sources":["../../../../../shell/src/windowControls.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,8FAA8F;AAiB9F,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,qBAAqB,IAAI,MAAM,CAAC;AACxF,mHAAmH;AACnH,MAAM,CAAC,MAAM,EAAE,GAAwB,OAAO,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClI,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,aAAiC;IACpF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC1D,cAAc,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QACtE,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QACpD,WAAW,EAAE,CAAC,SAA0B,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC3G,wHAAwH;QACxH,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAAC,KAAK,aAAa,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;QACtH,iBAAiB,EAAE,CAAC,EAAgC,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,IAAI,EAAE,CAAC;YACP,OAAO,aAAa,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,sFAAsF;QACtF,UAAU,EAAE,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;KAC7F,CAAC;AACJ,CAAC","sourcesContent":["// Native window calls for the custom titlebar, resize grips and caption buttons. The Tauri API is\n// passed in (the app owns its `@tauri-apps/api` version), so this module has no dependencies.\n\nexport type ResizeDirection = 'North' | 'South' | 'East' | 'West' | 'NorthEast' | 'NorthWest' | 'SouthEast' | 'SouthWest';\n\n/** The subset of Tauri's `Window` the shell uses. */\nexport type NativeWindow = {\n  minimize(): Promise<void>;\n  toggleMaximize(): Promise<void>;\n  close(): Promise<void>;\n  startResizeDragging(direction: ResizeDirection): Promise<void>;\n  /** Moves the window with the pointer (the titlebar logo, once a press on it becomes a drag). */\n  startDragging?(): Promise<void>;\n  isMaximized(): Promise<boolean>;\n  onResized(handler: () => void): Promise<() => void>;\n};\nexport type Invoke = (command: string, args?: Record<string, unknown>) => Promise<unknown>;\n\nexport const isTauri = typeof window !== 'undefined' && '__TAURI_INTERNALS__' in window;\n/** macOS keeps a native (overlay) frame with traffic lights; Windows is frameless with our own caption buttons. */\nexport const os: 'macos' | 'windows' = typeof navigator !== 'undefined' && /Mac/i.test(navigator.userAgent) ? 'macos' : 'windows';\nexport const frameless = isTauri && os !== 'macos';\n\nexport function createWindowControls(invoke: Invoke, currentWindow: () => NativeWindow) {\n  return {\n    minimize: () => currentWindow().minimize().catch(() => {}),\n    toggleMaximize: () => currentWindow().toggleMaximize().catch(() => {}),\n    close: () => currentWindow().close().catch(() => {}),\n    startResize: (direction: ResizeDirection) => currentWindow().startResizeDragging(direction).catch(() => {}),\n    /** Starts a native window move while the pointer is down (nothing where the app's window lacks it, or in a preview). */\n    startDrag: () => { try { void currentWindow().startDragging?.().catch(() => {}); } catch { /* No native window. */ } },\n    onMaximizedChange: (cb: (maximized: boolean) => void) => {\n      const read = () => { currentWindow().isMaximized().then(cb).catch(() => {}); };\n      read();\n      return currentWindow().onResized(read);\n    },\n    /** The native system menu at a screen position (host `system_menu`; Windows only). */\n    systemMenu: (x: number, y: number) => invoke('window_system_menu', { x, y }).catch(() => {}),\n  };\n}\n"]}