@nowline/embed 0.5.1 → 0.7.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/dist/share.d.ts

@@ -1,45 +1,2 @@
-export declare const DEFAULT_SHARE_BASE = "https://free.nowline.io/open";
-/**
- * The `share` initialize option selects where share links point.
- *
- * - `true` — use DEFAULT_SHARE_BASE (the default).
- * - `string` — a base URL with optional path; built via the URL API so
- *   `https://foo.com/open` → `https://foo.com/open#text=…`.
- * - `false` / `'none'` — disable the share anchor entirely.
- * - `{ textUrl, remoteUrl }` — escape hatch for non-hash URL shapes;
- *   `{text}` substituted with the base64url payload, `{url}` with the
- *   percent-encoded source URL.
- */
-export type ShareOption = boolean | 'none' | string | {
-    textUrl: string;
-    remoteUrl: string;
-};
-/**
- * Encode source text → `#text=<base64url(zlib(utf8(source)))>`.
- *
- * The return value includes the `#text=` key so callers can use it
- * directly as a URL fragment.
- *
- * Sync, single code path, no feature-detect.
- */
-export declare function encodeText(source: string): string;
-export interface BuildShareLinkOptions {
-    /** The roadmap source text (used to build the #text= fragment). */
-    source: string;
-    /**
-     * Resolved source URL for the block (per-block → global → undefined).
-     * Only `https:` URLs are emitted as `#url=`; anything else falls
-     * back to the inline `#text=` encoding.
-     */
-    sourceUrl?: string | undefined;
-    /** The `share` option from InitializeOptions. */
-    share: ShareOption;
-}
-/**
- * Build the full "Share on Nowline" URL for a rendered block.
- *
- * Returns `null` when `share` is `false` or `'none'`, signalling that
- * no anchor should be rendered.
- */
-export declare function buildShareLink({ source, sourceUrl, share }: BuildShareLinkOptions): string | null;
+export { type BuildShareLinkOptions, buildShareLink, DEFAULT_SHARE_BASE, encodeText, type ShareOption, } from '@nowline/share-link';
 //# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAgBD,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iDAAiD;IACjD,KAAK,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAwBjG"}
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAMA,OAAO,EACH,KAAK,qBAAqB,EAC1B,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,KAAK,WAAW,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/share.js

@@ -1,75 +1,7 @@
-// Share-link generation for the "Share on Nowline" anchor that the
-// auto-scan loop appends after each rendered SVG.
-//
-// Encoding grammar (normative — defined in specs/embed.md):
-//   #text=base64url(zlib(utf8(source)))
-//   #url=<https-url>
-//
-// zlib = RFC 1950 via fflate zlibSync (byte-compatible with native
-// CompressionStream('deflate')); base64url strips padding and maps
-// +→- /→_.
-//
-// Sync, works on every browser, no feature-detect.
-import { zlibSync } from 'fflate';
-export const DEFAULT_SHARE_BASE = 'https://free.nowline.io/open';
-/**
- * Encode source text → `#text=<base64url(zlib(utf8(source)))>`.
- *
- * The return value includes the `#text=` key so callers can use it
- * directly as a URL fragment.
- *
- * Sync, single code path, no feature-detect.
- */
-export function encodeText(source) {
-    return `#text=${_encodePayload(source)}`;
-}
-/** base64url(zlib(utf8(source))) without the `#text=` prefix. */
-function _encodePayload(source) {
-    const bytes = new TextEncoder().encode(source);
-    const compressed = zlibSync(bytes);
-    // Convert Uint8Array to binary string for btoa. Chunked to avoid
-    // call-stack limits on large payloads.
-    const chunk = 0x8000; // 32 KB — safe below JS engine stack limits
-    let bin = '';
-    for (let i = 0; i < compressed.length; i += chunk) {
-        bin += String.fromCharCode(...compressed.subarray(i, i + chunk));
-    }
-    return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
-}
-/**
- * Build the full "Share on Nowline" URL for a rendered block.
- *
- * Returns `null` when `share` is `false` or `'none'`, signalling that
- * no anchor should be rendered.
- */
-export function buildShareLink({ source, sourceUrl, share }) {
-    if (share === false || share === 'none') {
-        return null;
-    }
-    if (typeof share === 'object') {
-        // Template mode: { textUrl, remoteUrl }
-        if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
-            return share.remoteUrl.replace('{url}', encodeURIComponent(sourceUrl));
-        }
-        return share.textUrl.replace('{text}', _encodePayload(source));
-    }
-    // share === true → DEFAULT_SHARE_BASE; share is a string → custom base URL
-    const base = share === true ? DEFAULT_SHARE_BASE : share;
-    const url = new URL(base);
-    if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
-        url.hash = `url=${encodeURIComponent(sourceUrl)}`;
-    }
-    else {
-        url.hash = `text=${_encodePayload(source)}`;
-    }
-    return url.toString();
-}
-function _isHttps(url) {
-    try {
-        return new URL(url).protocol === 'https:';
-    }
-    catch {
-        return false;
-    }
-}
+// Share-link generation moved to the dependency-light @nowline/share-link
+// leaf so the encoder is shared verbatim with @nowline/mcp (one
+// spec-normative implementation — see specs/embed.md). This file stays as a
+// thin re-export so internal importers (auto-scan.ts) and the package's
+// public surface are unchanged.
+export { buildShareLink, DEFAULT_SHARE_BASE, encodeText, } from '@nowline/share-link';
 //# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -1 +1 @@
