waybetter 0.1.1 → 0.7.0

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "waybetter",
-  "version": "0.1.1",
+  "version": "0.7.0",
   "license": "GPL-3.0-or-later",
   "type": "module",
-  "description": "wayBetter: the framework for apps that run the apps you already use in a light native (Tauri) window and extend them in place. Page runtime (DOM/request hubs, plugins, theme color model, link routing, account reporting) and shell models (address bar, panes, profiles, palette, updates). No dependencies.",
+  "description": "wayBetter: the framework for apps that run the apps you already use in a light native (Tauri) window and extend them in place. Page runtime (DOM/request hubs, plugins, plugin UI kit with themed dialogs and toasts, theme API and theme JSON Schema, theme color model, link routing, account reporting, deck columns, i18n: ICU-lite messages, locale fallback, plugin strings, catalog checks and JSON Schemas), shell models (address bar, panes, decks, profiles, palette, updates), the shell frame (createShell: tabs, splits, address bar, titlebar, palette, account switcher, decks, workspaces, overlays, the language state; React + dockview peers), the panel (createPanel: an app's own tab with Appearance and the Theme Builder, plugins and custom CSS, the Store, Make, accounts, settings, backup and sync, developer mode, updates; the app adds its sections) and the Store: install screen and Store view React components (optional React peer), their state and catalog models, the store catalog JSON Schema and the `waybetter store build|sign|verify` command, `waybetter release windows|macos` (signed native releases and the update manifest, configured by waybetter.release.json; path-free builds), `waybetter build-env` (a build without the machine's paths) and `waybetter/build` (the page runtime bundle, with an optional esbuild peer). No dependencies.",
   "keywords": [
     "waybetter",
     "tauri",
+    "i18n",
     "betterdiscord",
     "plugins",
     "theming",
@@ -23,11 +24,43 @@
     "url": "https://git.crt.fyi/CRT/waybetter/issues"
   },
   "sideEffects": false,
