@favish/staffbase-utils 0.10.0 → 0.11.0

package/README.md

@@ -24,9 +24,10 @@ minimumReleaseAgeExclude:
 | Subpath | Exports |
 | --- | --- |
 | `@favish/staffbase-utils/api` | `fetchJson`, `fetchAllPaginated`, `ApiError` |
+| `@favish/staffbase-utils/content` | `resolveLocalizedContent`, `resolveActiveLanguage`, `detectEditorLanguage`, `detectPreviewLanguage` |
 | `@favish/staffbase-utils/log` | `logError`, `logWarn`, `logDebug`, `setLoggingEnabled` |
 | `@favish/staffbase-utils/dom` | `getDynamicClasses` |
-| `@favish/staffbase-utils/types` | `Channel`, `ChannelLink`, `ChannelLinkParameter`, `DropdownOption` (type-only) |
+| `@favish/staffbase-utils/types` | `Channel`, `ChannelLink`, `ChannelLinkParameter`, `DropdownOption`, `LocalizedContent`, `ArticleImage`, `ArticleImageVariant` (type-only) |
 
 More modules (`/env`, `/device`, `/html`, `/links`, `/widgets`) are added per the
 delivery roadmap; each is its own subpath so consumers only bundle what they import.

package/dist/content.cjs.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=()=>typeof document>`u`?null:(document.querySelector(`[aria-selected="true"]`)?.getAttribute(`data-testid`))?.split(`-`).pop()??null,t=()=>{if(typeof window>`u`)return null;let e=window.App?._urlParameters;return e?new URLSearchParams(e).get(`language`):null},n=n=>{let{contentLanguage:r,defaultLanguage:i,isEditor:a}=n,o=r??i;return a?e()??o:r??t()??o},r=(e,t)=>{let{defaultLanguage:r,onError:i}=t;if(!e)return i?.(`Invalid article data or missing contents`),null;let a=n(t),o=e[a]||e[r]||null;if(!o)return i?.(`Content unavailable for language: ${a} or fallback: ${r}`),null;let s=e[r];return{title:o.title||s?.title||``,teaser:o.teaser||s?.teaser||``,content:o.content||s?.content||``,image:o.image||s?.image||``,feedImage:o.feedImage||s?.feedImage||``}};exports.detectEditorLanguage=e,exports.detectPreviewLanguage=t,exports.resolveActiveLanguage=n,exports.resolveLocalizedContent=r;
+//# sourceMappingURL=content.cjs.js.map

