@aglyn/aglyn 1.0.0-beta.143

package/src/lib/app-utils/content-author-profile.js

@@ -0,0 +1,118 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { contentAuthorPageUrl, normalizeContentAuthorLinks } from "./content-authors.js";
+/**
+ * The Author Profile block (AGL-2518) — who this page is about.
+ *
+ * ## Why not the Entry Author card
+ *
+ * `collectionEntryAuthor` is the card that CLOSES an article, and everything
+ * about it is downstream of a routed entry: it fills from `entry.author`, it
+ * renders nothing when there is no entry, and its shape is a byline footnote
+ * — portrait, name, blurb, in a row.
+ *
+ * An author PAGE has no routed entry, and it is not a footnote: it is the
+ * page's subject. It carries what the record actually holds, including the
+ * two fields the article card has no room for — `jobTitle` and `worksFor` —
+ * which are precisely the fields that say who a stranger is looking at.
+ * Reusing one component for both would mean a block whose meaning depends on
+ * which route it happens to be dropped on, and whose Show switches half apply.
+ *
+ * They share the link-row rendering, which is the part that would actually
+ * drift.
+ */ export const CONTENT_AUTHOR_PROFILE_COMPONENT_ID = 'contentAuthorProfile';
+/**
+ * The `{{author.*}}` token map for an author page (AGL-2518).
+ *
+ * Empty strings everywhere off an author page, which is what lets a designed
+ * screen bind them unconditionally: a heading bound to `{{author.name}}` has
+ * nothing to print elsewhere, and a link whose href does not resolve renders
+ * as inert markup of the same element (AGL-1268/1357) rather than as a link
+ * to nowhere. The same rule `{{collection.category}}` follows on an
+ * unfiltered listing.
+ *
+ * `author.image` stays RAW — a `media:` reference or a plain URL, whichever
+ * was saved — because turning one into a fetchable src needs the rendering
+ * host, and a token map has none. Every image field in this codebase does the
+ * same; `resolveMediaSrc` is the renderer's job.
+ */ export function contentAuthorTokens(author, extras) {
+    var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
+    const count = Math.max(0, Math.floor(Number(extras == null ? void 0 : extras.entryCount) || 0));
+    return {
+        'author.name': (_ref = author == null ? void 0 : author.name) != null ? _ref : '',
+        'author.bio': (_ref1 = author == null ? void 0 : author.bio) != null ? _ref1 : '',
+        'author.image': (_ref2 = author == null ? void 0 : author.image) != null ? _ref2 : '',
+        'author.jobTitle': (_ref3 = author == null ? void 0 : author.jobTitle) != null ? _ref3 : '',
+        'author.worksFor': (_ref4 = author == null ? void 0 : author.worksFor) != null ? _ref4 : '',
+        // Their OWN site, which is `schema.org` `url` — a different destination
+        // from the page this token map is describing, and a template should be
+        // able to offer either.
+        'author.url': (_ref5 = author == null ? void 0 : author.url) != null ? _ref5 : '',
+        'author.pageUrl': author ? contentAuthorPageUrl({
+            author
+        }) : '',
+        'author.entryCount': String(count),
+        // Pluralized here rather than in the template, because a template has no
+        // conditional to do it with — the whole reason these tokens resolve to
+        // literals server-side.
+        'author.entryCountLabel': `${count} ${count === 1 ? 'post' : 'posts'}`
+    };
+}
+/**
+ * Fill Author Profile blocks from the routed author (AGL-2518).
+ *
+ * The `expandCollectionEntryAuthor` shape, one subject over: an authored
+ * value on the node always wins, so a designer who typed a name into the
+ * block keeps it, and the record fills only what was left blank. `links` has
+ * no authorable form — a row carries a platform or a picked icon, both chosen
+ * in the console's author editor — so the record's rows are the only ones
+ * there are, and `Show links` is the template's control over them.
+ */ export function expandContentAuthorProfile(nodes, author) {
+    var _author_name, _author_bio, _author_image, _author_jobTitle, _author_worksFor, _author_url;
+    if (!author) return nodes;
+    const containers = Object.entries(nodes).filter(([, node])=>(node == null ? void 0 : node.componentId) === CONTENT_AUTHOR_PROFILE_COMPONENT_ID);
+    if (!containers.length) return nodes;
+    const links = normalizeContentAuthorLinks(author.links);
+    const values = {
+        name: (_author_name = author.name) != null ? _author_name : '',
+        bio: (_author_bio = author.bio) != null ? _author_bio : '',
+        image: (_author_image = author.image) != null ? _author_image : '',
+        jobTitle: (_author_jobTitle = author.jobTitle) != null ? _author_jobTitle : '',
+        worksFor: (_author_worksFor = author.worksFor) != null ? _author_worksFor : '',
+        url: (_author_url = author.url) != null ? _author_url : ''
+    };
+    const next = _extends({}, nodes);
+    for (const [containerId, container] of containers){
+        var _container_props, _container_props1;
+        const props = (_container_props = container.props) != null ? _container_props : {};
+        const filled = {};
+        for (const [key, value] of Object.entries(values)){
+            var _props_key;
+            if (String((_props_key = props[key]) != null ? _props_key : '').trim()) continue;
+            if (!value) continue;
+            filled[key] = value;
+        }
+        if (links.length) filled['links'] = links;
+        if (!Object.keys(filled).length) continue;
+        next[containerId] = _extends({}, container, {
+            props: _extends({}, (_container_props1 = container.props) != null ? _container_props1 : {}, filled)
+        });
+    }
+    return next;
+}
+
+//# sourceMappingURL=content-author-profile.js.map

