@c9up/aurora 0.1.13 → 0.1.15

package/README.md

@@ -24,7 +24,7 @@ providers: [
 
 ## Entry points
 
-- `@c9up/aurora` — main API: reactive primitives (`signal`/`effect`/`html`/`component`/`hydrate`) plus the client toolkit — `WebStorage`/`persistedSignal`, reactive browser signals (`prefersDark`/`online`/`windowSize`/…), SPA navigation (`navigate`/`queryParam`), `cookie`/`clipboard`/`share`, the `HttpClient` fetch wrapper, `command()` (async action + reactive loading/data/error), and `form()` (reactive form controller; optional rune validation + rosetta i18n)
+- `@c9up/aurora` — main API: reactive primitives (`signal`/`effect`/`html`/`component`/`hydrate`) plus the client toolkit — `WebStorage`/`persistedSignal`, reactive browser signals (`prefersDark`/`online`/`windowSize`/…), SPA navigation (`navigate`/`queryParam`), `cookie`/`clipboard`/`share`, the `HttpClient` fetch wrapper, `createRpcClient()` (JSON-RPC 2.0), `command()` (async action + reactive loading/data/error), `form()` (reactive form controller; optional rune validation + rosetta i18n), `urlFor()` (isomorphic named-route URLs, paired with Ream's `router.namedManifest()`), and `cn()` (zero-dependency Tailwind v4 class merge — `clsx` + `tailwind-merge` reimplemented)
 - `@c9up/aurora/provider` — Ream IoC provider
 - `@c9up/aurora/services/main` — container service accessor
 - `@c9up/aurora/relay` — realtime adapter

package/dist/AuroraManager.d.ts

@@ -22,13 +22,31 @@ export interface AuroraManagerConfig {
      * Override only if you want to serve a custom build.
      */
     auroraDistRoot?: string;
+    /**
+     * URL prefix the asset routes mount under. The aurora runtime is served
+     * from `<assetsPrefix>/aurora/*` and the app's pages from
+     * `<assetsPrefix>/pages/*`, and the SSR importmap + page URLs derive from
+     * it. Default `/_assets` (the leading underscore namespaces framework
+     * assets away from app routes, Next.js `/_next` style). Set e.g. `/assets`
+     * for an underscore-free scheme. An explicit `pages.urlPrefix` still wins.
+     */
+    assetsPrefix?: string;
 }
 export declare class AuroraManager {
     readonly pages: Pages;
     readonly auroraDistRoot: string;
+    /** Resolved asset prefix (default `/_assets`). */
+    readonly assetsPrefix: string;
+    /** Mount path for the aurora runtime — `<assetsPrefix>/aurora`. */
+    readonly auroraAssetPath: string;
+    /** Mount path for the app's pages — `<assetsPrefix>/pages`. */
+    readonly pageAssetPath: string;
     constructor(config: AuroraManagerConfig);
     /**
-     * SSR + hydrate + ship the document.
+     * SSR + hydrate + ship the document. The importmap default points
+     * `@c9up/aurora` at this manager's `assetsPrefix`; a caller's
+     * `options.importmap` still overrides (e.g. to remap to an app-curated
+     * browser entry).
      */
     render(ctx: RenderHttpContext, name: string, props: unknown, options?: RenderPageOptions): Promise<void>;
     /**

package/dist/AuroraManager.js

@@ -17,18 +17,46 @@ import { Pages } from "./Pages.js";
 import { renderPage, } from "./server/renderPage.js";
 import { serveAssets } from "./server/serveAssets.js";
 const DEFAULT_AURORA_DIST = resolvePath(dirname(fileURLToPath(import.meta.url)), "../dist");
+/** Normalize an asset prefix: ensure a leading slash, drop trailing slashes. */
+function normalizePrefix(prefix) {
+    const withLead = prefix.startsWith("/") ? prefix : `/${prefix}`;
+    return withLead.replace(/\/+$/, "") || "/";
+}
 export class AuroraManager {
     pages;
     auroraDistRoot;
+    /** Resolved asset prefix (default `/_assets`). */
+    assetsPrefix;
+    /** Mount path for the aurora runtime — `<assetsPrefix>/aurora`. */
+    auroraAssetPath;
+    /** Mount path for the app's pages — `<assetsPrefix>/pages`. */
+    pageAssetPath;
     constructor(config) {
-        this.pages = new Pages(config.pages);
+        this.assetsPrefix = normalizePrefix(config.assetsPrefix ?? "/_assets");
+        this.auroraAssetPath = `${this.assetsPrefix}/aurora`;
+        this.pageAssetPath = `${this.assetsPrefix}/pages`;
+        // Pages serve their compiled JS from the same prefix unless the app
+        // pins an explicit urlPrefix.
+        this.pages = new Pages({
+            ...config.pages,
+            urlPrefix: config.pages.urlPrefix ?? this.pageAssetPath,
+        });
         this.auroraDistRoot = config.auroraDistRoot ?? DEFAULT_AURORA_DIST;
     }
     /**
-     * SSR + hydrate + ship the document.
+     * SSR + hydrate + ship the document. The importmap default points
+     * `@c9up/aurora` at this manager's `assetsPrefix`; a caller's
+     * `options.importmap` still overrides (e.g. to remap to an app-curated
+     * browser entry).
      */
     render(ctx, name, props, options) {
-        return renderPage(ctx, this.pages, name, props, options);
+        return renderPage(ctx, this.pages, name, props, {
+            ...options,
+            importmap: {
+                "@c9up/aurora": `${this.auroraAssetPath}/index.js`,
+                ...options?.importmap,
+            },
+        });
     }
     /**
      * Handler for aurora's pre-built ESM runtime. Mount on

package/dist/AuroraProvider.js

@@ -63,8 +63,10 @@ export default class AuroraProvider {
             return;
         const router = this.app.container.resolve("router");
         const manager = this.app.container.resolve(AuroraManager);
-        router.get("/_assets/aurora/*", adaptHandler(manager.auroraAssetsHandler()));
-        router.get("/_assets/pages/*", adaptHandler(manager.pageAssetsHandler()));
+        // Mount paths derive from the configured `assetsPrefix` (default
+        // `/_assets`) — set `config.aurora.assetsPrefix` to change the scheme.
+        router.get(`${manager.auroraAssetPath}/*`, adaptHandler(manager.auroraAssetsHandler()));
+        router.get(`${manager.pageAssetPath}/*`, adaptHandler(manager.pageAssetsHandler()));
     }
     async ready() { }
     async shutdown() { }

package/dist/cn.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `cn` — class-name composition with Tailwind conflict resolution, reimplemented
+ * from scratch with ZERO dependencies (no clsx, no tailwind-merge).
+ *
+ *   cn('px-2 py-1', isActive && 'bg-indigo-600', props.class)
+ *   cn('px-2', 'px-4')                // → 'px-4'  (later wins within a group)
+ *   cn('mr-4', 'mr-8')               // → 'mr-8'  (dedup is the whole point)
+ *   cn('text-red-500', 'text-sm')     // → 'text-red-500 text-sm' (different groups)
+ *   cn('hover:p-2', 'hover:p-4', 'p-1')// → 'p-1 hover:p-4' (variant-scoped)
+ *
+ * Two parts:
+ *   1. {@link clsx} — flatten strings / numbers / arrays / objects into a class
+ *      string, dropping falsy values (full clsx semantics).
+ *   2. {@link twMerge} — within the SAME variant stack (`hover:`, `md:`, `!`, …),
+ *      keep only the LAST class of each conflicting Tailwind group; unknown
+ *      classes never conflict and are always kept, in source order.
+ *
+ * Targets the standard Tailwind v4 utility set. Node-free — part of aurora's
+ * client runtime.
+ */
+export type ClassValue = ClassValue[] | Record<string, unknown> | string | number | bigint | null | boolean | undefined;
+/** clsx-equivalent: join truthy class values (strings, numbers, arrays, objects). */
+export declare function clsx(...inputs: ClassValue[]): string;
+/** Resolve Tailwind class conflicts: within a variant scope, the last class of each group wins. */
+export declare function twMerge(classList: string): string;
+/** Compose class values (clsx) then resolve Tailwind conflicts (twMerge). */
+export declare function cn(...inputs: ClassValue[]): string;