package/dist/content.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.cjs.js","names":[],"sources":["../src/content/detectEditorLanguage.ts","../src/content/detectPreviewLanguage.ts","../src/content/resolveActiveLanguage.ts","../src/content/resolveLocalizedContent.ts"],"sourcesContent":["/**\n * Reads the active language from the Staffbase editor's selected language tab\n * (`[aria-selected=\"true\"]` with a `data-testid` suffixed by the language code).\n * Returns null when no tab is active or there is no DOM, so callers can fall back.\n * @returns {string | null} The detected editor language, or null.\n */\nexport const detectEditorLanguage = (): string | null => {\n  if (typeof document === 'undefined') return null\n\n  const activeTab = document.querySelector('[aria-selected=\"true\"]')\n  const testId = activeTab?.getAttribute('data-testid')\n\n  return testId?.split('-').pop() ?? null\n}\n","/**\n * Reads the `language` URL parameter the Staffbase preview shell exposes on\n * `window.App._urlParameters`. Returns null when the shell or parameter is\n * absent (or there is no DOM), so callers can fall back.\n * @returns {string | null} The preview language, or null.\n */\nexport const detectPreviewLanguage = (): string | null => {\n  if (typeof window === 'undefined') return null\n\n  const appConfig = (window as { App?: { _urlParameters?: string } }).App\n    ?._urlParameters\n  if (!appConfig) return null\n\n  return new URLSearchParams(appConfig).get('language')\n}\n","import type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { detectEditorLanguage } from './detectEditorLanguage'\nimport { detectPreviewLanguage } from './detectPreviewLanguage'\n\n/**\n * Resolves the language to render content in.\n *\n * Editor path: the selected language tab wins. Runtime path: the explicit\n * `contentLanguage` is trusted first so the article language matches the rest of\n * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to\n * `contentLanguage ?? defaultLanguage`.\n * @param {ResolveLocalizedContentOptions} options - The resolution options.\n * @returns {string} The resolved active language code.\n */\nexport const resolveActiveLanguage = (\n  options: ResolveLocalizedContentOptions,\n): string => {\n  const { contentLanguage, defaultLanguage, isEditor } = options\n  const fallback = contentLanguage ?? defaultLanguage\n\n  if (isEditor) return detectEditorLanguage() ?? fallback\n\n  return contentLanguage ?? detectPreviewLanguage() ?? fallback\n}\n","import type { LocalizedContent } from '../types/content/LocalizedContent'\nimport type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { resolveActiveLanguage } from './resolveActiveLanguage'\n\n/**\n * Selects and field-merges the localized article content for the active language.\n *\n * Resolves the active language (see resolveActiveLanguage), picks that language's\n * content (falling back to the default language), then fills each field from the\n * default-language entry when the active one is empty. Returns null and reports\n * via `onError` when contents are missing or unavailable in both languages.\n * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.\n * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.\n * @returns {LocalizedContent | null} The merged localized content, or null.\n */\nexport const resolveLocalizedContent = (\n  contents: Record<string, LocalizedContent> | undefined,\n  options: ResolveLocalizedContentOptions,\n): LocalizedContent | null => {\n  const { defaultLanguage, onError } = options\n\n  if (!contents) {\n    onError?.('Invalid article data or missing contents')\n    return null\n  }\n\n  const language = resolveActiveLanguage(options)\n  const localized = contents[language] || contents[defaultLanguage] || null\n\n  if (!localized) {\n    onError?.(\n      `Content unavailable for language: ${language} or fallback: ${defaultLanguage}`,\n    )\n    return null\n  }\n\n  const fallback = contents[defaultLanguage]\n\n  return {\n    title: localized.title || fallback?.title || '',\n    teaser: localized.teaser || fallback?.teaser || '',\n    content: localized.content || fallback?.content || '',\n    image: localized.image || fallback?.image || '',\n    feedImage: localized.feedImage || fallback?.feedImage || '',\n  }\n}\n"],"mappings":"mEAMA,IAAa,MACP,OAAO,SAAa,IAAoB,MAE1B,SAAS,cAAc,wBAC1B,GAAW,aAAa,aAAa,IAErC,MAAM,GAAG,EAAE,IAAI,GAAK,KCNxB,MAA6C,CACxD,GAAI,OAAO,OAAW,IAAa,OAAO,KAE1C,IAAM,EAAa,OAAiD,KAChE,eAGJ,OAFK,EAEE,IAAI,gBAAgB,CAAS,EAAE,IAAI,UAAU,EAF7B,IAGzB,ECAa,EACX,GACW,CACX,GAAM,CAAE,kBAAiB,kBAAiB,YAAa,EACjD,EAAW,GAAmB,EAIpC,OAFI,EAAiB,EAAqB,GAAK,EAExC,GAAmB,EAAsB,GAAK,CACvD,ECRa,GACX,EACA,IAC4B,CAC5B,GAAM,CAAE,kBAAiB,WAAY,EAErC,GAAI,CAAC,EAEH,OADA,IAAU,0CAA0C,EAC7C,KAGT,IAAM,EAAW,EAAsB,CAAO,EACxC,EAAY,EAAS,IAAa,EAAS,IAAoB,KAErE,GAAI,CAAC,EAIH,OAHA,IACE,qCAAqC,EAAS,gBAAgB,GAChE,EACO,KAGT,IAAM,EAAW,EAAS,GAE1B,MAAO,CACL,MAAO,EAAU,OAAS,GAAU,OAAS,GAC7C,OAAQ,EAAU,QAAU,GAAU,QAAU,GAChD,QAAS,EAAU,SAAW,GAAU,SAAW,GACnD,MAAO,EAAU,OAAS,GAAU,OAAS,GAC7C,UAAW,EAAU,WAAa,GAAU,WAAa,EAC3D,CACF"}

