ultimate-jekyll-manager 0.0.299 → 0.0.301

package/CLAUDE.md

@@ -259,6 +259,34 @@ That's it! No HTML needed. The UJ pricing layout reads `page.resolved.pricing` a
 
 **Asset Loading:** Page-specific CSS/JS files are automatically included based on the page's canonical path. Override with `asset_path` frontmatter.
 
+### Webpack Import Aliases
+
+UJM defines two webpack aliases (in `src/gulp/tasks/webpack.js`) for importing assets in JavaScript:
+
+| Alias | Resolves To | Purpose |
+|-------|------------|---------|
+| `__main_assets__` | `[UJM package]/dist/assets` | UJM's own built-in assets (core modules, libraries, pages) |
+| `__project_assets__` | `[consuming project]/src/assets` | The consuming project's custom assets |
+
+**`__main_assets__`** — Import UJM libraries and core modules:
+```javascript
+import { FormManager } from '__main_assets__/js/libs/form-manager.js';
+import authorizedFetch from '__main_assets__/js/libs/authorized-fetch.js';
+import { getPrerenderedIcon } from '__main_assets__/js/libs/prerendered-icons.js';
+```
+
+**`__project_assets__`** — Import consuming project's own assets:
+```javascript
+// Used in src/index.js to load project-specific page modules
+import(`__project_assets__/js/pages/${pageModulePath}`)
+```
+
+**How they work together:** `src/index.js` loads page modules from both aliases — first from `__main_assets__` (UJM defaults), then from `__project_assets__` (project overrides/extensions). If a project module doesn't exist, it gracefully skips. This enables a layered system where UJM provides defaults and consuming projects can extend or override page behavior.
+
+**When to use which:**
+- **`__main_assets__`** — When importing UJM-provided libraries, core modules, or referencing UJM's built-in page scripts
+- **`__project_assets__`** — When a consuming project needs to import its own custom assets from within UJM-managed code
+
 ### Page Module Structure
 
 All page modules must follow this standardized pattern:

package/README.md

@@ -723,7 +723,34 @@ Internal tracking system modeled after UTM for cross-property user journey track
   * Language
     * https://www.freepik.com/icon/language_484531#fromView=family&page=1&position=0&uuid=651a2f0f-9023-4063-a495-af9a4ef72304
 
-### Webpack
+### Webpack Import Aliases
+
+UJM defines two webpack aliases (in `src/gulp/tasks/webpack.js`) for importing assets in JavaScript:
+
+| Alias | Resolves To | Purpose |
+|-------|------------|---------|
+| `__main_assets__` | `[UJM package]/dist/assets` | UJM's own built-in assets (core modules, libraries, pages) |
+| `__project_assets__` | `[consuming project]/src/assets` | The consuming project's custom assets |
+
+**`__main_assets__`** — Import UJM libraries and core modules:
+```javascript
+import { FormManager } from '__main_assets__/js/libs/form-manager.js';
+import authorizedFetch from '__main_assets__/js/libs/authorized-fetch.js';
+import { getPrerenderedIcon } from '__main_assets__/js/libs/prerendered-icons.js';
+```
+
+**`__project_assets__`** — Import consuming project's own assets:
+```javascript
+// Used in src/index.js to load project-specific page modules
+import(`__project_assets__/js/pages/${pageModulePath}`)
+```
+
+**How they work together:** `src/index.js` loads page modules from both aliases — first from `__main_assets__` (UJM defaults), then from `__project_assets__` (project overrides/extensions). If a project module doesn't exist, it gracefully skips. This enables a layered system where UJM provides defaults and consuming projects can extend or override page behavior.
+
+**When to use which:**
+- **`__main_assets__`** — When importing UJM-provided libraries, core modules, or referencing UJM's built-in page scripts
+- **`__project_assets__`** — When a consuming project needs to import its own custom assets from within UJM-managed code
+
 ## Dev Flags
 Add this to any js file to ONLY run in development mode (it will be excluded in production builds):
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "0.0.299",
+  "version": "0.0.301",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "exports": {
@@ -77,7 +77,7 @@
     "cheerio": "^1.2.0",
     "chrome-launcher": "^1.2.1",
     "dotenv": "^17.3.1",
-    "fast-xml-parser": "^5.5.1",
+    "fast-xml-parser": "^5.5.2",
     "fs-jetpack": "^5.1.0",
     "glob": "^13.0.6",
     "gulp-clean-css": "^4.3.0",
@@ -101,7 +101,7 @@
     "sass": "^1.98.0",
     "spellchecker": "^3.7.1",
     "through2": "^4.0.2",
-    "web-manager": "^4.1.19",
+    "web-manager": "^4.1.21",
     "webpack": "^5.105.4",
     "wonderful-fetch": "^1.3.4",
     "wonderful-version": "^1.3.2",