@stacksjs/i18n 0.70.160 → 0.70.162

package/README.md

@@ -15,6 +15,10 @@
 
 Stacks is a rapid development framework, where the goal is to _help you_ create & maintain frontends, backends, and clouds—without having to worry about the boilerplate. _An all-in-one toolkit that meets all your full stack needs._
 
+[![Stacks runtime architecture](./docs/diagrams/stacks-runtime.png)](./docs/diagrams/stacks-runtime.html)
+
+_Open the diagram for light and dark themes plus SVG, PNG, JPEG, and WebP exports._
+
 - Web & Desktop Applications _(including system tray apps)_
 - Serverless & Traditional APIs
 - Cloud Infrastructure Creation & Maintenance
@@ -32,23 +36,34 @@ As a developer, Stacks helps you every step along the way—in beginner & expert
 
 ## Prerequisites
 
-Stacks runs on [Bun](https://bun.sh). You'll need:
+Stacks uses [Pantry](https://pantry.dev) to provision Bun, Git, SQLite, and the project-specific tools declared by the framework. You'll need:
+
+- **Pantry** - install it with `curl -fsSL https://pantry.dev | bash`, then run `pantry bootstrap` once to configure your shell.
+- **macOS, Linux, or WSL** - Windows-native support is on the roadmap. The current toolchain assumes a POSIX shell.
 
-- **Bun ≥ 1.3.0** — install with `curl -fsSL https://bun.sh/install | bash`, or upgrade an existing install with `bun upgrade`.
-- **macOS, Linux, or WSL** — Windows-native is on the roadmap; today the toolchain assumes a POSIX shell.
-- **Node.js is NOT required.** Bun handles the JS/TS runtime, package management, and bundling.
+Pantry installs and pins Bun 1.3 or newer for each Stacks project, then keeps the rest of the machine and project dependencies in sync. Features such as PostgreSQL, Redis, and cloud deployment add their requirements through the same Pantry manifest where possible, with feature-specific configuration documented alongside them.
 
-That's it for the framework itself. Individual features (Postgres, Redis, AWS deploys, etc.) bring their own prereqs — each is called out where it matters in the docs.
+Stacks pins Pantry [`v0.10.36`](https://github.com/pantry-pm/pantry/tree/v0.10.36)
+as an external toolchain contract. Resolution sources, lockfile and integrity
+rules, lifecycle trust, registry routes, authentication, storage, and failure
+modes are documented in the source-linked whitepaper references for the
+[package manager](https://whitepaper.stacksjs.com/reference/package-manager) and
+[registry](https://whitepaper.stacksjs.com/reference/registry). Stacks does not
+redefine those behaviors.
 
 ## Get Started
 
-The fastest path, assuming Bun is installed:
+The fastest path after Pantry is installed:
 
 ```bash
-bunx @stacksjs/buddy new my-project
+panx @stacksjs/buddy new my-project
 ```
 
-A one-line installer (`curl -Ssf stacksjs.com/install | sh`) is also planned and will appear here once it lands; for now the `bunx` form above is the supported install path.
+Pantry executes Buddy in an isolated environment and provisions the generated project's declared toolchain during setup.
+
+For frontend experiments in the browser, open the live stx starter:
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/fork/github/stacksjs/stackblitz?title=Stacks%20Starter)
 
 ## Usage
 
@@ -76,7 +91,7 @@ buddy --help # view help menu
 
 buddy new my-project # creates a new Stacks project
 buddy install # installs dependencies
-buddy add # adds a stack or dependency
+buddy add calendar # pulls a registered project-shaped stack into this project
 buddy fresh # fresh reinstall of all deps (--force skips the confirmation)
 buddy clean # removes all deps (--force skips the confirmation)
 buddy setup # sets up the project initially
@@ -113,7 +128,7 @@ buddy build # select a specific build (follow CLI prompts)
 buddy build:frontend # builds the frontend (aliases: build:views, build:pages)
 buddy build:desktop # builds Desktop application
 buddy build:functions # builds function library
-buddy build:components # builds Vue component library & Web Component library
+buddy build:components # builds the STX component library and Web Component library
 buddy build:web-components # builds framework agnostic Web Component library (i.e. Custom Elements)
 buddy build:cli # builds the Buddy CLI binary
 buddy build:server # builds the Stacks cloud server (Docker image)
@@ -141,7 +156,7 @@ buddy make:migration create_cars_table # creates a cars migration file
 buddy make:factory cars # creates a Car factory file
 buddy make:notification welcome-email # bootstraps a welcome-email notification
 buddy make:lang de # bootstraps a lang/de.yml language file
-buddy make:stack my-plugin # scaffolds a publishable stack/plugin (new project? use `bunx @stacksjs/buddy new`)
+buddy make:stack my-plugin # scaffolds a project-shaped registry stack (new project? use `panx @stacksjs/buddy new`)
 
 buddy migrate # runs database migrations
 buddy migrate:fresh # drops all tables & re-runs migrations (destroys all data; --seed reseeds)
@@ -266,7 +281,6 @@ _Develop serverless (or server) functions with countless helpers to build scalab
 - 💾 **Storage** _a secure-by-default File API that feels right_
 - 🧪 **Tinker** _a powerful TypeScript REPL_
 - 🌪️ **Validation** _e2e type-safety (true frontend & backend harmony)_
-- 🎯 **X-Ray** _all you need to debug, log & analyze_
 
 ### Cloud Development
 
@@ -306,7 +320,7 @@ Convention over configuration, while staying wholly configurable. _No more boile
 - 🚗 **Auto Imports** _your components & functions, including date, string, array, & object helpers_
 - ⏩ **Code Snippets** _goodbye to the boilerplate code—thank you Sarah Drasner_
 - 🔤 **Spell Checker** _be notified once there are typos_
-- 🛠️ **Essential Utilities** _powers at your fingertips. Collections, VueUse, and more_
+- 🛠️ **Essential Utilities** _powers at your fingertips. Collections, STX composables, and more_
 - 👥 **Team Management** _manage your team & their permissions_
 - 🧪 **Streamlined Testing** _unit & e2e tests powered by Bun, Vitest & Playwright_
 

package/dist/translator.d.ts

@@ -48,7 +48,7 @@ export declare function tm(key: string, locale?: string): TranslationMessages |
  */
 export declare function createI18n(options?: Partial<I18nConfig>): I18n;
 /**
- * Use i18n composable (for Vue-like usage)
+ * Use the i18n composable from an STX component.
  */
 export declare function useI18n(options?: Partial<I18nConfig>): I18nInstance;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksjs/i18n",
-  "version": "0.70.160",
+  "version": "0.70.162",
   "description": "Internationalization system for Stacks.js applications",
   "type": "module",
   "sideEffects": false,
@@ -40,7 +40,7 @@
     "@stacksjs/ts-i18n": "^0.1.9"
   },
   "devDependencies": {
-    "@stacksjs/development": "0.70.160"
+    "@stacksjs/development": "0.70.162"
   },
   "publishConfig": {
     "exports": {