@burdenoff/microfe-theculturepost 2026.705.2 → 2026.709.2

package/dist/theculturepost/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/theculturepost/hooks/index.js

@@ -1,3 +1,5 @@
+import "./usePageAnalytics.js";
 import "./useFiles.js";
 import "./useTcpApi.js";
 import "./useCursorPager.js";
+import "./useTr.js";

package/dist/theculturepost/hooks/useCursorPager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * useCursorPager — forward/back cursor pagination for Tcp* list connections.
+ * @module theculturepost/hooks
+ *
+ * The svc paginates by cursor: a page must send `pagination.cursor = the
+ * previous page's pageInfo.cursor` to advance. This hook keeps a stack of the
+ * cursors that opened each visited page so Prev/Next are exact, and exposes a
+ * 0-indexed `page` for display.
+ */
+export interface CursorPager {
+    /** 0-indexed page number for display. */
+    page: number;
+    /**
+     * Cursor that opens the current page — `undefined` on the first page so it is
+     * OMITTED from the GraphQL variables (the svc rejects an explicit `cursor: null`;
+     * a first page must send no cursor at all, per cursor-pagination convention).
+     */
+    cursor: string | undefined;
+    /** Advance to the next page using the current page's end cursor. No-op if null. */
+    next: (endCursor: string | null | undefined) => void;
+    /** Go back one page. No-op on the first page. */
+    prev: () => void;
+    /** Reset to the first page (call when filters change). */
+    reset: () => void;
+    /**
+     * Adapter for `<Pagination onPageChange>` — compares the requested page to the
+     * current one and calls next()/prev() accordingly.
+     */
+    onPageChange: (targetPage: number, endCursor: string | null | undefined) => void;
+}
+export declare function useCursorPager(): CursorPager;
+//# sourceMappingURL=useCursorPager.d.ts.map

package/dist/theculturepost/hooks/useCursorPager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCursorPager.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/useCursorPager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mFAAmF;IACnF,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,iDAAiD;IACjD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;CAClF;AAED,wBAAgB,cAAc,IAAI,WAAW,CA4B5C"}

package/dist/theculturepost/hooks/useFiles.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File hooks — covers, artifacts & recordings via wspace-files-svc (NO duplication).
+ * @module theculturepost/hooks
+ *
+ * TheCulturePost never stores blobs. Stories keep `coverFileId`, archive items
+ * keep `fileId`, citations keep `sourceFileId`, oral histories keep
+ * `recordingFileId` — all pointing at files owned by wspace-files-svc. Upload
+ * goes through the shared `uploadBlobToFiles` storage helper (presigned 3-step
+ * upload) against the workspace Apollo client the shell initialises; display
+ * resolves a file id to a presigned URL via `getFileDownloadUrl`.
+ */
+export declare const FILE_FOLDERS: {
+    readonly covers: "/TheCulturePost/Covers";
+    readonly artifacts: "/TheCulturePost/Artifacts";
+    readonly recordings: "/TheCulturePost/Recordings";
+};
+export interface UploadedFile {
+    id: string;
+    url: string;
+    name: string;
+}
+/**
+ * Upload a file (image, audio, document…) to wspace-files-svc and return its id
+ * + a presigned URL. The caller persists the id (coverFileId / fileId /
+ * recordingFileId / sourceFileId) via the entity's own tcp* mutation; the URL is
+ * used for an immediate preview.
+ */
+export declare function uploadImageToFiles(file: File, folderPath: string): Promise<UploadedFile>;
+/** Resolve a wspace-files-svc file id to a presigned download URL for display. */
+export declare function useFileUrl(fileId?: string | null): import('@tanstack/react-query').UseQueryResult<string | null, Error>;
+//# sourceMappingURL=useFiles.d.ts.map

package/dist/theculturepost/hooks/useFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFiles.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/useFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAgBX,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AASD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+B9F;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,wEAqBhD"}

