@nowline/embed 0.5.0 → 0.6.0

package/dist/pipeline.d.ts

@@ -2,7 +2,24 @@ import { type ParseResult } from '@nowline/browser';
 import type { ThemeName } from '@nowline/layout';
 export interface EmbedRenderOptions {
     theme?: ThemeName;
-    today?: Date;
+    /**
+     * "Today" override for the now-line.
+     *
+     * - `Date`   — explicit UTC-midnight date; drawn as-is.
+     * - `string` — raw date string (YYYY-MM-DD or ISO 8601 instant with Z/offset).
+     * - `null`   — suppress the now-line (mirrors `--now -`).
+     * - `undefined` — default to local today (or `timezone` if set).
+     *
+     * Previously accepted only `Date`; strings and null are new as of the
+     * timezone-aware now-line release.
+     */
+    today?: Date | string | null;
+    /**
+     * Timezone for the clock-based "today" default. Only consulted when
+     * `today` is `undefined`. Accepts `"local"` (default), `"UTC"`, ISO 8601
+     * offsets (`"Z"`, `"+05:30"`), or IANA names (`"America/Los_Angeles"`).
+     */
+    timezone?: string;
     locale?: string;
     width?: number;
     /**

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAcA,OAAO,EAMH,KAAK,WAAW,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU3E;AAED,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,OAAO,EAAE,MAAM,EAAE;gBADjC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EAAE;CAKxC;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAcA,OAAO,EAMH,KAAK,WAAW,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,WAAW,kBAAkB;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU3E;AAED,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,OAAO,EAAE,MAAM,EAAE;gBADjC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EAAE;CAKxC;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/pipeline.js

@@ -30,6 +30,7 @@ export async function renderSource(source, options = {}) {
         filePath: EMBED_SOURCE_PATH,
         theme: options.theme,
         today: options.today,
+        timezone: options.timezone,
         locale: options.locale,
         width: options.width,
         idPrefix: options.idPrefix,

package/dist/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AACvE,oCAAoC;AACpC,EAAE;AACF,iEAAiE;AACjE,0EAA0E;AAC1E,mEAAmE;AACnE,sEAAsE;AACtE,aAAa;AACb,mEAAmE;AACnE,sEAAsE;AACtE,uEAAuE;AACvE,2CAA2C;AAE3C,OAAO,EACH,8BAA8B,EAE9B,WAAW,IAAI,kBAAkB,EACjC,YAAY,IAAI,mBAAmB,GAGtC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAsB3C,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC5C,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;QAC1D,QAAQ,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACH,GAAG;QACH,MAAM,EAAE,WAAW;aACd,MAAM,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KAC7B,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,cAAc,GAAyB;QACzC,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,gBAAgB,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACzB,qBAAqB,GAAG,IAAI,CAAC;gBAC7B,OAAO,CAAC,IAAI,CACR,qFAAqF;oBACjF,+DAA+D,CACtE,CAAC;YACN,CAAC;QACL,CAAC;KACJ,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChG,MAAM,IAAI,gBAAgB,CAAC,oCAAoC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGnB;IAFpB,YACI,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED,uEAAuE;AACvE,wEAAwE;AACxE,iCAAiC;AACjC,MAAM,UAAU,4BAA4B;IACxC,qBAAqB,GAAG,KAAK,CAAC;IAC9B,8BAA8B,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AACvE,oCAAoC;AACpC,EAAE;AACF,iEAAiE;AACjE,0EAA0E;AAC1E,mEAAmE;AACnE,sEAAsE;AACtE,aAAa;AACb,mEAAmE;AACnE,sEAAsE;AACtE,uEAAuE;AACvE,2CAA2C;AAE3C,OAAO,EACH,8BAA8B,EAE9B,WAAW,IAAI,kBAAkB,EACjC,YAAY,IAAI,mBAAmB,GAGtC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAuC3C,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC5C,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;QAC1D,QAAQ,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACH,GAAG;QACH,MAAM,EAAE,WAAW;aACd,MAAM,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KAC7B,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,cAAc,GAAyB;QACzC,QAAQ,EAAE,iBAAiB;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,gBAAgB,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACzB,qBAAqB,GAAG,IAAI,CAAC;gBAC7B,OAAO,CAAC,IAAI,CACR,qFAAqF;oBACjF,+DAA+D,CACtE,CAAC;YACN,CAAC;QACL,CAAC;KACJ,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChG,MAAM,IAAI,gBAAgB,CAAC,oCAAoC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGnB;IAFpB,YACI,OAAe,EACC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED,uEAAuE;AACvE,wEAAwE;AACxE,iCAAiC;AACjC,MAAM,UAAU,4BAA4B;IACxC,qBAAqB,GAAG,KAAK,CAAC;IAC9B,8BAA8B,EAAE,CAAC;AACrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nowline/embed",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Browser embed bundle for Nowline. Drop a <script> tag and ```nowline``` blocks render in place.",
   "license": "Apache-2.0",
   "engines": {
@@ -41,10 +41,10 @@
   "dependencies": {
     "fflate": "^0.8.3",
     "langium": "~4.2.4",
-    "@nowline/browser": "0.5.0",
-    "@nowline/core": "0.5.0",
-    "@nowline/layout": "0.5.0",
-    "@nowline/renderer": "0.5.0"
+    "@nowline/layout": "0.6.0",
+    "@nowline/core": "0.6.0",
+    "@nowline/browser": "0.6.0",
+    "@nowline/renderer": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/src/auto-scan.ts

@@ -12,7 +12,10 @@ export interface AutoScanInputs {
     theme?: ThemeName;
     locale?: string;
     width?: number;
-    today?: Date;
+    /** See {@link EmbedRenderOptions.today} — accepts Date, string, null, or undefined. */
+    today?: Date | string | null;
+    /** See {@link EmbedRenderOptions.timezone}. */
+    timezone?: string;
     /**
      * Controls the "Share on Nowline" anchor appended after each rendered
      * SVG. Defaults to `true` when omitted (mirrors the config default).
@@ -68,6 +71,7 @@ export async function runAutoScan(inputs: AutoScanInputs): Promise<AutoScanResul
             locale: inputs.locale,
             width: inputs.width,
             today: inputs.today,
+            timezone: inputs.timezone,
             idPrefix,
         };
 

package/src/index.ts

@@ -73,8 +73,18 @@ export interface InitializeOptions {
     locale?: string;
     /** Layout canvas width in pixels. Layout's default is 1280. */
     width?: number;
-    /** Pin a `today` for deterministic snapshots; defaults to live `new Date()` per render. */
-    today?: Date;
+    /**
+     * "Today" override for the now-line. Accepts a `Date`, a YYYY-MM-DD string,
+     * a full ISO 8601 instant (with Z or ±offset), or `null` to suppress the
+     * now-line. Defaults to the local civil date when omitted.
+     */
+    today?: Date | string | null;
+    /**
+     * Timezone for the clock-based "today" default. Only consulted when `today`
+     * is omitted. Accepts `"local"` (default), `"UTC"`, ISO 8601 offsets, or
+     * IANA timezone names (e.g. `"America/Los_Angeles"`).
+     */
+    timezone?: string;
     /**
      * Controls the "Share on Nowline" anchor appended after each rendered SVG.
      * - `true` (default) — link to the Free app open route
@@ -99,7 +109,8 @@ interface ResolvedConfig {
     selector: string;
     locale?: string;
     width?: number;
-    today?: Date;
+    today?: Date | string | null;
+    timezone?: string;
     /** System theme captured at init; not reactive to OS theme flips mid-session. */
     systemTheme: 'light' | 'dark';
     /** Controls the "Share on Nowline" anchor. Defaults to `true`. */
@@ -126,7 +137,8 @@ export function initialize(options: InitializeOptions = {}): void {
         selector: options.selector ?? config.selector,
         locale: options.locale ?? config.locale,
         width: options.width ?? config.width,
-        today: options.today ?? config.today,
+        today: options.today !== undefined ? options.today : config.today,
+        timezone: options.timezone ?? config.timezone,
         share: options.share ?? config.share,
         sourceUrl: options.sourceUrl ?? config.sourceUrl,
         // Re-read `prefers-color-scheme` on every initialize() so callers
@@ -144,6 +156,7 @@ function renderOptionsFromConfig(): EmbedRenderOptions {
         locale: config.locale,
         width: config.width,
         today: config.today,
+        timezone: config.timezone,
     };
 }
 
@@ -180,7 +193,8 @@ export async function init(overrides?: Partial<AutoScanInputs>): Promise<AutoSca
         theme: overrides?.theme ?? renderOptionsFromConfig().theme,
         locale: overrides?.locale ?? config.locale,
         width: overrides?.width ?? config.width,
-        today: overrides?.today ?? config.today,
+        today: overrides?.today !== undefined ? overrides.today : config.today,
+        timezone: overrides?.timezone ?? config.timezone,
         share: overrides?.share ?? config.share,
         sourceUrl: overrides?.sourceUrl ?? config.sourceUrl,
         document: overrides?.document,

package/src/pipeline.ts

@@ -26,7 +26,24 @@ const EMBED_SOURCE_PATH = '/embed.nowline';
 
 export interface EmbedRenderOptions {
     theme?: ThemeName;
-    today?: Date;
+    /**
+     * "Today" override for the now-line.
+     *
+     * - `Date`   — explicit UTC-midnight date; drawn as-is.
+     * - `string` — raw date string (YYYY-MM-DD or ISO 8601 instant with Z/offset).
+     * - `null`   — suppress the now-line (mirrors `--now -`).
+     * - `undefined` — default to local today (or `timezone` if set).
+     *
+     * Previously accepted only `Date`; strings and null are new as of the
+     * timezone-aware now-line release.
+     */
+    today?: Date | string | null;
+    /**
+     * Timezone for the clock-based "today" default. Only consulted when
+     * `today` is `undefined`. Accepts `"local"` (default), `"UTC"`, ISO 8601
+     * offsets (`"Z"`, `"+05:30"`), or IANA names (`"America/Los_Angeles"`).
+     */
+    timezone?: string;
     locale?: string;
     width?: number;
     /**
@@ -66,6 +83,7 @@ export async function renderSource(
         filePath: EMBED_SOURCE_PATH,
         theme: options.theme,
         today: options.today,
+        timezone: options.timezone,
         locale: options.locale,
         width: options.width,
         idPrefix: options.idPrefix,