diff --git a/packages/tempo/README.md b/packages/tempo/README.md
index a2b995a6..efcaf6d6 100644
--- a/packages/tempo/README.md
+++ b/packages/tempo/README.md
@@ -64,25 +64,31 @@ deno add npm:@magmacomputing/tempo # deno
```
-🌐 Browser & Lite Environments
+🌐 Browser & Native Environments
+
+For standard usage natively in the browser, use the pre-optimized **Global ESM Bundle**. It includes the entire core engine in a single file:
-For modern browsers using **Import Maps**:
```html
-```
-For rapid prototyping without a package manager (UMD):
-```html
-
+
```
-For granular "Lite" builds, see the [Full Installation Guide](https://magmacomputing.github.io/magma/doc/installation).
+> **Advanced Usage (Plugins & CDNs)**
+> If you need to use **Tempo Premium Plugins** natively in the browser, require granular module resolution, or want to use on-the-fly bundling CDNs (like `esm.sh`), please see our comprehensive [**Browser Installation Guide**](./doc/installation.md) for detailed import map configurations.
+
---
diff --git a/packages/tempo/doc/installation.md b/packages/tempo/doc/installation.md
index b0d20e8a..f68f88a8 100644
--- a/packages/tempo/doc/installation.md
+++ b/packages/tempo/doc/installation.md
@@ -93,27 +93,28 @@ const t = new Tempo();
---
-## 🌐 Browser (Modern ESM)
+## 🌐 Browser & Native Environments
-For browser environments that support **Import Maps**, you can use the granular ESM modules. This is the recommended way to use Tempo in the browser as it allows for better caching and modularity.
+Tempo provides multiple native browser distribution formats. Here is the quick breakdown of which approach to use:
+- **Standard Usage** (No plugins): Use the Global Bundle.
+- **Plugins without a bundler**: Use **esm.sh** (Easiest) OR use Granular Import Maps (Hardest, but maximum control).
+- **Plugins with a bundler** (Vite/Webpack): Do nothing. Your bundler handles the resolution automatically.
-### 1. Import Map Setup
-Add this to your `` to resolve the dependencies:
+### 1. The Global Bundle (Standard Usage)
-> Note: If you are self-hosting Tempo files, use the shipped `packages/tempo/importmap.json` as-is for your installed version instead of hand-authoring `dist/` paths.
+The easiest way to use Tempo natively in the browser is via the pre-optimized ESM bundle. It includes the entire core engine in a single file, eliminating network waterfall effects.
```html
```
-### 2. Implementation
```html
```
+### 2. Smart CDNs (The "Best-of-Both-Worlds")
+
+If you want to use **Premium Plugins** natively in the browser *without* configuring the massive granular import map required by static CDNs, use an on-the-fly bundling CDN like [esm.sh](https://esm.sh). It reads the package resolution rules and bundles the complex internal dependencies automatically.
+
+While you *could* import directly from the URL everywhere, the best practice is to use a tiny, simple import map just for your top-level packages. This allows you to keep your actual application code clean and standard:
+
+```html
+
+
+
+
+
+```
+
+### 3. Granular ESM (Advanced Plugin Architecture)
+
+If you are strictly using a static CDN (like jsdelivr) and require Premium Plugins, you must use the Granular ESM distribution. The bundled engine drops internal builder-utilities to keep the global scope clean, but plugins require them to resolve their own dependencies.
+
+To use Premium Plugins via static CDN, you must map the core library, its subpaths, and the internal licensing module directly to their granular equivalents:
+
+```html
+
+```
+
+> [!WARNING] Cache Busting
+> The jsdelivr CDN aggressively caches major version tags (like `@3`). When relying on precise granular resolution for plugins, it is highly recommended to use explicit patch versions (like `@3.0.1`) to avoid fetching mismatched or outdated sub-modules.
+
---
-## 📦 Browser (Legacy / Global Bundle)
+## 📦 Browser (UMD / Global Variable)
If you aren't using ESM or just want a simple `
+
diff --git a/packages/tempo/importmap.json b/packages/tempo/importmap.json
index 8bb124a2..a66cfcc3 100644
--- a/packages/tempo/importmap.json
+++ b/packages/tempo/importmap.json
@@ -1,11 +1,15 @@
{
+ "_comment": "This JSON is the sanctioned browser import map for this package. Entries using './dist/...' MUST resolve relative to where this JSON is hosted (typically alongside the package's dist folder). Note that '#tempo/license' is an internal/private specifier used at runtime, which is why it differs from the public '@magmacomputing/' exports.",
"imports": {
+ "tslib": "https://cdn.jsdelivr.net/npm/tslib@2.8.1/tslib.es6.mjs",
"@js-temporal/polyfill": "https://cdn.jsdelivr.net/npm/@js-temporal/polyfill@0.5/dist/index.esm.js",
"@magmacomputing/tempo": "https://cdn.jsdelivr.net/npm/@magmacomputing/tempo@3/dist/tempo.bundle.esm.js",
"@magmacomputing/tempo/core": "./dist/core.index.js",
"@magmacomputing/tempo/duration": "./dist/module/module.duration.js",
"@magmacomputing/tempo/mutate": "./dist/module/module.mutate.js",
"@magmacomputing/tempo/plugin": "./dist/plugin/plugin.index.js",
- "@magmacomputing/tempo/library": "./dist/library.index.js"
+ "@magmacomputing/tempo/library": "./dist/library.index.js",
+ "@magmacomputing/tempo/enums": "./dist/support/support.enum.js",
+ "#tempo/license": "./dist/plugin/license/license.validator.js"
}
}
\ No newline at end of file