package/dist/theculturepost/hooks/usePageAnalytics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Page-view analytics hook for TheCulturePost.
+ *
+ * Emits product-specific page-view events on the shared event bus. The shell's
+ * RybbitSink forwards allow-listed events to Rybbit Cloud; events not in the
+ * allowlist are dropped silently by the sink.
+ */
+export declare function usePageAnalytics(): void;
+//# sourceMappingURL=usePageAnalytics.d.ts.map

package/dist/theculturepost/hooks/usePageAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageAnalytics.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/usePageAnalytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,wBAAgB,gBAAgB,IAAI,IAAI,CAoBvC"}

package/dist/theculturepost/hooks/usePageAnalytics.js

@@ -0,0 +1,34 @@
+import { useTheCulturePost as e } from "../context/TheCulturePostContext.js";
+import "../context/index.js";
+import { useEffect as t } from "react";
+import { useEventBus as n } from "@burdenoff/fe-libs/shared/events";
+//#region src/theculturepost/hooks/usePageAnalytics.ts
+var r = "theculturepost";
+function i(e) {
+	let t = e.split("/").filter(Boolean), n = t[0] ?? "home";
+	return t.length <= 1 ? n : [
+		"stories",
+		"topics",
+		"discussions",
+		"archive"
+	].includes(t[1] ?? "") ? t.length >= 3 ? `${t[1]}.detail` : t[1] ?? n : t.slice(1).join(".");
+}
+function a() {
+	let a = n(), { basePath: o } = e();
+	t(() => {
+		let e = () => {
+			let e = window.location.pathname, t = i(e.replace(o ?? "", "") || "/");
+			a.emitCustom("theculturepost.page.viewed", {
+				product: r,
+				page: t,
+				path: e,
+				referrer: typeof document < "u" ? document.referrer : void 0
+			});
+		};
+		return e(), window.addEventListener("popstate", e), () => window.removeEventListener("popstate", e);
+	}, [o, a]);
+}
+//#endregion
+export { a as usePageAnalytics };
+
+//# sourceMappingURL=usePageAnalytics.js.map

