npm - nukejs - Versions diffs - 0.0.12 → 0.0.13 - Mend

nukejs 0.0.12 → 0.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/builder.js CHANGED Viewed

@@ -41,6 +41,8 @@ function processDist(dir) {
 }
 const PUBLIC_STEMS = /* @__PURE__ */ new Set([
   "index",
+  "html-store",
+  // exported types (TitleValue, LinkTag, MetaTag, …) live here
   "use-html",
   "use-router",
   "use-request",

package/dist/hmr-bundle.js CHANGED Viewed

@@ -28,6 +28,16 @@ function hmr() {
         }
         return;
       }
+      if (msg.type === "layout-reload") {
+        const base = msg.base === "/" ? "" : msg.base;
+        const pathname = window.location.pathname;
+        const isUnder = pathname === (base || "/") || pathname.startsWith(base + "/");
+        if (isUnder) {
+          log.info("[HMR] Layout changed:", msg.base);
+          navigate(pathname + window.location.search);
+        }
+        return;
+      }
       if (msg.type === "replace") {
         log.info("[HMR] Component changed:", msg.component);
         navigate(window.location.pathname + window.location.search);

package/dist/hmr.js CHANGED Viewed

@@ -29,6 +29,9 @@ function buildPayload(filename) {
       return { type: "replace", component: stem };
     }
     const url = pageFileToUrl(normalized);
+    if (stem === "layout") {
+      return { type: "layout-reload", base: url };
+    }
     return { type: "reload", url };
   }
   const ext = path.extname(filename).toLowerCase();

package/dist/html-store.d.ts ADDED Viewed

@@ -0,0 +1,128 @@
+/**
+ * html-store.ts — Per-Request HTML Head Store
+ *
+ * Provides a request-scoped store that server components can write to via
+ * `useHtml()` during SSR.  The accumulated values are flushed into the
+ * rendered HTML document after the component tree is fully rendered.
+ *
+ * Why globalThis?
+ *   Node's module system may import this file multiple times if the page
+ *   module and the nukejs package resolve to different copies (e.g. when
+ *   running from source in dev with tsx).  Using a well-known Symbol on
+ *   globalThis guarantees all copies share the same store instance.
+ *
+ * Request isolation:
+ *   runWithHtmlStore() creates a fresh store before rendering and clears it
+ *   in the `finally` block, so concurrent requests cannot bleed into each other.
+ *
+ * Title resolution:
+ *   Layouts and pages can both call useHtml({ title: … }).  Layouts typically
+ *   pass a template function:
+ *
+ *     useHtml({ title: (prev) => `${prev} | Acme` })
+ *
+ *   Operations are collected in render order (outermost layout first, page
+ *   last) then resolved *in reverse* so the page's string value is the base
+ *   and layout template functions wrap outward.
+ */
+/** A page sets a literal string; a layout wraps with a template function. */
+export type TitleValue = string | ((prev: string) => string);
+export interface HtmlAttrs {
+    lang?: string;
+    class?: string;
+    style?: string;
+    dir?: string;
+    [attr: string]: string | undefined;
+}
+export interface BodyAttrs {
+    class?: string;
+    style?: string;
+    [attr: string]: string | undefined;
+}
+export interface MetaTag {
+    name?: string;
+    property?: string;
+    httpEquiv?: string;
+    charset?: string;
+    content?: string;
+    [attr: string]: string | undefined;
+}
+export interface LinkTag {
+    rel?: string;
+    href?: string;
+    type?: string;
+    media?: string;
+    as?: string;
+    crossOrigin?: string;
+    integrity?: string;
+    hrefLang?: string;
+    sizes?: string;
+    [attr: string]: string | undefined;
+}
+export interface ScriptTag {
+    src?: string;
+    content?: string;
+    type?: string;
+    defer?: boolean;
+    async?: boolean;
+    crossOrigin?: string;
+    integrity?: string;
+    noModule?: boolean;
+    /**
+     * Where to inject the script in the document.
+     *   'head'  (default) — placed inside <head>, inside the <!--n-head--> block.
+     *   'body'            — placed at the very end of <body>, inside the
+     *                       <!--n-body-scripts--> block, just before </body>.
+     */
+    position?: 'head' | 'body';
+}
+export interface StyleTag {
+    content?: string;
+    media?: string;
+}
+export interface HtmlStore {
+    /** Collected in render order; resolved in reverse so the page title wins. */
+    titleOps: TitleValue[];
+    /** Attributes merged onto <html>; last write wins per attribute. */
+    htmlAttrs: HtmlAttrs;
+    /** Attributes merged onto <body>; last write wins per attribute. */
+    bodyAttrs: BodyAttrs;
+    /** Accumulated in render order: layouts first, page last. */
+    meta: MetaTag[];
+    link: LinkTag[];
+    script: ScriptTag[];
+    style: StyleTag[];
+}
+/**
+ * Runs `fn` inside a fresh HTML store and returns the collected values.
+ *
+ * Usage in SSR:
+ * ```ts
+ * const store = await runWithHtmlStore(async () => {
+ *   appHtml = await renderElementToHtml(element, ctx);
+ * });
+ * // store.titleOps, store.meta, etc. are now populated
+ * ```
+ */
+export declare function runWithHtmlStore(fn: () => Promise<void>): Promise<HtmlStore>;
+/**
+ * Returns the current request's store, or `undefined` if called outside of
+ * a `runWithHtmlStore` context (e.g. in the browser or in a test).
+ */
+export declare function getHtmlStore(): HtmlStore | undefined;
+/**
+ * Resolves the final page title from a list of title operations.
+ *
+ * Operations are walked in *reverse* so the page's value is the starting
+ * point and layout template functions wrap it outward:
+ *
+ * ```
+ * ops = [ (p) => `${p} | Acme`, 'About' ]   ← layout pushed first, page last
+ * Walk in reverse:
+ *   i=1: op = 'About'          → title = 'About'
+ *   i=0: op = (p) => …         → title = 'About | Acme'
+ * ```
+ *
+ * @param fallback  Used when ops is empty (e.g. a page that didn't call useHtml).
+ */
+export declare function resolveTitle(ops: TitleValue[], fallback?: string): string;

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 export { useHtml } from './use-html';
-export type { HtmlOptions, TitleValue, HtmlAttrs, BodyAttrs, MetaTag, LinkTag, ScriptTag, StyleTag, } from './use-html';
+export type { HtmlOptions } from './use-html';
+export type { TitleValue, HtmlAttrs, BodyAttrs, MetaTag, LinkTag, ScriptTag, StyleTag, } from './html-store';
 export { default as useRouter } from './use-router';
 export { useRequest } from './use-request';
 export type { RequestContext } from './use-request';

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "nukejs",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "A minimal, opinionated full-stack React framework on Node.js that server-renders everything and hydrates only interactive parts.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",