@aglyn/aglyn 1.0.0-beta.154 → 1.0.0-beta.156

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/aglyn",
-  "version": "1.0.0-beta.154",
+  "version": "1.0.0-beta.156",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -33,15 +33,15 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.154",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.154",
-    "@aglyn/shared-data-types": "1.0.0-beta.154",
-    "@aglyn/shared-util-email": "1.0.0-beta.154",
-    "@aglyn/shared-util-http": "1.0.0-beta.154",
-    "@aglyn/shared-util-logger": "1.0.0-beta.154",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.154",
-    "@aglyn/shared-util-tools": "1.0.0-beta.154",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.154",
+    "@aglyn/shared-data-enums": "1.0.0-beta.156",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.156",
+    "@aglyn/shared-data-types": "1.0.0-beta.156",
+    "@aglyn/shared-util-email": "1.0.0-beta.156",
+    "@aglyn/shared-util-http": "1.0.0-beta.156",
+    "@aglyn/shared-util-logger": "1.0.0-beta.156",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.156",
+    "@aglyn/shared-util-tools": "1.0.0-beta.156",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.156",
     "@data-driven-forms/react-form-renderer": "^4.2.0",
     "@msgpack/msgpack": "^3.1.3",
     "@types/unist": "^3.0.3",

package/src/lib/app-utils/collection-entries.d.ts

@@ -413,7 +413,9 @@ export declare function resolveEntryCategoryName(entry: Pick<CollectionEntryReco
  * drift: the same entry has to read the same way whether the author bound the
  * tokens by hand or let the server fill the block in.
  */
-export declare function collectionEntryMetaValues(entry: CollectionEntryRecord, categories?: readonly CollectionCategory[], dateFormat?: CollectionEntryDateFormat): {
+export declare function collectionEntryMetaValues(entry: CollectionEntryRecord, categories?: readonly CollectionCategory[], dateFormat?: CollectionEntryDateFormat, 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): {
     date: string;
     author: string;
     category: string;
@@ -448,7 +450,9 @@ export declare function collectionEntryAuthorValues(entry: CollectionEntryRecord
  * entries block. `entry.url` resolves to the entry's auto-route so links
  * (`Read more`, titles) work without hardcoding the collection slug.
  */
-export declare function collectionEntryTokens(entry: CollectionEntryRecord, collectionSlug: string, categories?: CollectionCategory[]): Record<string, string>;
+export declare function collectionEntryTokens(entry: CollectionEntryRecord, collectionSlug: string, categories?: CollectionCategory[], 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): Record<string, string>;
 /**
  * Category/tag membership check (AGL-582), shared by the Collection entries
  * filter props and the query-less list surfaces. Matching is trimmed and
@@ -684,7 +688,9 @@ export declare function buildCollectionCategoryLinks(options: {
  * the date especially): a suggestion for a post is the same post as the card
  * below it and must not be able to disagree with it about its date.
  */
-export declare function buildCollectionSearchIndex(entries: readonly CollectionEntryRecord[], collectionSlug: string, categories?: readonly CollectionCategory[]): CollectionEntrySearchItem[];
+export declare function buildCollectionSearchIndex(entries: readonly CollectionEntryRecord[], collectionSlug: string, categories?: readonly CollectionCategory[], 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): CollectionEntrySearchItem[];
 /**
  * Does this tree render the collection `collectionSlug` away from the
  * collection's own routes?
@@ -728,7 +734,9 @@ export declare function nodesRenderCollection(nodes: Record<NodeId, AglynNodeSch
  *   matching entries renders zero rows — never the unsubstituted template.
  * - Inputs are never mutated; template nodes stay in the map unreferenced.
  */
-export declare function expandCollectionEntries<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, sourcesBySlug: Record<string, CollectionEntriesSource | undefined>, defaultSlug?: string): Record<NodeId, N>;
+export declare function expandCollectionEntries<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, sourcesBySlug: Record<string, CollectionEntriesSource | undefined>, defaultSlug?: string, 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): Record<NodeId, N>;
 /**
  * Category Pills blocks (AGL-1321): stamps each `collectionCategories` node
  * with its collection's pill row as a serializable `items` prop the component
@@ -763,7 +771,9 @@ export declare function expandCollectionCategories<N extends AglynNodeSchema = A
  * and a collection with no entries leaves its block untouched, so the
  * component's besigner affordance and its empty site render both stand.
  */
-export declare function expandCollectionSearch<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, sourcesBySlug: Record<string, CollectionEntriesSource | undefined>, defaultSlug?: string): Record<NodeId, N>;
+export declare function expandCollectionSearch<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, sourcesBySlug: Record<string, CollectionEntriesSource | undefined>, defaultSlug?: string, 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): Record<NodeId, N>;
 /**
  * Entry Meta blocks (AGL-1385): stamps each `collectionEntryMeta` node with
  * the routed entry's date, category and tags — the same server-stamped shape
@@ -808,7 +818,9 @@ export declare function expandCollectionSearch<N extends AglynNodeSchema = Aglyn
  *
  * Inputs are never mutated.
  */
