jskelet 0.6.14 → 0.6.15

package/CHANGELOG.md

@@ -17,6 +17,10 @@ one is listed under a **Breaking** heading.
 
 ### Added
 
+- `asset(name, { origin: "document" })` skips `build.assets.prefix` and
+  returns the site-origin `/assets/…` path. `icon()` always resolves the
+  sprite this way so SVG `<use href>` keeps working when other assets are
+  on a CDN (the origin still serves `public/assets/`).
 - Dev overlay **API** tab (between Performance and Server): outbound
   `fetch` calls for the current page — browser and SSR — with host
   rollup, duration, status, and a detail pane on click (component,

package/docs/07-yapilandirma.md

@@ -629,7 +629,7 @@ değişmez** — asset'ler origin'den servis edilir.
 
 | Alan | Tip | Varsayılan | Anlamı |
 | --- | --- | --- | --- |
-| `assets.prefix` | `string` | `""` | CDN origin; `asset()` URL öneki (sonunda `/` yok). Yalnızca config. Manifest diskte göreli kalır. |
+| `assets.prefix` | `string` | `""` | CDN origin; `asset()` URL öneki (sonunda `/` yok). Yalnızca config. Manifest diskte göreli kalır. `asset(name, { origin: "document" })` ve `icon()` sprite'ı öneksiz kalır. |
 | `assets.upload.enabled` | `boolean` | `false` | `true` veya config'te `bucket` doluysa açılır; açık `false` ezer. |
 | `assets.upload.bucket` | `string \| null` | `null` | **S3 bucket adı** (`static.ornek.com` gibi noktalı adlar geçerli; PutObject path-style kullanır) veya `bucket/key/prefix`. `https://…` şeması kabul edilmez — o `prefix`. |
 | `assets.upload.keyPrefix` | `string` | `""` | Nesne anahtarı öneki; bucket yolunda verilmişse o kazanır (`prefix` takma adı da kabul). |

package/docs/08-build.md

@@ -80,6 +80,10 @@ dosya adlarını okunur tutuyor. Hash'li olmaları sayesinde bu dosyalara
 - `asset(name)` manifest'te varsa hash'li URL'i, yoksa `/assets/<name>` döner.
   `build.assets.prefix` doluysa bu göreli yolun önüne CDN origin eklenir
   (manifest diskte göreli kalır).
+- `asset(name, { origin: "document" })` prefix'i atlar; site origin'indeki
+  `/assets/…` yolunu döner. SVG `<use href>` çapraz origin sprite
+  yüklemediği için `icon()` sprite'ı her zaman böyle çözer — origin hâlâ
+  `public/assets/` servis eder.
 - `hasAsset(name)` manifest'te olup olmadığını söyler.
 
 ### CDN prefix ve S3 upload
@@ -91,7 +95,8 @@ env → ECS task role → EC2 IMDS zincirinden. Açılınca:
    altındaki dosyaları S3'e PutObject ile kopyalar.
 2. Çalışma anında `asset()` / optimize görseller `build.assets.prefix` ile
    absolute CDN URL basar. Entry CDN'deyse esbuild chunk'ları göreli yolla aynı
-   host'a gider.
+   host'a gider. `icon()` sprite'ı ve `asset(name, { origin: "document" })`
+   site origin'inde kalır.
 
 Bucket adı noktalı olabilir (`static.ornek.com`); `https://…` şeması
 `prefix`'e yazılır. Config sözlüğü: [07-yapilandirma.md](./07-yapilandirma.md#build).
@@ -457,7 +462,9 @@ karşılaşmaması.
 - **Bazı Tailwind sınıfları çalışmıyor.** `@source` direktifi eksik olan bir
   dizinde yazılmışlar.
 - **İkon boş görünüyor.** Sprite'ta o sembol yok; dev'de `[icon] missing from sprite`
-  uyarısına bakın.
+  uyarısına bakın. CDN prefix açıkken sprite bilerek site origin'inde kalır
+  (`asset("sprite.svg", { origin: "document" })`); origin `public/assets/`
+  servis etmiyorsa `<use>` boş kalır.
 - **Island'lar hiç açılmıyor.** `main.js` manifest'te yok (entry dizini boş ya
   da build atlanmış) veya bir build hatası var.
 - **Dev'de sayfa aniden stilsiz kaldı.** Manifest ile diskteki dosya

package/docs/en/07-configuration.md

@@ -642,7 +642,7 @@ changes** — assets stay on the origin.
 
 | Field | Type | Default | Meaning |
 | --- | --- | --- | --- |
-| `assets.prefix` | `string` | `""` | CDN origin; prefix for `asset()` URLs (no trailing `/`). Config only. The on-disk manifest stays relative. |
+| `assets.prefix` | `string` | `""` | CDN origin; prefix for `asset()` URLs (no trailing `/`). Config only. The on-disk manifest stays relative. `asset(name, { origin: "document" })` and the `icon()` sprite stay unprefixed. |
 | `assets.upload.enabled` | `boolean` | `false` | Turns on when `true` or when `bucket` is set in config; explicit `false` wins. |
 | `assets.upload.bucket` | `string \| null` | `null` | **S3 bucket name** (dotted names like `static.example.com` are fine; PutObject uses path-style) or `bucket/key/prefix`. A `https://…` scheme is rejected — that belongs in `prefix`. |
 | `assets.upload.keyPrefix` | `string` | `""` | Object key prefix; a path on the bucket wins (`prefix` is accepted as an alias). |

package/docs/en/08-build.md

@@ -83,6 +83,10 @@ They are passed to templates automatically; in server code,
 - `asset(name)` returns the hashed URL if it is in the manifest, otherwise
   `/assets/<name>`. When `build.assets.prefix` is set, that relative path is
   prefixed with the CDN origin (the on-disk manifest stays relative).
+- `asset(name, { origin: "document" })` skips the prefix and returns the
+  site-origin `/assets/…` path. SVG `<use href>` cannot load a cross-origin
+  sprite, so `icon()` always resolves the sprite this way — the origin still
+  serves `public/assets/`.
 - `hasAsset(name)` tells you whether it is in the manifest.
 
 ### CDN prefix and S3 upload
@@ -94,7 +98,8 @@ resolve from env → ECS task role → EC2 IMDS. When enabled:
    directories in `include`) to S3.
 2. At runtime `asset()` / optimised images emit absolute CDN URLs via
    `build.assets.prefix`. When the entry script is on the CDN, esbuild chunks