+  "bin": {
+    "waybetter": "bin/waybetter.mjs"
+  },
   "exports": {
+    "./i18n": {
+      "types": "./dist/runtime/i18n.d.ts",
+      "import": "./dist/runtime/i18n.js"
+    },
+    "./i18n/check": {
+      "types": "./dist/runtime/i18nCheck.d.ts",
+      "import": "./dist/runtime/i18nCheck.js"
+    },
+    "./i18n/plugin": {
+      "types": "./dist/runtime/pluginI18n.d.ts",
+      "import": "./dist/runtime/pluginI18n.js"
+    },
+    "./i18n.schema.json": "./i18n.schema.json",
+    "./i18n-meta.schema.json": "./i18n-meta.schema.json",
+    "./i18n-config.schema.json": "./i18n-config.schema.json",
+    "./languages.schema.json": "./languages.schema.json",
+    "./locales/*.json": "./locales/*.json",
     "./runtime/accountReport": {
       "types": "./dist/runtime/accountReport.d.ts",
       "import": "./dist/runtime/accountReport.js"
     },
+    "./runtime/column": {
+      "types": "./dist/runtime/column.d.ts",
+      "import": "./dist/runtime/column.js"
+    },
+    "./runtime/commands": {
+      "types": "./dist/runtime/commands.d.ts",
+      "import": "./dist/runtime/commands.js"
+    },
+    "./runtime/devErrors": {
+      "types": "./dist/runtime/devErrors.d.ts",
+      "import": "./dist/runtime/devErrors.js"
+    },
     "./runtime/domHub": {
       "types": "./dist/runtime/domHub.d.ts",
       "import": "./dist/runtime/domHub.js"
@@ -52,14 +85,26 @@
       "types": "./dist/runtime/site.d.ts",
       "import": "./dist/runtime/site.js"
     },
+    "./runtime/themeApi": {
+      "types": "./dist/runtime/themeApi.d.ts",
+      "import": "./dist/runtime/themeApi.js"
+    },
     "./runtime/themeTokens": {
       "types": "./dist/runtime/themeTokens.d.ts",
       "import": "./dist/runtime/themeTokens.js"
     },
+    "./runtime/ui": {
+      "types": "./dist/runtime/ui.d.ts",
+      "import": "./dist/runtime/ui.js"
+    },
     "./runtime/*": {
       "types": "./dist/runtime/*.d.ts",
       "import": "./dist/runtime/*.js"
     },
+    "./shell/messages": {
+      "types": "./dist/shell/messages.d.ts",
+      "import": "./dist/shell/messages.js"
+    },
     "./shell/addressModel": {
       "types": "./dist/shell/addressModel.d.ts",
       "import": "./dist/shell/addressModel.js"
@@ -68,6 +113,10 @@
       "types": "./dist/shell/chrome.d.ts",
       "import": "./dist/shell/chrome.js"
     },
+    "./shell/deckModel": {
+      "types": "./dist/shell/deckModel.d.ts",
+      "import": "./dist/shell/deckModel.js"
+    },
     "./shell/linkDrop": {
       "types": "./dist/shell/linkDrop.d.ts",
       "import": "./dist/shell/linkDrop.js"
@@ -92,25 +141,109 @@
       "types": "./dist/shell/windowControls.d.ts",
       "import": "./dist/shell/windowControls.js"
     },
+    "./shell/storeModel": {
+      "types": "./dist/shell/storeModel.d.ts",
+      "import": "./dist/shell/storeModel.js"
+    },
+    "./shell/storeMessages": {
+      "types": "./dist/shell/storeMessages.d.ts",
+      "import": "./dist/shell/storeMessages.js"
+    },
+    "./shell/installController": {
+      "types": "./dist/shell/installController.d.ts",
+      "import": "./dist/shell/installController.js"
+    },
+    "./shell/InstallDialog": {
+      "types": "./dist/shell/InstallDialog.d.ts",
+      "import": "./dist/shell/InstallDialog.js"
+    },
+    "./shell/StoreView": {
+      "types": "./dist/shell/StoreView.d.ts",
+      "import": "./dist/shell/StoreView.js"
+    },
+    "./shell/store.css": "./dist/shell/store.css",
+    "./shell/frame": {
+      "types": "./dist/shell/frame/index.d.ts",
+      "import": "./dist/shell/frame/index.js"
+    },
+    "./shell/frame/*.css": "./dist/shell/frame/*.css",
+    "./shell/frame/*": {
+      "types": "./dist/shell/frame/*.d.ts",
+      "import": "./dist/shell/frame/*.js"
+    },
+    "./shell/panel": {
+      "types": "./dist/shell/panel/index.d.ts",
+      "import": "./dist/shell/panel/index.js"
+    },
+    "./shell/panel/*.css": "./dist/shell/panel/*.css",
+    "./shell/panel/*": {
+      "types": "./dist/shell/panel/*.d.ts",
+      "import": "./dist/shell/panel/*.js"
+    },
     "./shell/*": {
       "types": "./dist/shell/*.d.ts",
       "import": "./dist/shell/*.js"
-    }
+    },
+    "./theme.schema.json": "./theme.schema.json",
+    "./icons.schema.json": "./icons.schema.json",
+    "./store-catalog.schema.json": "./store-catalog.schema.json",
+    "./cli/store": "./cli/store.mjs",
+    "./cli/release": "./cli/release.mjs",
+    "./cli/i18n": "./cli/i18n.mjs",
+    "./cli/buildenv": "./cli/buildenv.mjs",
+    "./build": "./build/runtime.mjs",
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "bin",
+    "build",
+    "cli",
+    "theme.schema.json",
+    "icons.schema.json",
+    "store-catalog.schema.json",
+    "i18n.schema.json",
+    "i18n-meta.schema.json",
+    "i18n-config.schema.json",
+    "languages.schema.json",
+    "locales",
+    "windows",
     "README.md",
     "LICENSE"
   ],
   "engines": {
     "node": ">=18.0.0"
   },