-export declare function expandCollectionEntryMeta<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, entry: CollectionEntryRecord | null | undefined, categories?: readonly CollectionCategory[]): Record<NodeId, N>;
+export declare function expandCollectionEntryMeta<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, entry: CollectionEntryRecord | null | undefined, categories?: readonly CollectionCategory[], 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): Record<NodeId, N>;
 /**
  * Fill Entry Author cards from the routed entry's author record (AGL-2486),
  * on the same terms {@link expandCollectionEntryMeta} fills the byline:
@@ -921,5 +933,7 @@ export declare function selectRelatedEntries(entries: CollectionEntryRecord[], c
  * stay untouched, so the component's sample cards (editing surfaces) or its
  * empty site render apply. Inputs are never mutated.
  */
-export declare function expandCollectionRelated<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, source: CollectionEntriesSource | undefined, currentEntry: CollectionEntryRecord | null | undefined): Record<NodeId, N>;
+export declare function expandCollectionRelated<N extends AglynNodeSchema = AglynNodeSchema>(nodes: Record<NodeId, N>, source: CollectionEntriesSource | undefined, currentEntry: CollectionEntryRecord | null | undefined, 
+/** The site's zone (AGL-3237); UTC when a site has not named one. */
+timeZone?: string): Record<NodeId, N>;
 export default expandCollectionEntries;

package/src/lib/app-utils/collection-entries.js