package/src/lib/app-utils/content-author-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/content-author-profile.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AglynNodeSchema, NodeId } from '../foundation'\nimport {\n  type ContentAuthorRecord,\n  contentAuthorPageUrl,\n  normalizeContentAuthorLinks,\n} from './content-authors'\n\n/**\n * The Author Profile block (AGL-2518) — who this page is about.\n *\n * ## Why not the Entry Author card\n *\n * `collectionEntryAuthor` is the card that CLOSES an article, and everything\n * about it is downstream of a routed entry: it fills from `entry.author`, it\n * renders nothing when there is no entry, and its shape is a byline footnote\n * — portrait, name, blurb, in a row.\n *\n * An author PAGE has no routed entry, and it is not a footnote: it is the\n * page's subject. It carries what the record actually holds, including the\n * two fields the article card has no room for — `jobTitle` and `worksFor` —\n * which are precisely the fields that say who a stranger is looking at.\n * Reusing one component for both would mean a block whose meaning depends on\n * which route it happens to be dropped on, and whose Show switches half apply.\n *\n * They share the link-row rendering, which is the part that would actually\n * drift.\n */\nexport const CONTENT_AUTHOR_PROFILE_COMPONENT_ID = 'contentAuthorProfile'\n\n/**\n * The `{{author.*}}` token map for an author page (AGL-2518).\n *\n * Empty strings everywhere off an author page, which is what lets a designed\n * screen bind them unconditionally: a heading bound to `{{author.name}}` has\n * nothing to print elsewhere, and a link whose href does not resolve renders\n * as inert markup of the same element (AGL-1268/1357) rather than as a link\n * to nowhere. The same rule `{{collection.category}}` follows on an\n * unfiltered listing.\n *\n * `author.image` stays RAW — a `media:` reference or a plain URL, whichever\n * was saved — because turning one into a fetchable src needs the rendering\n * host, and a token map has none. Every image field in this codebase does the\n * same; `resolveMediaSrc` is the renderer's job.\n */\nexport function contentAuthorTokens(\n  author: ContentAuthorRecord | null | undefined,\n  extras?: { entryCount?: number },\n): Record<string, string> {\n  const count = Math.max(0, Math.floor(Number(extras?.entryCount) || 0))\n  return {\n    'author.name': author?.name ?? '',\n    'author.bio': author?.bio ?? '',\n    'author.image': author?.image ?? '',\n    'author.jobTitle': author?.jobTitle ?? '',\n    'author.worksFor': author?.worksFor ?? '',\n    // Their OWN site, which is `schema.org` `url` — a different destination\n    // from the page this token map is describing, and a template should be\n    // able to offer either.\n    'author.url': author?.url ?? '',\n    'author.pageUrl': author ? contentAuthorPageUrl({ author }) : '',\n    'author.entryCount': String(count),\n    // Pluralized here rather than in the template, because a template has no\n    // conditional to do it with — the whole reason these tokens resolve to\n    // literals server-side.\n    'author.entryCountLabel': `${count} ${count === 1 ? 'post' : 'posts'}`,\n  }\n}\n\n/**\n * Fill Author Profile blocks from the routed author (AGL-2518).\n *\n * The `expandCollectionEntryAuthor` shape, one subject over: an authored\n * value on the node always wins, so a designer who typed a name into the\n * block keeps it, and the record fills only what was left blank. `links` has\n * no authorable form — a row carries a platform or a picked icon, both chosen\n * in the console's author editor — so the record's rows are the only ones\n * there are, and `Show links` is the template's control over them.\n */\nexport function expandContentAuthorProfile<\n  N extends AglynNodeSchema = AglynNodeSchema,\n>(\n  nodes: Record<NodeId, N>,\n  author: ContentAuthorRecord | null | undefined,\n): Record<NodeId, N> {\n  if (!author) return nodes\n  const containers = Object.entries(nodes).filter(\n    ([, node]) => node?.componentId === CONTENT_AUTHOR_PROFILE_COMPONENT_ID,\n  )\n  if (!containers.length) return nodes\n  const links = normalizeContentAuthorLinks(author.links)\n  const values: Record<string, string> = {\n    name: author.name ?? '',\n    bio: author.bio ?? '',\n    image: author.image ?? '',\n    jobTitle: author.jobTitle ?? '',\n    worksFor: author.worksFor ?? '',\n    url: author.url ?? '',\n  }\n  const next: Record<NodeId, N> = { ...nodes }\n  for (const [containerId, container] of containers) {\n    const props = (container.props ?? {}) as Record<string, unknown>\n    const filled: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(values)) {\n      if (String(props[key] ?? '').trim()) continue\n      if (!value) continue\n      filled[key] = value\n    }\n    if (links.length) filled['links'] = links\n    if (!Object.keys(filled).length) continue\n    next[containerId] = {\n      ...container,\n      props: { ...(container.props ?? {}), ...filled } as never,\n    }\n  }\n  return next\n}\n"],"names":["contentAuthorPageUrl","normalizeContentAuthorLinks","CONTENT_AUTHOR_PROFILE_COMPONENT_ID","contentAuthorTokens","author","extras","count","Math","max","floor","Number","entryCount","name","bio","image","jobTitle","worksFor","url","String","expandContentAuthorProfile","nodes","containers","Object","entries","filter","node","componentId","length","links","values","next","containerId","container","props","filled","key","value","trim","keys"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAEEA,oBAAoB,EACpBC,2BAA2B,QACtB,uBAAmB;AAE1B;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,MAAMC,sCAAsC,uBAAsB;AAEzE;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,oBACdC,MAA8C,EAC9CC,MAAgC;;IAEhC,MAAMC,QAAQC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACC,OAAOL,0BAAAA,OAAQM,UAAU,KAAK;IACnE,OAAO;QACL,aAAa,UAAEP,0BAAAA,OAAQQ,IAAI,mBAAI;QAC/B,YAAY,WAAER,0BAAAA,OAAQS,GAAG,oBAAI;QAC7B,cAAc,WAAET,0BAAAA,OAAQU,KAAK,oBAAI;QACjC,iBAAiB,WAAEV,0BAAAA,OAAQW,QAAQ,oBAAI;QACvC,iBAAiB,WAAEX,0BAAAA,OAAQY,QAAQ,oBAAI;QACvC,wEAAwE;QACxE,uEAAuE;QACvE,wBAAwB;QACxB,YAAY,WAAEZ,0BAAAA,OAAQa,GAAG,oBAAI;QAC7B,kBAAkBb,SAASJ,qBAAqB;YAAEI;QAAO,KAAK;QAC9D,qBAAqBc,OAAOZ;QAC5B,yEAAyE;QACzE,uEAAuE;QACvE,wBAAwB;QACxB,0BAA0B,GAAGA,MAAM,CAAC,EAAEA,UAAU,IAAI,SAAS,SAAS;IACxE;AACF;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASa,2BAGdC,KAAwB,EACxBhB,MAA8C;QAStCA,cACDA,aACEA,eACGA,kBACAA,kBACLA;IAZP,IAAI,CAACA,QAAQ,OAAOgB;IACpB,MAAMC,aAAaC,OAAOC,OAAO,CAACH,OAAOI,MAAM,CAC7C,CAAC,GAAGC,KAAK,GAAKA,CAAAA,wBAAAA,KAAMC,WAAW,MAAKxB;IAEtC,IAAI,CAACmB,WAAWM,MAAM,EAAE,OAAOP;IAC/B,MAAMQ,QAAQ3B,4BAA4BG,OAAOwB,KAAK;IACtD,MAAMC,SAAiC;QACrCjB,IAAI,GAAER,eAAAA,OAAOQ,IAAI,YAAXR,eAAe;QACrBS,GAAG,GAAET,cAAAA,OAAOS,GAAG,YAAVT,cAAc;QACnBU,KAAK,GAAEV,gBAAAA,OAAOU,KAAK,YAAZV,gBAAgB;QACvBW,QAAQ,GAAEX,mBAAAA,OAAOW,QAAQ,YAAfX,mBAAmB;QAC7BY,QAAQ,GAAEZ,mBAAAA,OAAOY,QAAQ,YAAfZ,mBAAmB;QAC7Ba,GAAG,GAAEb,cAAAA,OAAOa,GAAG,YAAVb,cAAc;IACrB;IACA,MAAM0B,OAA0B,aAAKV;IACrC,KAAK,MAAM,CAACW,aAAaC,UAAU,IAAIX,WAAY;YAClCW,kBAWAA;QAXf,MAAMC,SAASD,mBAAAA,UAAUC,KAAK,YAAfD,mBAAmB,CAAC;QACnC,MAAME,SAAkC,CAAC;QACzC,KAAK,MAAM,CAACC,KAAKC,MAAM,IAAId,OAAOC,OAAO,CAACM,QAAS;gBACtCI;YAAX,IAAIf,QAAOe,aAAAA,KAAK,CAACE,IAAI,YAAVF,aAAc,IAAII,IAAI,IAAI;YACrC,IAAI,CAACD,OAAO;YACZF,MAAM,CAACC,IAAI,GAAGC;QAChB;QACA,IAAIR,MAAMD,MAAM,EAAEO,MAAM,CAAC,QAAQ,GAAGN;QACpC,IAAI,CAACN,OAAOgB,IAAI,CAACJ,QAAQP,MAAM,EAAE;QACjCG,IAAI,CAACC,YAAY,GAAG,aACfC;YACHC,OAAO,cAAMD,oBAAAA,UAAUC,KAAK,YAAfD,oBAAmB,CAAC,GAAOE;;IAE5C;IACA,OAAOJ;AACT"}