package/dist/content.es.mjs

@@ -0,0 +1,26 @@
+//#region src/content/detectEditorLanguage.ts
+var e = () => typeof document > "u" ? null : (document.querySelector("[aria-selected=\"true\"]")?.getAttribute("data-testid"))?.split("-").pop() ?? null, t = () => {
+	if (typeof window > "u") return null;
+	let e = window.App?._urlParameters;
+	return e ? new URLSearchParams(e).get("language") : null;
+}, n = (n) => {
+	let { contentLanguage: r, defaultLanguage: i, isEditor: a } = n, o = r ?? i;
+	return a ? e() ?? o : r ?? t() ?? o;
+}, r = (e, t) => {
+	let { defaultLanguage: r, onError: i } = t;
+	if (!e) return i?.("Invalid article data or missing contents"), null;
+	let a = n(t), o = e[a] || e[r] || null;
+	if (!o) return i?.(`Content unavailable for language: ${a} or fallback: ${r}`), null;
+	let s = e[r];
+	return {
+		title: o.title || s?.title || "",
+		teaser: o.teaser || s?.teaser || "",
+		content: o.content || s?.content || "",
+		image: o.image || s?.image || "",
+		feedImage: o.feedImage || s?.feedImage || ""
+	};
+};
+//#endregion
+export { e as detectEditorLanguage, t as detectPreviewLanguage, n as resolveActiveLanguage, r as resolveLocalizedContent };
+
+//# sourceMappingURL=content.es.mjs.map

