// Data Export Guides — renders the customer-facing onboarding guides the
// user supplied as .docx files (converted at build time to JS data at
// src/onboarding-guides.js → window.PerduraOnboardingGuides). Wording is
// preserved verbatim per product copy decision.
//
// Two surfaces:
// 1) Sidebar → Help → Data Export Guides (full guide reader)
// 2) Contextual links from Settings → Sources + the Onboarding Wizard
// jump straight to a system section via the GuidesPage(initialGuide,
// initialSystem) entry point.
const { useState: useStateG, useEffect: useEffectG, useMemo: useMemoG } = React;
function Block({ block }) {
if (block.kind === "h") {
const lvl = block.level || 2;
if (lvl <= 1) return
{block.text}
;
if (lvl === 2) return
{block.text}
;
return
{block.text}
;
}
if (block.kind === "li") {
return
{block.text}
;
}
if (block.kind === "table") {
return (
{block.rows.map((r, i) => (
{r.map((c, j) =>
{c}
)}
))}
);
}
return
{block.text}
;
}
function BlockList({ blocks }) {
// Group consecutive li blocks into a single
so list bullets render properly.
const out = [];
let current = null;
blocks.forEach((b, i) => {
if (b.kind === "li") {
if (!current) { current = { kind: "ul", items: [] }; out.push(current); }
current.items.push(b);
} else {
current = null;
out.push(b);
}
});
return (
<>
{out.map((b, i) => {
if (b.kind === "ul") {
return
{b.items.map((li, j) => )}
;
}
return ;
})}
);
}
// Resolve a user-provided system hint (free text or canonical key) to a
// (guideKey, systemKey) tuple. Used by the contextual deep-link from
// Settings → Sources and the Onboarding wizard. Case-insensitive, matches
// either guide.key, system.key, or any system.name.
function resolveDeepLink(guides, hint) {
if (!hint) return null;
const h = String(hint).toLowerCase().replace(/[^a-z0-9]+/g, "");
for (const g of guides) {
for (const s of g.systems) {
const sk = (s.key || "").replace(/[^a-z0-9]+/g, "");
const sn = (s.name || "").toLowerCase().replace(/[^a-z0-9]+/g, "");
if (sk === h || sn === h || sn.includes(h) || h.includes(sk)) {
return { guideKey: g.key, systemKey: s.key };
}
}
}
return null;
}
function GuidesPage({ initialGuide, initialSystem }) {
const guides = (typeof window !== "undefined" ? window.PerduraOnboardingGuides : null) || [];
const [activeGuide, setActiveGuide] = useStateG(initialGuide || (guides[0]?.key || ""));
const [activeSystem, setActiveSystem] = useStateG(initialSystem || "");
useEffectG(() => {
// Allow other pages to deep-link us via a transient window flag.
const hint = window.__perduraGuideHint;
if (hint) {
delete window.__perduraGuideHint;
const resolved = resolveDeepLink(guides, hint);
if (resolved) {
setActiveGuide(resolved.guideKey);
setActiveSystem(resolved.systemKey);
}
}
}, []);
const guide = useMemoG(() => guides.find(g => g.key === activeGuide) || guides[0], [activeGuide, guides]);
if (!guide) {
return (
Once you have your exports, drop them into Settings → Configuration → Excel / CSV import.
We'll detect the schema, run the reconciliation gates, and report any unmatched accounts.