-{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kDAAkD;AAClD,EAAE;AACF,4DAA4D;AAC5D,wCAAwC;AACxC,qBAAqB;AACrB,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,WAAW;AACX,EAAE;AACF,mDAAmD;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAejE;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACrC,OAAO,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,iEAAiE;AACjE,SAAS,cAAc,CAAC,MAAc;IAClC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,iEAAiE;IACjE,uCAAuC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,4CAA4C;IAClE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAChD,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAyB;IAC9E,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,wCAAwC;QACxC,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,2EAA2E;IAC3E,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,IAAI,GAAG,OAAO,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;IACtD,CAAC;SAAM,CAAC;QACJ,GAAG,CAAC,IAAI,GAAG,QAAQ,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IACzB,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gEAAgE;AAChE,4EAA4E;AAC5E,wEAAwE;AACxE,gCAAgC;AAEhC,OAAO,EAEH,cAAc,EACd,kBAAkB,EAClB,UAAU,GAEb,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nowline/embed",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Browser embed bundle for Nowline. Drop a <script> tag and ```nowline``` blocks render in place.",
   "license": "Apache-2.0",
   "engines": {
@@ -39,12 +39,12 @@
     "cdn"
   ],
   "dependencies": {
-    "fflate": "^0.8.3",
     "langium": "~4.2.4",
-    "@nowline/core": "0.5.1",
-    "@nowline/layout": "0.5.1",
-    "@nowline/browser": "0.5.1",
-    "@nowline/renderer": "0.5.1"
+    "@nowline/browser": "0.7.0",
+    "@nowline/core": "0.7.0",
+    "@nowline/layout": "0.7.0",
+    "@nowline/renderer": "0.7.0",
+    "@nowline/share-link": "0.7.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,

package/src/share.ts

@@ -1,108 +1,13 @@
-// Share-link generation for the "Share on Nowline" anchor that the
-// auto-scan loop appends after each rendered SVG.
-//
-// Encoding grammar (normative — defined in specs/embed.md):
-//   #text=base64url(zlib(utf8(source)))
-//   #url=<https-url>
-//
-// zlib = RFC 1950 via fflate zlibSync (byte-compatible with native
-// CompressionStream('deflate')); base64url strips padding and maps
-// +→- /→_.
-//
-// Sync, works on every browser, no feature-detect.
-
-import { zlibSync } from 'fflate';
-
-export const DEFAULT_SHARE_BASE = 'https://free.nowline.io/open';
-
-/**
- * The `share` initialize option selects where share links point.
- *
- * - `true` — use DEFAULT_SHARE_BASE (the default).
- * - `string` — a base URL with optional path; built via the URL API so
- *   `https://foo.com/open` → `https://foo.com/open#text=…`.
- * - `false` / `'none'` — disable the share anchor entirely.
- * - `{ textUrl, remoteUrl }` — escape hatch for non-hash URL shapes;
- *   `{text}` substituted with the base64url payload, `{url}` with the
- *   percent-encoded source URL.
- */
-export type ShareOption = boolean | 'none' | string | { textUrl: string; remoteUrl: string };
-
-/**
- * Encode source text → `#text=<base64url(zlib(utf8(source)))>`.
- *
- * The return value includes the `#text=` key so callers can use it
- * directly as a URL fragment.
- *
- * Sync, single code path, no feature-detect.
- */
-export function encodeText(source: string): string {
-    return `#text=${_encodePayload(source)}`;
-}
-
-/** base64url(zlib(utf8(source))) without the `#text=` prefix. */
-function _encodePayload(source: string): string {
-    const bytes = new TextEncoder().encode(source);
-    const compressed = zlibSync(bytes);
-    // Convert Uint8Array to binary string for btoa. Chunked to avoid
-    // call-stack limits on large payloads.
-    const chunk = 0x8000; // 32 KB — safe below JS engine stack limits
-    let bin = '';
-    for (let i = 0; i < compressed.length; i += chunk) {
-        bin += String.fromCharCode(...compressed.subarray(i, i + chunk));
-    }
-    return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
-}
-
-export interface BuildShareLinkOptions {
-    /** The roadmap source text (used to build the #text= fragment). */
-    source: string;
-    /**
-     * Resolved source URL for the block (per-block → global → undefined).
-     * Only `https:` URLs are emitted as `#url=`; anything else falls
-     * back to the inline `#text=` encoding.
-     */
-    sourceUrl?: string | undefined;
-    /** The `share` option from InitializeOptions. */
-    share: ShareOption;
-}
-
-/**
- * Build the full "Share on Nowline" URL for a rendered block.
- *
- * Returns `null` when `share` is `false` or `'none'`, signalling that
- * no anchor should be rendered.
- */
-export function buildShareLink({ source, sourceUrl, share }: BuildShareLinkOptions): string | null {
-    if (share === false || share === 'none') {
-        return null;
-    }
-
-    if (typeof share === 'object') {
-        // Template mode: { textUrl, remoteUrl }
-        if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
-            return share.remoteUrl.replace('{url}', encodeURIComponent(sourceUrl));
-        }
-        return share.textUrl.replace('{text}', _encodePayload(source));
-    }
-
-    // share === true → DEFAULT_SHARE_BASE; share is a string → custom base URL
-    const base = share === true ? DEFAULT_SHARE_BASE : share;
-    const url = new URL(base);
-
-    if (sourceUrl !== undefined && _isHttps(sourceUrl)) {
-        url.hash = `url=${encodeURIComponent(sourceUrl)}`;
-    } else {
-        url.hash = `text=${_encodePayload(source)}`;
-    }
-
-    return url.toString();
-}
-
-function _isHttps(url: string): boolean {
-    try {
-        return new URL(url).protocol === 'https:';
-    } catch {
-        return false;
-    }
-}
+// Share-link generation moved to the dependency-light @nowline/share-link
+// leaf so the encoder is shared verbatim with @nowline/mcp (one
+// spec-normative implementation — see specs/embed.md). This file stays as a
+// thin re-export so internal importers (auto-scan.ts) and the package's
+// public surface are unchanged.
+
+export {
+    type BuildShareLinkOptions,
+    buildShareLink,
+    DEFAULT_SHARE_BASE,
+    encodeText,
+    type ShareOption,
+} from '@nowline/share-link';