package/dist/content.es.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.es.mjs","names":[],"sources":["../src/content/detectEditorLanguage.ts","../src/content/detectPreviewLanguage.ts","../src/content/resolveActiveLanguage.ts","../src/content/resolveLocalizedContent.ts"],"sourcesContent":["/**\n * Reads the active language from the Staffbase editor's selected language tab\n * (`[aria-selected=\"true\"]` with a `data-testid` suffixed by the language code).\n * Returns null when no tab is active or there is no DOM, so callers can fall back.\n * @returns {string | null} The detected editor language, or null.\n */\nexport const detectEditorLanguage = (): string | null => {\n  if (typeof document === 'undefined') return null\n\n  const activeTab = document.querySelector('[aria-selected=\"true\"]')\n  const testId = activeTab?.getAttribute('data-testid')\n\n  return testId?.split('-').pop() ?? null\n}\n","/**\n * Reads the `language` URL parameter the Staffbase preview shell exposes on\n * `window.App._urlParameters`. Returns null when the shell or parameter is\n * absent (or there is no DOM), so callers can fall back.\n * @returns {string | null} The preview language, or null.\n */\nexport const detectPreviewLanguage = (): string | null => {\n  if (typeof window === 'undefined') return null\n\n  const appConfig = (window as { App?: { _urlParameters?: string } }).App\n    ?._urlParameters\n  if (!appConfig) return null\n\n  return new URLSearchParams(appConfig).get('language')\n}\n","import type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { detectEditorLanguage } from './detectEditorLanguage'\nimport { detectPreviewLanguage } from './detectPreviewLanguage'\n\n/**\n * Resolves the language to render content in.\n *\n * Editor path: the selected language tab wins. Runtime path: the explicit\n * `contentLanguage` is trusted first so the article language matches the rest of\n * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to\n * `contentLanguage ?? defaultLanguage`.\n * @param {ResolveLocalizedContentOptions} options - The resolution options.\n * @returns {string} The resolved active language code.\n */\nexport const resolveActiveLanguage = (\n  options: ResolveLocalizedContentOptions,\n): string => {\n  const { contentLanguage, defaultLanguage, isEditor } = options\n  const fallback = contentLanguage ?? defaultLanguage\n\n  if (isEditor) return detectEditorLanguage() ?? fallback\n\n  return contentLanguage ?? detectPreviewLanguage() ?? fallback\n}\n","import type { LocalizedContent } from '../types/content/LocalizedContent'\nimport type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions'\nimport { resolveActiveLanguage } from './resolveActiveLanguage'\n\n/**\n * Selects and field-merges the localized article content for the active language.\n *\n * Resolves the active language (see resolveActiveLanguage), picks that language's\n * content (falling back to the default language), then fills each field from the\n * default-language entry when the active one is empty. Returns null and reports\n * via `onError` when contents are missing or unavailable in both languages.\n * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.\n * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.\n * @returns {LocalizedContent | null} The merged localized content, or null.\n */\nexport const resolveLocalizedContent = (\n  contents: Record<string, LocalizedContent> | undefined,\n  options: ResolveLocalizedContentOptions,\n): LocalizedContent | null => {\n  const { defaultLanguage, onError } = options\n\n  if (!contents) {\n    onError?.('Invalid article data or missing contents')\n    return null\n  }\n\n  const language = resolveActiveLanguage(options)\n  const localized = contents[language] || contents[defaultLanguage] || null\n\n  if (!localized) {\n    onError?.(\n      `Content unavailable for language: ${language} or fallback: ${defaultLanguage}`,\n    )\n    return null\n  }\n\n  const fallback = contents[defaultLanguage]\n\n  return {\n    title: localized.title || fallback?.title || '',\n    teaser: localized.teaser || fallback?.teaser || '',\n    content: localized.content || fallback?.content || '',\n    image: localized.image || fallback?.image || '',\n    feedImage: localized.feedImage || fallback?.feedImage || '',\n  }\n}\n"],"mappings":";AAMA,IAAa,UACP,OAAO,WAAa,MAAoB,QAE1B,SAAS,cAAc,0BAC1B,GAAW,aAAa,aAAa,IAErC,MAAM,GAAG,EAAE,IAAI,KAAK,MCNxB,UAA6C;CACxD,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAM,IAAa,OAAiD,KAChE;CAGJ,OAFK,IAEE,IAAI,gBAAgB,CAAS,EAAE,IAAI,UAAU,IAF7B;AAGzB,GCAa,KACX,MACW;CACX,IAAM,EAAE,oBAAiB,oBAAiB,gBAAa,GACjD,IAAW,KAAmB;CAIpC,OAFI,IAAiB,EAAqB,KAAK,IAExC,KAAmB,EAAsB,KAAK;AACvD,GCRa,KACX,GACA,MAC4B;CAC5B,IAAM,EAAE,oBAAiB,eAAY;CAErC,IAAI,CAAC,GAEH,OADA,IAAU,0CAA0C,GAC7C;CAGT,IAAM,IAAW,EAAsB,CAAO,GACxC,IAAY,EAAS,MAAa,EAAS,MAAoB;CAErE,IAAI,CAAC,GAIH,OAHA,IACE,qCAAqC,EAAS,gBAAgB,GAChE,GACO;CAGT,IAAM,IAAW,EAAS;CAE1B,OAAO;EACL,OAAO,EAAU,SAAS,GAAU,SAAS;EAC7C,QAAQ,EAAU,UAAU,GAAU,UAAU;EAChD,SAAS,EAAU,WAAW,GAAU,WAAW;EACnD,OAAO,EAAU,SAAS,GAAU,SAAS;EAC7C,WAAW,EAAU,aAAa,GAAU,aAAa;CAC3D;AACF"}

package/dist/src/content/detectEditorLanguage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the active language from the Staffbase editor's selected language tab
+ * (`[aria-selected="true"]` with a `data-testid` suffixed by the language code).
+ * Returns null when no tab is active or there is no DOM, so callers can fall back.
+ * @returns {string | null} The detected editor language, or null.
+ */
+export declare const detectEditorLanguage: () => string | null;
+//# sourceMappingURL=detectEditorLanguage.d.ts.map

package/dist/src/content/detectEditorLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectEditorLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/detectEditorLanguage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAAM,GAAG,IAOhD,CAAA"}