+  "peerDependencies": {
+    "esbuild": ">=0.20.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "dockview": ">=4.0.0",
+    "acorn": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "dockview": {
+      "optional": true
+    },
+    "acorn": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p ../runtime/tsconfig.build.json --outDir dist/runtime --inlineSources --declarationMap false && tsc -p ../shell/tsconfig.build.json --outDir dist/shell --inlineSources --declarationMap false",
-    "test": "cd ../.. && node --test packages/runtime/tests/*.test.ts packages/shell/tests/*.test.ts",
+    "build": "node scripts/build.mjs",
+    "test": "cd ../.. && node --test packages/runtime/tests/*.test.ts packages/shell/tests/*.test.ts packages/waybetter/tests/*.test.mjs",
     "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {

package/store-catalog.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/waybetter/store-catalog.schema.json",
+  "title": "wayBetter Store catalog",
+  "description": "The shared, signed catalog of the wayBetter Store, in two files built from one source: catalog.json (format 2: only theme, plugin and strings items, which every app knows) and catalog.v3.json (format 3: every kind, read first by apps that know the newer kinds; they fall back to catalog.json). Each is signed by its own .sig. Every wayBetter app reads the same files and keeps only the items whose `apps` list its id. Apps verify the Ed25519 signature over the exact bytes first, then these rules (waybetter-host store::catalog), then each download's sha256 and size. Build it with `waybetter store build`, sign it with `waybetter store sign`.",
+  "type": "object",
+  "required": ["format", "name", "generatedAt", "items"],
+  "additionalProperties": false,
+  "if": { "properties": { "format": { "const": 2 } } },
+  "then": { "properties": { "items": { "items": { "properties": { "kind": { "enum": ["theme", "plugin", "strings"] } } } } } },
+  "properties": {
+    "format": { "enum": [2, 3], "description": "2: only theme, plugin and strings items (an app from before a kind existed refuses a whole catalog that lists it). 3: every kind." },
+    "name": { "type": "string" },
+    "generatedAt": { "type": "string", "description": "When the catalog was built (RFC 3339, UTC)." },
+    "items": { "type": "array", "maxItems": 500, "items": { "$ref": "#/$defs/item" } }
+  },
+  "$defs": {
+    "text": { "type": "string", "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]*$" },
+    "https": { "type": "string", "pattern": "^https://", "maxLength": 2048 },
+    "color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" },
+    "item": {
+      "type": "object",
+      "required": ["apps", "kind", "id", "name", "version"],
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "builtin" } } },
+          "then": { "not": { "anyOf": [{ "required": ["url"] }, { "required": ["sha256"] }, { "required": ["size"] }, { "required": ["file"] }, { "required": ["permissions"] }, { "required": ["colors"] }, { "required": ["language"] }] } },
+          "else": { "required": ["url", "sha256", "size"] }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "icons" } } },
+          "then": { "not": { "anyOf": [{ "required": ["file"] }, { "required": ["permissions"] }, { "required": ["colors"] }, { "required": ["language"] }] }, "properties": { "size": { "maximum": 120000 } } }
+        }
+      ],
+      "properties": {
+        "apps": {
+          "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true,
+          "description": "The wayBetter apps this item is for (app ids such as \"x\"). An app never shows, stages or installs another app's items.",
+          "items": { "type": "string", "pattern": "^[a-z0-9-]{1,32}$" }
+        },
+        "kind": { "enum": ["theme", "plugin", "strings", "icons", "builtin"], "description": "strings: a string pack (data that replaces the site's own UI strings; waybetter docs/STRING-PACKS.md). icons: an icon pack (`*.icons.json`, data only, at most 120 KB). builtin: a feature that ships inside the app (an area plugin), listed in the Store as built in with its switch; it has no url, sha256 or size because there is nothing to download." },
+        "id": { "type": "string", "pattern": "^[a-z0-9-]{1,40}$", "description": "Unique per app and kind." },
+        "name": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "minLength": 1, "maxLength": 60 },
+        "author": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "maxLength": 60 },
+        "version": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "minLength": 1, "maxLength": 32 },
+        "description": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "maxLength": 600 },
+        "category": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "maxLength": 32, "description": "Shown as `wb.store.category.<id>` when the framework catalogs name it (reading, writing, filters, focus, tools, dark, light), else as is." },
+        "tags": { "type": "array", "maxItems": 12, "items": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "maxLength": 32 } },
+        "url": { "$ref": "#/$defs/https", "description": "The file (not on a `builtin` item). It must be on the reading app's download hosts (waybetter.fyi, cdn1.crt.fyi, git.crt.fyi raw files by default): https, default port, no credentials, no fragment." },
+        "file": { "type": "string", "pattern": "^[A-Za-z0-9_\\-. ]+\\.plugin\\.js$", "maxLength": 128, "description": "Plugins only: the file name it is installed under (unique per app, ignoring case)." },
+        "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 2097152 },
+        "preview": { "$ref": "#/$defs/https" },
+        "permissions": {
+          "description": "Plugins only: the declared @permissions; null = no @permissions line (legacy, full API).",
+          "anyOf": [
+            { "type": "null" },
+            { "type": "array", "uniqueItems": true, "items": { "enum": ["storage", "ui", "clipboard", "account", "users", "commands", "network", "network:none"] } }
+          ]
+        },
+        "language": { "type": "string", "pattern": "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$", "description": "String packs only (required there): the language tag of the pack." },
+        "license": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "minLength": 1, "maxLength": 60, "description": "The licence of the item (an SPDX id such as CC-BY-4.0, or a short name)." },
+        "credits": { "allOf": [{ "$ref": "#/$defs/text" }], "type": "string", "maxLength": 600, "description": "Who made, translated or reviewed it, plain text." },
+        "colors": {
+          "description": "Themes only: swatches for the card.",
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object", "required": ["bg", "text", "accent"], "additionalProperties": false,
+              "properties": { "bg": { "$ref": "#/$defs/color" }, "surface": { "$ref": "#/$defs/color" }, "text": { "$ref": "#/$defs/color" }, "accent": { "$ref": "#/$defs/color" } }
+            }
+          ]
+        }
+      }
+    }
+  }
+}