waybetter 0.1.0 → 0.6.0

package/package.json

@@ -1,25 +1,66 @@
 {
   "name": "waybetter",
-  "version": "0.1.0",
+  "version": "0.6.0",
   "license": "GPL-3.0-or-later",
   "type": "module",
-  "description": "wayBetter: the framework for apps that extend the apps you already use in place (websites and web-built desktop apps). 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 and a privacy gate), `waybetter privacy-scan` (forbidden names in files, binaries, archives and git history), `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",
-    "electron",
+    "i18n",
     "betterdiscord",
     "plugins",
     "theming",
     "dom",
     "desktop"
   ],
+  "homepage": "https://waybetter.fyi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.crt.fyi/CRT/waybetter.git",
+    "directory": "packages/waybetter"
+  },
+  "bugs": {
+    "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"
@@ -44,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"
@@ -60,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"
@@ -84,25 +141,110 @@
       "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/privacy": "./cli/privacy.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,65 @@
+{
+  "$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 (format 2). Every wayBetter app reads the same file (catalog.json, signed by catalog.json.sig) 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,
+  "properties": {
+    "format": { "const": 2 },
+    "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", "url", "sha256", "size"],
+      "additionalProperties": false,
+      "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"], "description": "strings: a string pack (data that replaces the site's own UI strings; waybetter docs/STRING-PACKS.md)." },
+        "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. 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" } }
+            }
+          ]
+        }
+      }
+    }
+  }
+}