package/dist/theculturepost/hooks/usePageAnalytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageAnalytics.js","names":[],"sources":["../../../src/theculturepost/hooks/usePageAnalytics.ts"],"sourcesContent":["/**\n * Page-view analytics hook for TheCulturePost.\n *\n * Emits product-specific page-view events on the shared event bus. The shell's\n * RybbitSink forwards allow-listed events to Rybbit Cloud; events not in the\n * allowlist are dropped silently by the sink.\n */\n\nimport { useEffect } from 'react';\nimport { useEventBus } from '@burdenoff/fe-libs/shared/events';\nimport { useTheCulturePost } from '#theculturepost/context';\n\nconst PRODUCT = 'theculturepost';\n\nfunction normalizePageName(pathname: string): string {\n  const segments = pathname.split('/').filter(Boolean);\n  const base = segments[0] ?? 'home';\n  if (segments.length <= 1) return base;\n  // Detail routes collapse to `{entity}.detail`\n  if (['stories', 'topics', 'discussions', 'archive'].includes(segments[1] ?? '')) {\n    if (segments.length >= 3) return `${segments[1]}.detail`;\n    return segments[1] ?? base;\n  }\n  return segments.slice(1).join('.');\n}\n\nexport function usePageAnalytics(): void {\n  const bus = useEventBus();\n  const { basePath } = useTheCulturePost();\n\n  useEffect(() => {\n    const sendPageView = () => {\n      const pathname = window.location.pathname;\n      const pageName = normalizePageName(pathname.replace(basePath ?? '', '') || '/');\n      bus.emitCustom('theculturepost.page.viewed', {\n        product: PRODUCT,\n        page: pageName,\n        path: pathname,\n        referrer: typeof document !== 'undefined' ? document.referrer : undefined,\n      });\n    };\n\n    sendPageView();\n    window.addEventListener('popstate', sendPageView);\n    return () => window.removeEventListener('popstate', sendPageView);\n  }, [basePath, bus]);\n}\n"],"mappings":";;;;;AAYA,IAAM,IAAU;AAEhB,SAAS,EAAkB,GAA0B;CACnD,IAAM,IAAW,EAAS,MAAM,IAAI,CAAC,OAAO,QAAQ,EAC9C,IAAO,EAAS,MAAM;AAO5B,QANI,EAAS,UAAU,IAAU,IAE7B;EAAC;EAAW;EAAU;EAAe;EAAU,CAAC,SAAS,EAAS,MAAM,GAAG,GACzE,EAAS,UAAU,IAAU,GAAG,EAAS,GAAG,WACzC,EAAS,MAAM,IAEjB,EAAS,MAAM,EAAE,CAAC,KAAK,IAAI;;AAGpC,SAAgB,IAAyB;CACvC,IAAM,IAAM,GAAa,EACnB,EAAE,gBAAa,GAAmB;AAExC,SAAgB;EACd,IAAM,UAAqB;GACzB,IAAM,IAAW,OAAO,SAAS,UAC3B,IAAW,EAAkB,EAAS,QAAQ,KAAY,IAAI,GAAG,IAAI,IAAI;AAC/E,KAAI,WAAW,8BAA8B;IAC3C,SAAS;IACT,MAAM;IACN,MAAM;IACN,UAAU,OAAO,WAAa,MAAc,SAAS,WAAW,KAAA;IACjE,CAAC;;AAKJ,SAFA,GAAc,EACd,OAAO,iBAAiB,YAAY,EAAa,QACpC,OAAO,oBAAoB,YAAY,EAAa;IAChE,CAAC,GAAU,EAAI,CAAC"}

package/dist/theculturepost/hooks/useTcpApi.d.ts

@@ -0,0 +1,74 @@
+import { TcpConnection, TcpStory, TcpStoryStatus, TcpTopic, TcpTopicCategory, TcpCitation, TcpVerificationStatus, TcpDiscussion, TcpReply, TcpModerationStatus, TcpCollection, TcpArchiveItem, TcpArchiveItemKind, TcpAccessLevel, TcpOralHistory, TcpCreateStoryInput, TcpUpdateStoryInput, TcpCreateTopicInput, TcpUpdateTopicInput, TcpCreateCitationInput, TcpCreateDiscussionInput, TcpCreateReplyInput, TcpCreateCollectionInput, TcpCreateArchiveItemInput, TcpUpdateArchiveItemInput, TcpCreateOralHistoryInput, PaginationInput } from '../types';
+
+export interface StoryFilters {
+    status?: TcpStoryStatus;
+    topicId?: string;
+    pagination?: PaginationInput;
+}
+export declare const useTcpStories: (filters?: StoryFilters) => import('@tanstack/react-query').UseQueryResult<TcpConnection<TcpStory>, Error>;
+export declare const useTcpStory: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpStory | null, Error>;
+export declare const useTcpCreateStory: () => import('@tanstack/react-query').UseMutationResult<TcpStory, Error, TcpCreateStoryInput, unknown>;
+export declare const useTcpUpdateStory: () => import('@tanstack/react-query').UseMutationResult<TcpStory, Error, {
+    id: string;
+    input: TcpUpdateStoryInput;
+}, unknown>;
+export declare const useTcpTransitionStory: () => import('@tanstack/react-query').UseMutationResult<TcpStory, Error, {
+    id: string;
+    status: TcpStoryStatus;
+}, unknown>;
+export declare const useTcpCitations: (storyId: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpCitation[], Error>;
+export declare const useTcpAddCitation: () => import('@tanstack/react-query').UseMutationResult<TcpCitation, Error, TcpCreateCitationInput, unknown>;
+export declare const useTcpVerifyCitation: () => import('@tanstack/react-query').UseMutationResult<TcpCitation, Error, {
+    id: string;
+    verification: TcpVerificationStatus;
+}, unknown>;
+export interface TopicFilters {
+    category?: TcpTopicCategory;
+    pagination?: PaginationInput;
+}
+export declare const useTcpTopics: (filters?: TopicFilters) => import('@tanstack/react-query').UseQueryResult<TcpConnection<TcpTopic>, Error>;
+export declare const useTcpTopic: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpTopic | null, Error>;
+export declare const useTcpCreateTopic: () => import('@tanstack/react-query').UseMutationResult<TcpTopic, Error, TcpCreateTopicInput, unknown>;
+export declare const useTcpUpdateTopic: () => import('@tanstack/react-query').UseMutationResult<TcpTopic, Error, {
+    id: string;
+    input: TcpUpdateTopicInput;
+}, unknown>;
+export declare const useTcpArchiveTopic: () => import('@tanstack/react-query').UseMutationResult<boolean, Error, string, unknown>;
+export interface DiscussionFilters {
+    status?: TcpModerationStatus;
+    storyId?: string;
+    pagination?: PaginationInput;
+}
+export declare const useTcpDiscussions: (filters?: DiscussionFilters) => import('@tanstack/react-query').UseQueryResult<TcpConnection<TcpDiscussion>, Error>;
+export declare const useTcpDiscussion: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpDiscussion | null, Error>;
+export declare const useTcpReplies: (discussionId: string | undefined, status?: TcpModerationStatus) => import('@tanstack/react-query').UseQueryResult<TcpReply[], Error>;
+export declare const useTcpOpenDiscussion: () => import('@tanstack/react-query').UseMutationResult<TcpDiscussion, Error, TcpCreateDiscussionInput, unknown>;
+export declare const useTcpPostReply: () => import('@tanstack/react-query').UseMutationResult<TcpReply, Error, TcpCreateReplyInput, unknown>;
+export declare const useTcpModerateReply: () => import('@tanstack/react-query').UseMutationResult<TcpReply, Error, {
+    id: string;
+    status: TcpModerationStatus;
+}, unknown>;
+export declare const useTcpLockDiscussion: () => import('@tanstack/react-query').UseMutationResult<TcpDiscussion, Error, string, unknown>;
+export declare const useTcpCollections: (pagination?: PaginationInput) => import('@tanstack/react-query').UseQueryResult<TcpCollection[], Error>;
+export declare const useTcpCollection: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpCollection | null, Error>;
+export declare const useTcpCreateCollection: () => import('@tanstack/react-query').UseMutationResult<TcpCollection, Error, TcpCreateCollectionInput, unknown>;
+export interface ArchiveItemFilters {
+    accessLevel?: TcpAccessLevel;
+    collectionId?: string;
+    kind?: TcpArchiveItemKind;
+    pagination?: PaginationInput;
+}
+export declare const useTcpArchiveItems: (filters?: ArchiveItemFilters) => import('@tanstack/react-query').UseQueryResult<TcpConnection<TcpArchiveItem>, Error>;
+export declare const useTcpArchiveItem: (id: string | undefined) => import('@tanstack/react-query').UseQueryResult<TcpArchiveItem | null, Error>;
+export declare const useTcpCreateArchiveItem: () => import('@tanstack/react-query').UseMutationResult<TcpArchiveItem, Error, TcpCreateArchiveItemInput, unknown>;
+export declare const useTcpUpdateArchiveItem: () => import('@tanstack/react-query').UseMutationResult<TcpArchiveItem, Error, {
+    id: string;
+    input: TcpUpdateArchiveItemInput;
+}, unknown>;
+export declare const useTcpArchiveArchiveItem: () => import('@tanstack/react-query').UseMutationResult<boolean, Error, {
+    id: string;
+    collectionId?: string | null;
+}, unknown>;
+export declare const useTcpOralHistories: (collectionId?: string) => import('@tanstack/react-query').UseQueryResult<TcpOralHistory[], Error>;
+export declare const useTcpRecordOralHistory: () => import('@tanstack/react-query').UseMutationResult<TcpOralHistory, Error, TcpCreateOralHistoryInput, unknown>;
+//# sourceMappingURL=useTcpApi.d.ts.map

package/dist/theculturepost/hooks/useTcpApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTcpApi.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/useTcpApi.ts"],"names":[],"mappings":"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"}

package/dist/theculturepost/hooks/useTr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Translation hook for TheCulturePost microfrontend.
+ *
+ * Wraps the shell's `useI18n()` and provides an inline English fallback plus
+ * simple `{{param}}` interpolation, matching the VibeControls MFE pattern.
+ */
+export declare function useTr(): (key: string, fallback: string, params?: Record<string, string | number>) => string;
+//# sourceMappingURL=useTr.d.ts.map

package/dist/theculturepost/hooks/useTr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTr.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/hooks/useTr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,wBAAgB,KAAK,UAIX,MAAM,YAAY,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,MAAM,CAYpF"}

package/dist/theculturepost/hooks/useTr.js

@@ -0,0 +1,14 @@
+import { useCallback as e } from "react";
+import { useI18n as t } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+//#region src/theculturepost/hooks/useTr.ts
+function n() {
+	let { t: n, locale: r } = t();
+	return e((e, t, r) => {
+		let i = n(e), a = i === e ? t : i;
+		return r ? Object.entries(r).reduce((e, [t, n]) => e.replace(RegExp(`\\{\\{${t}\\}\\}`, "g"), String(n)), a) : a;
+	}, [n, r]);
+}
+//#endregion
+export { n as useTr };
+
+//# sourceMappingURL=useTr.js.map

package/dist/theculturepost/hooks/useTr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTr.js","names":[],"sources":["../../../src/theculturepost/hooks/useTr.ts"],"sourcesContent":["/**\n * Translation hook for TheCulturePost microfrontend.\n *\n * Wraps the shell's `useI18n()` and provides an inline English fallback plus\n * simple `{{param}}` interpolation, matching the VibeControls MFE pattern.\n */\n\nimport { useCallback } from 'react';\nimport { useI18n } from '@burdenoff/fe-libs/shared/providers/shell/I18nProvider';\n\nexport function useTr() {\n  const { t, locale } = useI18n();\n\n  return useCallback(\n    (key: string, fallback: string, params?: Record<string, string | number>): string => {\n      const translated = t(key);\n      const source = translated === key ? fallback : translated;\n      if (!params) return source;\n      return Object.entries(params).reduce(\n        (acc, [paramKey, value]) =>\n          acc.replace(new RegExp(`\\\\{\\\\{${paramKey}\\\\}\\\\}`, 'g'), String(value)),\n        source\n      );\n    },\n    [t, locale]\n  );\n}\n"],"mappings":";;;AAUA,SAAgB,IAAQ;CACtB,IAAM,EAAE,MAAG,cAAW,GAAS;AAE/B,QAAO,GACJ,GAAa,GAAkB,MAAqD;EACnF,IAAM,IAAa,EAAE,EAAI,EACnB,IAAS,MAAe,IAAM,IAAW;AAE/C,SADK,IACE,OAAO,QAAQ,EAAO,CAAC,QAC3B,GAAK,CAAC,GAAU,OACf,EAAI,QAAY,OAAO,SAAS,EAAS,SAAS,IAAI,EAAE,OAAO,EAAM,CAAC,EACxE,EACD,GALmB;IAOtB,CAAC,GAAG,EAAO,CACZ"}

package/dist/theculturepost/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * TheCulturePost Module Exports
+ * @module theculturepost
+ */
+export { TheCulturePostRoot } from './TheCulturePostRoot';
+export type { TheCulturePostRootProps, NavItem, FooterItem } from './types';
+export { TheCulturePostProvider, useTheCulturePost } from './context';
+export { cn, joinPath, formatDate, formatDateTime, formatRelativeTime, formatNumber, formatDuration, formatEnumLabel, tWithFallback, slugify, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/theculturepost/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theculturepost/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,YAAY,EAAE,uBAAuB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG5E,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGtE,OAAO,EACL,EAAE,EACF,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,OAAO,GACR,MAAM,SAAS,CAAC"}

package/dist/theculturepost/index.js

@@ -1,8 +1,9 @@
 import "./utils/navigation.js";
 import "./context/TheCulturePostContext.js";
-import "./utils/cn.js";
 import "./context/index.js";
+import "./utils/cn.js";
 import "./utils/formatters.js";
 import "./TheCulturePostRoot.js";
 import "./utils/i18n.js";
 import "./utils/slug.js";
+import "./utils/index.js";

package/dist/theculturepost/lib/graphql-cache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * graphql-cache — invalidate fe-libs' imperative-fetch response cache after writes.
+ * @module theculturepost/lib
+ *
+ * `graphqlFetch` (from `@burdenoff/fe-libs/shared/graphql`) coalesces reads by
+ * caching every RESOLVED `query` response for ~15s (keyed by operationName +
+ * variables) and de-duping in-flight requests. A refetch issued right after a
+ * mutation — which is exactly what our React-Query `invalidateQueries` triggers
+ * — otherwise gets served the PRE-mutation response, so created/updated/deleted
+ * rows stay invisible until a full page reload.
+ *
+ * fe-libs' own Apollo client fixes this by calling `clearGraphqlFetchResponseCache()`
+ * on every mutation, but that helper is not re-exported from the package's public
+ * entry, and we use the raw `graphqlFetch` transport (no Apollo client). The two
+ * caches are plain `Map`s that fe-libs stores directly on `globalThis`
+ * (`getGraphqlFetchGlobalState()` returns `globalThis`), so we clear the same two
+ * globals here — mirroring `clearGraphqlFetchResponseCache` — to force every
+ * post-write read back onto the network.
+ */
+/**
+ * Clear fe-libs' resolved-response cache and in-flight de-dupe map so the next
+ * read of any query hits the gateway. Safe to call unconditionally; a no-op
+ * before the caches have been created.
+ */
+export declare function clearGraphqlResponseCache(): void;
+//# sourceMappingURL=graphql-cache.d.ts.map

package/dist/theculturepost/lib/graphql-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-cache.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/lib/graphql-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAIhD"}

package/dist/theculturepost/lib/toast.d.ts

@@ -0,0 +1,23 @@
+import { toast } from 'sonner';
+
+/**
+ * Module-wide toast API. sonner is a global singleton; the matching <Toaster>
+ * is owned by the HOST app shell. Every page/component surfaces feedback through
+ * these helpers instead of hand-rolling fixed-position toast markup, so
+ * success/error notifications stay consistent with the rest of the platform.
+ *
+ * Durations follow the notification spec: success/info auto-dismiss, errors stay
+ * until the user dismisses them (sonner renders a close button and announces via
+ * aria-live).
+ */
+export declare const notify: {
+    success(message: string, description?: string): void;
+    info(message: string, description?: string): void;
+    warning(message: string, description?: string): void;
+    error(message: string, description?: string): void;
+    dismiss(id?: string | number): void;
+};
+/** Normalize an unknown thrown value into a human-readable message. */
+export declare function describeError(error: unknown): string;
+export { toast };
+//# sourceMappingURL=toast.d.ts.map

package/dist/theculturepost/lib/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/lib/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM;qBACA,MAAM,gBAAgB,MAAM,GAAG,IAAI;kBAGtC,MAAM,gBAAgB,MAAM,GAAG,IAAI;qBAGhC,MAAM,gBAAgB,MAAM,GAAG,IAAI;mBAGrC,MAAM,gBAAgB,MAAM,GAAG,IAAI;iBAGrC,MAAM,GAAG,MAAM,GAAG,IAAI;CAGpC,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIpD;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/theculturepost/pages/HomePage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * HomePage — the editorial-magazine landing for TheCulturePost.
+ * @module theculturepost/pages
+ *
+ * Layout: a decorative {@link PageHero}, then a two-column magazine grid —
+ *  - main column: "Featured topics" ({@link TopicCard}) + "Latest published
+ *    stories" ({@link StoryCard} status:PUBLISHED)
+ *  - right rail (compact): "Active discussions" (status:APPROVED) rows +
+ *    "From the archive" collection thumbnails.
+ *
+ * Every surface links into its section and shows an honest empty state when it
+ * has no data. Only real schema fields are rendered — no fabricated metrics,
+ * avatars or imagery (topics/discussions use token-only decorative motifs).
+ */
+export declare function HomePage(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HomePage.d.ts.map

package/dist/theculturepost/pages/HomePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HomePage.d.ts","sourceRoot":"","sources":["../../../src/theculturepost/pages/HomePage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiKH,wBAAgB,QAAQ,4CA2MvB"}

package/dist/theculturepost/pages/HomePage.js

@@ -142,17 +142,20 @@ function k() {
 			className: "flex-1 overflow-auto",
 			children: /* @__PURE__ */ S("div", {
 				className: "mx-auto flex max-w-7xl flex-col gap-8 p-4 sm:p-6",
-				children: [/* @__PURE__ */ x(n, {
-					eyebrow: "TheCulturePost",
-					title: "Culture, religion, values & history — told with care",
-					description: "A space for respectful stories and thoughtful conversations that connect us across traditions and time — grounded in the record.",
-					actions: /* @__PURE__ */ S(C, {
-						size: "lg",
-						onClick: () => t("stories"),
-						children: [/* @__PURE__ */ x(h, {
-							className: "mr-1.5 h-4 w-4",
-							"aria-hidden": "true"
-						}), " Read stories"]
+				children: [/* @__PURE__ */ x("div", {
+					"data-tour": "theculturepost-home-hero",
+					children: /* @__PURE__ */ x(n, {
+						eyebrow: "TheCulturePost",
+						title: "Culture, religion, values & history — told with care",
+						description: "A space for respectful stories and thoughtful conversations that connect us across traditions and time — grounded in the record.",
+						actions: /* @__PURE__ */ S(C, {
+							size: "lg",
+							onClick: () => t("stories"),
+							children: [/* @__PURE__ */ x(h, {
+								className: "mr-1.5 h-4 w-4",
+								"aria-hidden": "true"
+							}), " Read stories"]
+						})
 					})
 				}), N ? /* @__PURE__ */ x(r, { label: "Loading the latest…" }) : P ? /* @__PURE__ */ x(l, {
 					illustration: "onboarding",
@@ -187,16 +190,19 @@ function k() {
 								label: "All topics",
 								onClick: () => t("topics")
 							}),
-							children: k.length === 0 ? /* @__PURE__ */ x(l, {
-								icon: /* @__PURE__ */ x(g, { className: "h-9 w-9" }),
-								title: "No topics yet",
-								description: "Curate the first topic to organise the publication."
-							}) : /* @__PURE__ */ x("div", {
-								className: "grid gap-4 sm:grid-cols-2",
-								children: k.map((e) => /* @__PURE__ */ x(c, {
-									topic: e,
-									onOpen: () => t(`topics/${e.id}`)
-								}, e.id))
+							children: /* @__PURE__ */ x("div", {
+								"data-tour": "theculturepost-home-topics",
+								children: k.length === 0 ? /* @__PURE__ */ x(l, {
+									icon: /* @__PURE__ */ x(g, { className: "h-9 w-9" }),
+									title: "No topics yet",
+									description: "Curate the first topic to organise the publication."
+								}) : /* @__PURE__ */ x("div", {
+									className: "grid gap-4 sm:grid-cols-2",
+									children: k.map((e) => /* @__PURE__ */ x(c, {
+										topic: e,
+										onOpen: () => t(`topics/${e.id}`)
+									}, e.id))
+								})
 							})
 						}), /* @__PURE__ */ x(T, {
 							title: "Latest published stories",
@@ -205,58 +211,67 @@ function k() {
 								label: "All stories",
 								onClick: () => t("stories")
 							}),
-							children: A.length === 0 ? /* @__PURE__ */ x(l, {
-								icon: /* @__PURE__ */ x(h, { className: "h-9 w-9" }),
-								title: "No published stories yet",
-								description: "Draft a story and move it through the editorial lifecycle to publish."
-							}) : /* @__PURE__ */ x("div", {
-								className: "grid gap-4 sm:grid-cols-2",
-								children: A.map((e) => /* @__PURE__ */ x(s, {
-									story: e,
-									hideStatus: !0,
-									onOpen: () => t(`stories/${e.id}`)
-								}, e.id))
+							children: /* @__PURE__ */ x("div", {
+								"data-tour": "theculturepost-home-stories",
+								children: A.length === 0 ? /* @__PURE__ */ x(l, {
+									icon: /* @__PURE__ */ x(h, { className: "h-9 w-9" }),
+									title: "No published stories yet",
+									description: "Draft a story and move it through the editorial lifecycle to publish."
+								}) : /* @__PURE__ */ x("div", {
+									className: "grid gap-4 sm:grid-cols-2",
+									children: A.map((e) => /* @__PURE__ */ x(s, {
+										story: e,
+										hideStatus: !0,
+										onOpen: () => t(`stories/${e.id}`)
+									}, e.id))
+								})
 							})
 						})]
 					}), /* @__PURE__ */ S("aside", {
 						className: "flex flex-col gap-6",
-						children: [/* @__PURE__ */ x(E, {
-							title: "Active discussions",
-							action: /* @__PURE__ */ x("button", {
-								type: "button",
-								onClick: () => t("discussions"),
-								className: "text-xs font-medium text-accent hover:underline",
-								children: "View all"
-							}),
-							children: j.length === 0 ? /* @__PURE__ */ x(l, {
-								icon: /* @__PURE__ */ x(b, { className: "h-8 w-8" }),
-								title: "No open discussions",
-								description: "Open a discussion to invite thoughtful perspectives."
-							}) : /* @__PURE__ */ x("div", {
-								className: "-mx-2 flex flex-col",
-								children: j.map((e) => /* @__PURE__ */ x(D, {
-									discussion: e,
-									onOpen: () => t(`discussions/${e.id}`)
-								}, e.id))
+						children: [/* @__PURE__ */ x("div", {
+							"data-tour": "theculturepost-home-discussions",
+							children: /* @__PURE__ */ x(E, {
+								title: "Active discussions",
+								action: /* @__PURE__ */ x("button", {
+									type: "button",
+									onClick: () => t("discussions"),
+									className: "text-xs font-medium text-accent hover:underline",
+									children: "View all"
+								}),
+								children: j.length === 0 ? /* @__PURE__ */ x(l, {
+									icon: /* @__PURE__ */ x(b, { className: "h-8 w-8" }),
+									title: "No open discussions",
+									description: "Open a discussion to invite thoughtful perspectives."
+								}) : /* @__PURE__ */ x("div", {
+									className: "-mx-2 flex flex-col",
+									children: j.map((e) => /* @__PURE__ */ x(D, {
+										discussion: e,
+										onOpen: () => t(`discussions/${e.id}`)
+									}, e.id))
+								})
 							})
-						}), /* @__PURE__ */ x(E, {
-							title: "From the archive",
-							action: /* @__PURE__ */ x("button", {
-								type: "button",
-								onClick: () => t("archive"),
-								className: "text-xs font-medium text-accent hover:underline",
-								children: "View all"
-							}),
-							children: M.length === 0 ? /* @__PURE__ */ x(l, {
-								icon: /* @__PURE__ */ x(y, { className: "h-8 w-8" }),
-								title: "The archive is empty",
-								description: "Create a collection to begin preserving heritage."
-							}) : /* @__PURE__ */ x("div", {
-								className: "grid grid-cols-1 gap-4 sm:grid-cols-2",
-								children: M.map((e) => /* @__PURE__ */ x(O, {
-									collection: e,
-									onOpen: () => t(`archive/collections/${e.id}`)
-								}, e.id))
+						}), /* @__PURE__ */ x("div", {
+							"data-tour": "theculturepost-home-archive",
+							children: /* @__PURE__ */ x(E, {
+								title: "From the archive",
+								action: /* @__PURE__ */ x("button", {
+									type: "button",
+									onClick: () => t("archive"),
+									className: "text-xs font-medium text-accent hover:underline",
+									children: "View all"
+								}),
+								children: M.length === 0 ? /* @__PURE__ */ x(l, {
+									icon: /* @__PURE__ */ x(y, { className: "h-8 w-8" }),
+									title: "The archive is empty",
+									description: "Create a collection to begin preserving heritage."
+								}) : /* @__PURE__ */ x("div", {
+									className: "grid grid-cols-1 gap-4 sm:grid-cols-2",
+									children: M.map((e) => /* @__PURE__ */ x(O, {
+										collection: e,
+										onOpen: () => t(`archive/collections/${e.id}`)
+									}, e.id))
+								})
 							})
 						})]
 					})]