@@ -271,11 +271,11 @@ categories) {
  * Extracted so the token map and {@link expandCollectionEntryMeta} cannot
  * drift: the same entry has to read the same way whether the author bound the
  * tokens by hand or let the server fill the block in.
- */ export function collectionEntryMetaValues(entry, categories, dateFormat) {
+ */ export function collectionEntryMetaValues(entry, categories, dateFormat, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     var _resolveEntryCategoryName, _entry_tags;
     var _entry_author;
     return {
-        date: formatCollectionEntryDate(entry.publishedAt, dateFormat),
+        date: formatCollectionEntryDate(entry.publishedAt, dateFormat, undefined, timeZone),
         // The per-entry byline the editor already collects (AGL-686). It was
         // reachable in the entry's JSON-LD and nowhere on the page, which is what
         // made the frame's byline unauthorable (AGL-1459).
@@ -340,9 +340,9 @@ categories) {
  * globally on entry-template screens and per-clone inside the Collection
  * entries block. `entry.url` resolves to the entry's auto-route so links
  * (`Read more`, titles) work without hardcoding the collection slug.
- */ export function collectionEntryTokens(entry, collectionSlug, categories) {
+ */ export function collectionEntryTokens(entry, collectionSlug, categories, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     var _entry_collectionSlug, _entry_title, _entry_excerpt, _entry_body, _entry_coverImage, _entry_coverVideo, _entry_slug, _entry_slug1, _entry_collectionName;
-    const meta = collectionEntryMetaValues(entry, categories);
+    const meta = collectionEntryMetaValues(entry, categories, undefined, timeZone);
     const author = collectionEntryAuthorValues(entry);
     // The entry's OWN collection wins over the routed one (AGL-2518) — see
     // `CollectionEntryRecord.collectionSlug`. Unset on every single-collection
@@ -749,7 +749,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  * clones. Through the same three resolvers Related posts uses (AGL-1926 for
  * the date especially): a suggestion for a post is the same post as the card
  * below it and must not be able to disagree with it about its date.
- */ export function buildCollectionSearchIndex(entries, collectionSlug, categories) {
+ */ export function buildCollectionSearchIndex(entries, collectionSlug, categories, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     return entries.map((entry)=>{
         var _entry_title, _entry_excerpt, _entry_collectionSlug;
         var _entry_publishedAt;
@@ -760,7 +760,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
         }, entry.slug ? {
             url: `/${((_entry_collectionSlug = entry.collectionSlug) != null ? _entry_collectionSlug : '').trim() || collectionSlug}/${entry.slug}`
         } : {}, ((_entry_publishedAt = entry.publishedAt) == null ? void 0 : _entry_publishedAt.seconds) ? {
-            date: formatCollectionEntryDate(entry.publishedAt)
+            date: formatCollectionEntryDate(entry.publishedAt, undefined, undefined, timeZone)
         } : {}, categoryName ? {
             category: categoryName
         } : {});
@@ -838,7 +838,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  *   collection must never take a screen down). A known collection with no
  *   matching entries renders zero rows — never the unsubstituted template.
  * - Inputs are never mutated; template nodes stay in the map unreferenced.
- */ export function expandCollectionEntries(nodes, sourcesBySlug, defaultSlug) {
+ */ export function expandCollectionEntries(nodes, sourcesBySlug, defaultSlug, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     const containers = Object.entries(nodes).filter(([, node])=>(node == null ? void 0 : node.componentId) === COLLECTION_ENTRIES_COMPONENT_ID);
     if (!containers.length) return nodes;
     const next = _extends({}, nodes);
@@ -955,13 +955,13 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
             // binding under a chosen format, which is the case this exists for.
             for (const [cloneId, cloneNode] of Object.entries(cloned)){
                 var _cloneNode_props;
-                const fill = (cloneNode == null ? void 0 : cloneNode.componentId) === COLLECTION_ENTRY_META_COMPONENT_ID ? entryMetaFill(cloneNode, entry, source.categories) : (cloneNode == null ? void 0 : cloneNode.componentId) === COLLECTION_ENTRY_AUTHOR_COMPONENT_ID ? entryAuthorFill(cloneNode, entry) : undefined;
+                const fill = (cloneNode == null ? void 0 : cloneNode.componentId) === COLLECTION_ENTRY_META_COMPONENT_ID ? entryMetaFill(cloneNode, entry, source.categories, timeZone) : (cloneNode == null ? void 0 : cloneNode.componentId) === COLLECTION_ENTRY_AUTHOR_COMPONENT_ID ? entryAuthorFill(cloneNode, entry) : undefined;
                 if (!fill || !Object.keys(fill).length) continue;
                 cloned[cloneId] = _extends({}, cloneNode, {
                     props: _extends({}, (_cloneNode_props = cloneNode.props) != null ? _cloneNode_props : {}, fill)
                 });
             }
-            Object.assign(next, resolveNamedTokens(cloned, collectionEntryTokens(entry, source.slug, source.categories)));
+            Object.assign(next, resolveNamedTokens(cloned, collectionEntryTokens(entry, source.slug, source.categories, timeZone)));
         });
         // Search (AGL-1516): the block's search box filters CLIENT-SIDE over the
         // entries this expansion just rendered — the ISR-cached page is the whole
@@ -973,7 +973,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
         const searchEnabled = Boolean((_container_props7 = container.props) == null ? void 0 : _container_props7.search);
         next[containerId] = searchEnabled ? _extends({}, container, {
             props: _extends({}, container.props, {
-                searchIndex: buildCollectionSearchIndex(windowed, source.slug, source.categories),
+                searchIndex: buildCollectionSearchIndex(windowed, source.slug, source.categories, timeZone),
                 // How many entries the window above was drawn FROM (AGL-1516).
                 //
                 // The component has to tell the reader whether a miss means "not
@@ -1059,7 +1059,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  * template would otherwise be stamped once per card. Nodes are never mutated,
  * and a collection with no entries leaves its block untouched, so the
  * component's besigner affordance and its empty site render both stand.
- */ export function expandCollectionSearch(nodes, sourcesBySlug, defaultSlug) {
+ */ export function expandCollectionSearch(nodes, sourcesBySlug, defaultSlug, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     const containers = Object.entries(nodes).filter(([id, node])=>(node == null ? void 0 : node.componentId) === COLLECTION_SEARCH_COMPONENT_ID && !id.startsWith(COLLECTION_ENTRIES_NODE_ID_PREFIX));
     if (!containers.length) return nodes;
     const next = _extends({}, nodes);
@@ -1078,7 +1078,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
         if (!source.entries.length) continue;
         next[containerId] = _extends({}, container, {
             props: _extends({}, container.props, {
-                searchIndex: buildCollectionSearchIndex(source.entries, source.slug, source.categories),
+                searchIndex: buildCollectionSearchIndex(source.entries, source.slug, source.categories, timeZone),
                 searchTotal: source.entries.length
             }, collectionSourceIsBounded(source) ? {
                 searchCapped: true
@@ -1130,14 +1130,14 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  * typed still wins, unchanged.
  *
  * Inputs are never mutated.
- */ export function expandCollectionEntryMeta(nodes, entry, categories) {
+ */ export function expandCollectionEntryMeta(nodes, entry, categories, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     if (!entry) return nodes;
     const containers = Object.entries(nodes).filter(([id, node])=>(node == null ? void 0 : node.componentId) === COLLECTION_ENTRY_META_COMPONENT_ID && !id.startsWith(COLLECTION_ENTRIES_NODE_ID_PREFIX));
     if (!containers.length) return nodes;
     const next = _extends({}, nodes);
     for (const [containerId, container] of containers){
         var _container_props;
-        const filled = entryMetaFill(container, entry, categories);
+        const filled = entryMetaFill(container, entry, categories, timeZone);
         if (!Object.keys(filled).length) continue;
         next[containerId] = _extends({}, container, {
             props: _extends({}, (_container_props = container.props) != null ? _container_props : {}, filled)
@@ -1156,7 +1156,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  *
  * Returns only the keys that change; an empty object means "leave this node
  * exactly as authored".
- */ function entryMetaFill(container, entry, categories) {
+ */ function entryMetaFill(container, entry, categories, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     {
         var _container_props, _ref, _props_author;
         var _entry_author;
@@ -1164,7 +1164,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
         // Per node: the format is a prop, so two blocks on one template can read
         // their dates differently.
         const dateFormat = normalizeCollectionEntryDateFormat(props['dateFormat']);
-        const values = collectionEntryMetaValues(entry, categories, dateFormat);
+        const values = collectionEntryMetaValues(entry, categories, dateFormat, timeZone);
         const filled = {};
         for (const key of [
             'date',
@@ -1376,7 +1376,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
  * markup). Runs only on entry renders; without an entry context the nodes
  * stay untouched, so the component's sample cards (editing surfaces) or its
  * empty site render apply. Inputs are never mutated.
- */ export function expandCollectionRelated(nodes, source, currentEntry) {
+ */ export function expandCollectionRelated(nodes, source, currentEntry, /** The site's zone (AGL-3237); UTC when a site has not named one. */ timeZone) {
     if (!source || !currentEntry) return nodes;
     const containers = Object.entries(nodes).filter(([, node])=>(node == null ? void 0 : node.componentId) === COLLECTION_RELATED_COMPONENT_ID);
     if (!containers.length) return nodes;
@@ -1397,7 +1397,7 @@ const POSITIVE_INTEGER = /^[1-9]\d*$/;
                 title: (_entry_title = entry.title) != null ? _entry_title : '',
                 url: `/${source.slug}/${(_entry_slug = entry.slug) != null ? _entry_slug : ''}`
             }, ((_entry_publishedAt = entry.publishedAt) == null ? void 0 : _entry_publishedAt.seconds) ? {
-                date: formatCollectionEntryDate(entry.publishedAt, dateFormat)
+                date: formatCollectionEntryDate(entry.publishedAt, dateFormat, undefined, timeZone)
             } : {}, entry.excerpt ? {
                 excerpt: entry.excerpt
             } : {}, entry.coverImage ? {