package/dist/src/content/detectPreviewLanguage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads the `language` URL parameter the Staffbase preview shell exposes on
+ * `window.App._urlParameters`. Returns null when the shell or parameter is
+ * absent (or there is no DOM), so callers can fall back.
+ * @returns {string | null} The preview language, or null.
+ */
+export declare const detectPreviewLanguage: () => string | null;
+//# sourceMappingURL=detectPreviewLanguage.d.ts.map

package/dist/src/content/detectPreviewLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectPreviewLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/detectPreviewLanguage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,GAAG,IAQjD,CAAA"}

package/dist/src/content/index.d.ts

@@ -0,0 +1,6 @@
+export { detectEditorLanguage } from './detectEditorLanguage';
+export { detectPreviewLanguage } from './detectPreviewLanguage';
+export { resolveActiveLanguage } from './resolveActiveLanguage';
+export { resolveLocalizedContent } from './resolveLocalizedContent';
+export type { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,YAAY,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA"}

package/dist/src/content/resolveActiveLanguage.d.ts

@@ -0,0 +1,13 @@
+import { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+/**
+ * Resolves the language to render content in.
+ *
+ * Editor path: the selected language tab wins. Runtime path: the explicit
+ * `contentLanguage` is trusted first so the article language matches the rest of
+ * the UI, with preview-URL sniffing only as a fallback. Both paths fall back to
+ * `contentLanguage ?? defaultLanguage`.
+ * @param {ResolveLocalizedContentOptions} options - The resolution options.
+ * @returns {string} The resolved active language code.
+ */
+export declare const resolveActiveLanguage: (options: ResolveLocalizedContentOptions) => string;
+//# sourceMappingURL=resolveActiveLanguage.d.ts.map

package/dist/src/content/resolveActiveLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveActiveLanguage.d.ts","sourceRoot":"","sources":["../../../src/content/resolveActiveLanguage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA;AAIrG;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,8BAA8B,KACtC,MAOF,CAAA"}

package/dist/src/content/resolveLocalizedContent.d.ts

@@ -0,0 +1,15 @@
+import { LocalizedContent } from '../types/content/LocalizedContent';
+import { ResolveLocalizedContentOptions } from '../types/content/ResolveLocalizedContentOptions';
+/**
+ * Selects and field-merges the localized article content for the active language.
+ *
+ * Resolves the active language (see resolveActiveLanguage), picks that language's
+ * content (falling back to the default language), then fills each field from the
+ * default-language entry when the active one is empty. Returns null and reports
+ * via `onError` when contents are missing or unavailable in both languages.
+ * @param {Record<string, LocalizedContent> | undefined} contents - The article's per-language contents.
+ * @param {ResolveLocalizedContentOptions} options - Language and diagnostics options.
+ * @returns {LocalizedContent | null} The merged localized content, or null.
+ */
+export declare const resolveLocalizedContent: (contents: Record<string, LocalizedContent> | undefined, options: ResolveLocalizedContentOptions) => LocalizedContent | null;
+//# sourceMappingURL=resolveLocalizedContent.d.ts.map

package/dist/src/content/resolveLocalizedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLocalizedContent.d.ts","sourceRoot":"","sources":["../../../src/content/resolveLocalizedContent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAA;AAGrG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EACtD,SAAS,8BAA8B,KACtC,gBAAgB,GAAG,IA2BrB,CAAA"}

package/dist/src/types/content/ArticleImage.d.ts

@@ -0,0 +1,17 @@
+import { ArticleImageVariant } from './ArticleImageVariant';
+/**
+ * The set of rendition variants the Staffbase media API returns for an article
+ * image. Named `ArticleImage` (not `Image`) to avoid shadowing the DOM global.
+ */
+export interface ArticleImage {
+    original: ArticleImageVariant & {
+        size: number;
+    };
+    original_scaled: ArticleImageVariant;
+    thumb: ArticleImageVariant;
+    wide: ArticleImageVariant;
+    compact: ArticleImageVariant;
+    wide_first: ArticleImageVariant;
+    compact_first: ArticleImageVariant;
+}
+//# sourceMappingURL=ArticleImage.d.ts.map

package/dist/src/types/content/ArticleImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArticleImage.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ArticleImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,eAAe,EAAE,mBAAmB,CAAA;IACpC,KAAK,EAAE,mBAAmB,CAAA;IAC1B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,mBAAmB,CAAA;IAC/B,aAAa,EAAE,mBAAmB,CAAA;CACnC"}

package/dist/src/types/content/ArticleImageVariant.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A single rendition of an article image (a size/format variant returned by the
+ * Staffbase media API). `size` is only present on the original variant.
+ */
+export interface ArticleImageVariant {
+    width: number;
+    height: number;
+    size?: number;
+    format: string | null;
+    mimeType: string | null;
+    url: string;
+}
+//# sourceMappingURL=ArticleImageVariant.d.ts.map

package/dist/src/types/content/ArticleImageVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArticleImageVariant.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ArticleImageVariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ"}

package/dist/src/types/content/LocalizedContent.d.ts

@@ -0,0 +1,16 @@
+import { ArticleImage } from './ArticleImage';
+/**
+ * The per-language content of an article (one entry of `ArticleData.contents`).
+ *
+ * `image` is `ArticleImage | string | null` because the API returns either the
+ * structured rendition set, a bare URL string, or nothing. Shared verbatim by
+ * the alerts and unacknowledged-bulletins widgets.
+ */
+export interface LocalizedContent {
+    title: string;
+    teaser: string;
+    content: string;
+    image: ArticleImage | string | null;
+    feedImage: string | null;
+}
+//# sourceMappingURL=LocalizedContent.d.ts.map

package/dist/src/types/content/LocalizedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizedContent.d.ts","sourceRoot":"","sources":["../../../../src/types/content/LocalizedContent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB"}

package/dist/src/types/content/ResolveLocalizedContentOptions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for resolveLocalizedContent.
+ */
+export interface ResolveLocalizedContentOptions {
+    /**
+     * Language explicitly requested by the host/widget config. On the runtime path
+     * this is trusted first so the article language matches the rest of the UI;
+     * DOM/URL sniffing is only a fallback.
+     */
+    contentLanguage?: string;
+    /** Fallback language. Injected because the library never reads env. */
+    defaultLanguage: string;
+    /** When true, resolves the active language from the editor's selected tab. */
+    isEditor?: boolean;
+    /**
+     * Called with a diagnostic message when content cannot be resolved (the
+     * library does not log directly).
+     * @param {string} message - The diagnostic message.
+     * @param {...unknown} args - Optional extra context.
+     * @returns {void} Nothing.
+     */
+    onError?: (message: string, ...args: unknown[]) => void;
+}
+//# sourceMappingURL=ResolveLocalizedContentOptions.d.ts.map

package/dist/src/types/content/ResolveLocalizedContentOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveLocalizedContentOptions.d.ts","sourceRoot":"","sources":["../../../../src/types/content/ResolveLocalizedContentOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACxD"}

package/dist/src/types/content/index.d.ts

@@ -1,5 +1,8 @@
+export type { ArticleImage } from './ArticleImage';
+export type { ArticleImageVariant } from './ArticleImageVariant';
 export type { Channel } from './Channel';
 export type { ChannelLink } from './ChannelLink';
 export type { ChannelLinkParameter } from './ChannelLinkParameter';
 export type { DropdownOption } from './DropdownOption';
+export type { LocalizedContent } from './LocalizedContent';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/content/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/content/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@favish/staffbase-utils",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Shared internal/host utilities for Staffbase widgets",
   "author": "Favish <dev@favish.com>",
   "license": "UNLICENSED",
@@ -13,6 +13,11 @@
       "import": "./dist/api.es.mjs",
       "require": "./dist/api.cjs.js"
     },
+    "./content": {
+      "types": "./dist/src/content/index.d.ts",
+      "import": "./dist/content.es.mjs",
+      "require": "./dist/content.cjs.js"
+    },
     "./log": {
       "types": "./dist/src/log/index.d.ts",
       "import": "./dist/log.es.mjs",