-   resolve relatively on the same host.
+   resolve relatively on the same host. The `icon()` sprite and
+   `asset(name, { origin: "document" })` stay on the document origin.
 
 Bucket names may include dots (`static.example.com`); put `https://…` in
 `prefix`. Config reference: [07-configuration.md](./07-configuration.md#build).
@@ -473,7 +478,9 @@ directly does not end up facing an unstyled page.
 - **Some Tailwind classes do not work.** They were written in a directory whose
   `@source` directive is missing.
 - **An icon looks empty.** That symbol is not in the sprite; in dev, look for the
-  `[icon] missing from sprite` warning.
+  `[icon] missing from sprite` warning. With a CDN prefix the sprite stays on
+  the document origin on purpose (`asset("sprite.svg", { origin: "document" })`);
+  if the origin does not serve `public/assets/`, `<use>` stays blank.
 - **The islands never open.** `main.js` is not in the manifest (the entry
   directory is empty or the build was skipped) or there is a build error.
 - **The page suddenly went unstyled in dev.** The manifest and the file on disk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jskelet",
-  "version": "0.6.14",
+  "version": "0.6.15",
   "description": "A framework that feels like no framework: Express 5 + build-time .jsk SSR (optional EJS peer), vanilla JS islands, Tailwind v4 and an in-process HTML TTL cache.",
   "type": "module",
   "license": "MIT",

package/src/server/assets.js

@@ -9,6 +9,11 @@
  * `build.assets.prefix` doluysa HTML'e basılan URL'lere CDN origin eklenir;
  * manifest diskte göreli kalır. Dosya sistemi okumaları (`getSpriteIds`)
  * göreli yolu kullanır.
+ *
+ * Bazı varlıklar bilinçli olarak site origin'inde kalır: SVG `<use href>`
+ * çapraz origin sprite yüklemez. `asset(name, { origin: "document" })`
+ * prefix'i atlar; `icon()` sprite için bunu kullanır. Origin hâlâ
+ * `public/assets/` servis eder.
  */
 import fs from "node:fs";
 import path from "node:path";
@@ -17,7 +22,7 @@ import { getConfig } from "../config/index.js";
 
 const isDev = process.env.NODE_ENV === "development";
 
-/** @type {{ manifest: Record<string, string> } | null} */
+/** @type {{ manifest: Record<string, string>, generated: string } | null} */
 let cached = null;
 let warned = false;
 
@@ -38,13 +43,15 @@ function load() {
     }
   }
 
-  return { manifest };
+  return { manifest, generated };
 }
 
 function state() {
   // Dev'de her istekte yeniden okunur (watch build hash'leri değiştirir);
-  // prod'da bir kez.
-  if (isDev || !cached) cached = load();
+  // prod'da bir kez. `generated` yolu değiştiyse (test / başka kök) de
+  // yenilenir — aksi hâlde eski manifest takılı kalır.
+  const generated = getConfig().dirs.generated;
+  if (isDev || !cached || cached.generated !== generated) cached = load();
   return cached;
 }
 
@@ -82,11 +89,22 @@ function assetPath(name) {
 }
 
 /**
+ * @typedef {{ origin?: "cdn" | "document" }} AssetOptions
+ */
+
+/**
+ * Manifest'teki hash'li (veya yedek) URL.
+ *
  * @param {string} name Örn. "app.css", "main.js", "sprite.svg"
+ * @param {AssetOptions} [options]
+ *   `origin: "document"` → `build.assets.prefix` uygulanmaz; site
+ *   origin'indeki `/assets/…` yolu döner (varsayılan `"cdn"`).
  * @returns {string}
  */
-export function asset(name) {
-  return applyAssetPrefix(assetPrefix(), assetPath(name));
+export function asset(name, options = {}) {
+  const relative = assetPath(name);
+  if (options.origin === "document") return relative;
+  return applyAssetPrefix(assetPrefix(), relative);
 }
 
 /**

package/src/views/helpers/tags.js

@@ -195,6 +195,11 @@ export function preloadImage({ href, imagesrcset, imagesizes }) {
 /**
  * Phosphor ikonları — build zamanı üretilen SVG sprite'tan `<use>`.
  * `weight` sprite id'sine dahildir (regular/bold/fill).
+ *
+ * Sprite URL'si her zaman site origin'indedir (`asset(..., { origin:
+ * "document" })`). `<use href>` çapraz origin SVG yüklemez; CDN prefix
+ * açıkken bile `public/assets/sprite.<hash>.svg` aynı host'tan gelir.
+ *
  * @param {{ name: string, size?: number | string, weight?: string,
  *   class?: string, attrs?: Record<string, unknown> }} props
  * @returns {string}
@@ -208,7 +213,7 @@ export function icon(props) {
     attrs: extra = {},
   } = props;
 
-  const spritePath = asset("sprite.svg");
+  const spritePath = asset("sprite.svg", { origin: "document" });
   const id = `${toKebab(name)}-${weight}`;
 
   if (isDev && !warnedIcons.has(id)) {

package/types/server/assets.d.ts

@@ -6,11 +6,22 @@
  * @returns {string}
  */
 export declare function applyAssetPrefix(prefix: string, url: string): string;
+export type AssetOptions = {
+    origin?: "cdn" | "document";
+};
+/**
+ * @typedef {{ origin?: "cdn" | "document" }} AssetOptions
+ */
 /**
+ * Manifest'teki hash'li (veya yedek) URL.
+ *
  * @param {string} name Örn. "app.css", "main.js", "sprite.svg"
+ * @param {AssetOptions} [options]
+ *   `origin: "document"` → `build.assets.prefix` uygulanmaz; site
+ *   origin'indeki `/assets/…` yolu döner (varsayılan `"cdn"`).
  * @returns {string}
  */
-export declare function asset(name: string): string;
+export declare function asset(name: string, options?: AssetOptions): string;
 /**
  * @param {string} name
  * @returns {boolean}

package/types/views/helpers/tags.d.ts

@@ -60,6 +60,11 @@ export declare function preloadImage({ href, imagesrcset, imagesizes }: {
 /**
  * Phosphor ikonları — build zamanı üretilen SVG sprite'tan `<use>`.
  * `weight` sprite id'sine dahildir (regular/bold/fill).
+ *
+ * Sprite URL'si her zaman site origin'indedir (`asset(..., { origin:
+ * "document" })`). `<use href>` çapraz origin SVG yüklemez; CDN prefix
+ * açıkken bile `public/assets/sprite.<hash>.svg` aynı host'tan gelir.
+ *
  * @param {{ name: string, size?: number | string, weight?: string,
  *   class?: string, attrs?: Record<string, unknown> }} props
  * @returns {string}