@tuwaio/docs-ui 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -38,8 +38,10 @@ __reExport(index_exports, require("./components/Logo"), module.exports);
 __reExport(index_exports, require("./components/NavBar"), module.exports);
 var import_NoSSR = __toESM(require("./components/NoSSR"), 1);
 __reExport(index_exports, require("./components/Orb"), module.exports);
+__reExport(index_exports, require("./components/PolicyDocument"), module.exports);
 var import_StarryBackground = __toESM(require("./components/StarryBackground"), 1);
 __reExport(index_exports, require("./components/ThemeSwitcher"), module.exports);
+__reExport(index_exports, require("./policies"), module.exports);
 __reExport(index_exports, require("./utils"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -49,6 +51,8 @@ __reExport(index_exports, require("./utils"), module.exports);
   ...require("./components/Logo"),
   ...require("./components/NavBar"),
   ...require("./components/Orb"),
+  ...require("./components/PolicyDocument"),
   ...require("./components/ThemeSwitcher"),
+  ...require("./policies"),
   ...require("./utils")
 });

package/dist/index.css

@@ -568,6 +568,7 @@ html {
     --tuwadocs-font-weight-bold: 700;
     --tuwadocs-font-weight-extrabold: 800;
     --tuwadocs-tracking-tight: -0.025em;
+    --tuwadocs-tracking-widest: 0.1em;
     --tuwadocs-ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
     --tuwadocs-animate-pulse: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
     --tuwadocs-blur-sm: 8px;
@@ -609,15 +610,27 @@ html {
   .tuwadocs\:mt-4 {
     margin-top: calc(var(--tuwadocs-spacing) * 4);
   }
+  .tuwadocs\:mb-3 {
+    margin-bottom: calc(var(--tuwadocs-spacing) * 3);
+  }
   .tuwadocs\:mb-6 {
     margin-bottom: calc(var(--tuwadocs-spacing) * 6);
   }
+  .tuwadocs\:mb-8 {
+    margin-bottom: calc(var(--tuwadocs-spacing) * 8);
+  }
   .tuwadocs\:flex {
     display: flex;
   }
+  .tuwadocs\:grid {
+    display: grid;
+  }
   .tuwadocs\:hidden {
     display: none;
   }
+  .tuwadocs\:inline-flex {
+    display: inline-flex;
+  }
   .tuwadocs\:h-4 {
     height: calc(var(--tuwadocs-spacing) * 4);
   }
@@ -654,12 +667,21 @@ html {
   .tuwadocs\:w-full {
     width: 100%;
   }
+  .tuwadocs\:min-w-0 {
+    min-width: 0px;
+  }
   .tuwadocs\:flex-1 {
     flex: 1;
   }
   .tuwadocs\:cursor-pointer {
     cursor: pointer;
   }
+  .tuwadocs\:list-none {
+    list-style-type: none;
+  }
+  .tuwadocs\:grid-cols-1 {
+    grid-template-columns: repeat(1, minmax(0, 1fr));
+  }
   .tuwadocs\:flex-col {
     flex-direction: column;
   }
@@ -669,9 +691,6 @@ html {
   .tuwadocs\:items-center {
     align-items: center;
   }
-  .tuwadocs\:items-start {
-    align-items: flex-start;
-  }
   .tuwadocs\:justify-between {
     justify-content: space-between;
   }
@@ -681,12 +700,25 @@ html {
   .tuwadocs\:gap-1 {
     gap: var(--tuwadocs-spacing);
   }
+  .tuwadocs\:gap-2 {
+    gap: calc(var(--tuwadocs-spacing) * 2);
+  }
   .tuwadocs\:gap-3 {
     gap: calc(var(--tuwadocs-spacing) * 3);
   }
   .tuwadocs\:gap-4 {
     gap: calc(var(--tuwadocs-spacing) * 4);
   }
+  .tuwadocs\:gap-10 {
+    gap: calc(var(--tuwadocs-spacing) * 10);
+  }
+  .tuwadocs\:gap-x-4 {
+    -moz-column-gap: calc(var(--tuwadocs-spacing) * 4);
+         column-gap: calc(var(--tuwadocs-spacing) * 4);
+  }
+  .tuwadocs\:gap-y-2 {
+    row-gap: calc(var(--tuwadocs-spacing) * 2);
+  }
   .tuwadocs\:overflow-hidden {
     overflow: hidden;
   }
@@ -700,6 +732,17 @@ html {
     border-style: var(--tw-border-style);
     border-width: 1px;
   }
+  .tuwadocs\:border-b {
+    border-bottom-style: var(--tw-border-style);
+    border-bottom-width: 1px;
+  }
+  .tuwadocs\:border-l {
+    border-left-style: var(--tw-border-style);
+    border-left-width: 1px;
+  }
+  .tuwadocs\:border-\[var\(--tuwa-border-primary\)\] {
+    border-color: var(--tuwa-border-primary);
+  }
   .tuwadocs\:border-black\/5 {
     border-color: var(--tuwadocs-color-black);
     @supports (color: color-mix(in lab, red, red)) {
@@ -729,6 +772,9 @@ html {
   .tuwadocs\:px-3 {
     padding-inline: calc(var(--tuwadocs-spacing) * 3);
   }
+  .tuwadocs\:px-4 {
+    padding-inline: calc(var(--tuwadocs-spacing) * 4);
+  }
   .tuwadocs\:py-1\.5 {
     padding-block: calc(var(--tuwadocs-spacing) * 1.5);
   }
@@ -738,17 +784,60 @@ html {
   .tuwadocs\:pt-8 {
     padding-top: calc(var(--tuwadocs-spacing) * 8);
   }
+  .tuwadocs\:pb-6 {
+    padding-bottom: calc(var(--tuwadocs-spacing) * 6);
+  }
+  .tuwadocs\:pl-4 {
+    padding-left: calc(var(--tuwadocs-spacing) * 4);
+  }
+  .tuwadocs\:text-center {
+    text-align: center;
+  }
+  .tuwadocs\:text-3xl {
+    font-size: var(--tuwadocs-text-3xl);
+    line-height: var(--tw-leading, var(--tuwadocs-text-3xl--line-height));
+  }
   .tuwadocs\:text-sm {
     font-size: var(--tuwadocs-text-sm);
     line-height: var(--tw-leading, var(--tuwadocs-text-sm--line-height));
   }
+  .tuwadocs\:text-xs {
+    font-size: var(--tuwadocs-text-xs);
+    line-height: var(--tw-leading, var(--tuwadocs-text-xs--line-height));
+  }
+  .tuwadocs\:font-bold {
+    --tw-font-weight: var(--tuwadocs-font-weight-bold);
+    font-weight: var(--tuwadocs-font-weight-bold);
+  }
+  .tuwadocs\:font-extrabold {
+    --tw-font-weight: var(--tuwadocs-font-weight-extrabold);
+    font-weight: var(--tuwadocs-font-weight-extrabold);
+  }
   .tuwadocs\:font-medium {
     --tw-font-weight: var(--tuwadocs-font-weight-medium);
     font-weight: var(--tuwadocs-font-weight-medium);
   }
+  .tuwadocs\:font-semibold {
+    --tw-font-weight: var(--tuwadocs-font-weight-semibold);
+    font-weight: var(--tuwadocs-font-weight-semibold);
+  }
+  .tuwadocs\:tracking-tight {
+    --tw-tracking: var(--tuwadocs-tracking-tight);
+    letter-spacing: var(--tuwadocs-tracking-tight);
+  }
+  .tuwadocs\:tracking-widest {
+    --tw-tracking: var(--tuwadocs-tracking-widest);
+    letter-spacing: var(--tuwadocs-tracking-widest);
+  }
   .tuwadocs\:text-\[var\(--tuwa-text-primary\)\] {
     color: var(--tuwa-text-primary);
   }
+  .tuwadocs\:text-\[var\(--tuwa-text-secondary\)\] {
+    color: var(--tuwa-text-secondary);
+  }
+  .tuwadocs\:text-\[var\(--tuwa-text-tertiary\)\] {
+    color: var(--tuwa-text-tertiary);
+  }
   .tuwadocs\:text-indigo-400 {
     color: var(--tuwadocs-color-indigo-400);
   }
@@ -758,6 +847,12 @@ html {
   .tuwadocs\:text-yellow-500 {
     color: var(--tuwadocs-color-yellow-500);
   }
+  .tuwadocs\:uppercase {
+    text-transform: uppercase;
+  }
+  .tuwadocs\:no-underline {
+    text-decoration-line: none;
+  }
   .tuwadocs\:opacity-0 {
     opacity: 0%;
   }
@@ -794,6 +889,9 @@ html {
     .tuwadocs\:group-hover\:text-yellow-400:is(:where(.tuwadocs\:group):hover *) {
       color: var(--tuwadocs-color-yellow-400);
     }
+    .tuwadocs\:hover\:bg-\[var\(--tuwa-bg-muted\)\]:hover {
+      background-color: var(--tuwa-bg-muted);
+    }
     .tuwadocs\:hover\:bg-black\/10:hover {
       background-color: var(--tuwadocs-color-black);
     }
@@ -802,6 +900,9 @@ html {
         background-color: color-mix(in oklab, var(--tuwadocs-color-black) 10%, transparent);
       }
     }
+    .tuwadocs\:hover\:text-\[var\(--tuwa-text-primary\)\]:hover {
+      color: var(--tuwa-text-primary);
+    }
     .tuwadocs\:hover\:text-red-600:hover {
       color: var(--tuwadocs-color-red-600);
     }
@@ -816,12 +917,19 @@ html {
     .tuwadocs\:sm\:flex-row {
       flex-direction: row;
     }
-    .tuwadocs\:sm\:items-center {
-      align-items: center;
-    }
     .tuwadocs\:sm\:items-start {
       align-items: flex-start;
     }
+    .tuwadocs\:sm\:justify-end {
+      justify-content: flex-end;
+    }
+    .tuwadocs\:sm\:text-left {
+      text-align: left;
+    }
+    .tuwadocs\:sm\:text-4xl {
+      font-size: var(--tuwadocs-text-4xl);
+      line-height: var(--tw-leading, var(--tuwadocs-text-4xl--line-height));
+    }
   }
   @media (width >= 48rem) {
     .tuwadocs\:md\:block {
@@ -849,6 +957,23 @@ html {
       width: calc(var(--tuwadocs-spacing) * 16);
     }
   }
+  @media (width >= 64rem) {
+    .tuwadocs\:lg\:sticky {
+      position: sticky;
+    }
+    .tuwadocs\:lg\:top-24 {
+      top: calc(var(--tuwadocs-spacing) * 24);
+    }
+    .tuwadocs\:lg\:block {
+      display: block;
+    }
+    .tuwadocs\:lg\:grid-cols-\[minmax\(0\,1fr\)_14rem\] {
+      grid-template-columns: minmax(0,1fr) 14rem;
+    }
+    .tuwadocs\:lg\:self-start {
+      align-self: flex-start;
+    }
+  }
   @media (width >= 96rem) {
     .tuwadocs\:2xl\:h-6 {
       height: calc(var(--tuwadocs-spacing) * 6);
@@ -1168,6 +1293,93 @@ article .nextra-border a:hover {
 .nextra-toc .nextra-border a:hover {
   color: var(--tuwa-secondary) !important;
 }
+.tuwadocs-policy-title {
+  font-family: var(--font-geist-mono, ui-monospace), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+.tuwadocs-policy {
+  color: var(--tuwa-text-secondary);
+  font-size: 1rem;
+  line-height: 1.75;
+}
+.tuwadocs-policy > * + * {
+  margin-top: 1rem;
+}
+.tuwadocs-policy h2,
+.tuwadocs-policy h3 {
+  color: var(--tuwa-text-primary);
+  font-family: var(--font-geist-mono, ui-monospace), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  scroll-margin-top: 6rem;
+}
+.tuwadocs-policy h2 {
+  margin-top: 2.5rem;
+  font-size: 1.25rem;
+  line-height: 1.4;
+}
+.tuwadocs-policy h3 {
+  margin-top: 1.75rem;
+  font-size: 1.05rem;
+  line-height: 1.5;
+}
+.tuwadocs-policy ul,
+.tuwadocs-policy ol {
+  padding-left: 1.25rem;
+}
+.tuwadocs-policy ul {
+  list-style: disc;
+}
+.tuwadocs-policy ol {
+  list-style: decimal;
+}
+.tuwadocs-policy li + li {
+  margin-top: 0.5rem;
+}
+.tuwadocs-policy strong {
+  color: var(--tuwa-text-primary);
+  font-weight: 600;
+}
+.tuwadocs-policy a {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+  overflow-wrap: anywhere;
+}
+.tuwadocs-policy table {
+  display: block;
+  max-width: 100%;
+  overflow-x: auto;
+  border-collapse: collapse;
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+.tuwadocs-policy th,
+.tuwadocs-policy td {
+  border: 1px solid var(--tuwa-border-primary);
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+  vertical-align: top;
+}
+.tuwadocs-policy th {
+  background: var(--tuwa-bg-muted);
+  color: var(--tuwa-text-primary);
+  font-weight: 600;
+}
+.tuwadocs-policy blockquote {
+  border-left: 3px solid var(--tuwa-border-primary);
+  border-radius: var(--tuwa-rounded-corners);
+  background: var(--tuwa-bg-muted);
+  padding: 0.75rem 1rem;
+}
+.tuwadocs-policy blockquote > * + * {
+  margin-top: 0.5rem;
+}
+.tuwadocs-policy code {
+  border-radius: var(--tuwa-rounded-corners);
+  background: var(--tuwa-bg-muted);
+  padding: 0.1em 0.35em;
+  font-family: var(--font-geist-mono, ui-monospace), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-size: 0.875em;
+}
 .tuwa-button {
   display: inline-flex;
   align-items: center;

package/dist/index.d.cts

@@ -3,7 +3,9 @@ export { RemoteLogo, RemoteLogoProps } from './components/Logo.cjs';
 export { NavProps, Navbar, SocialLink } from './components/NavBar.cjs';
 export { default as NoSSR } from './components/NoSSR.cjs';
 export { Orb, OrbProps, PackageType } from './components/Orb.cjs';
+export { PolicyDocument, PolicyDocumentProps } from './components/PolicyDocument.cjs';
 export { default as StarryBackground } from './components/StarryBackground.cjs';
 export { ThemeSwitcher, ThemeSwitcherProps } from './components/ThemeSwitcher.cjs';
+export { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicySection, PolicySlug, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies } from './policies.cjs';
 export { baseFooterLinks, baseNavLinks } from './utils.cjs';
 import 'react';

package/dist/index.d.ts

@@ -3,7 +3,9 @@ export { RemoteLogo, RemoteLogoProps } from './components/Logo.js';
 export { NavProps, Navbar, SocialLink } from './components/NavBar.js';
 export { default as NoSSR } from './components/NoSSR.js';
 export { Orb, OrbProps, PackageType } from './components/Orb.js';
+export { PolicyDocument, PolicyDocumentProps } from './components/PolicyDocument.js';
 export { default as StarryBackground } from './components/StarryBackground.js';
 export { ThemeSwitcher, ThemeSwitcherProps } from './components/ThemeSwitcher.js';
+export { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicySection, PolicySlug, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies } from './policies.js';
 export { baseFooterLinks, baseNavLinks } from './utils.js';
 import 'react';

package/dist/index.js

@@ -3,8 +3,10 @@ export * from "./components/Logo";
 export * from "./components/NavBar";
 import { default as default2 } from "./components/NoSSR";
 export * from "./components/Orb";
+export * from "./components/PolicyDocument";
 import { default as default3 } from "./components/StarryBackground";
 export * from "./components/ThemeSwitcher";
+export * from "./policies";
 export * from "./utils";
 export {
   default2 as NoSSR,

package/dist/policies.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var policies_exports = {};
+__export(policies_exports, {
+  POLICIES_INDEX_URL: () => POLICIES_INDEX_URL,
+  POLICY_SITE_URL: () => POLICY_SITE_URL,
+  POLICY_SOURCE: () => POLICY_SOURCE,
+  footerPolicies: () => footerPolicies,
+  getPolicyFileUrl: () => getPolicyFileUrl,
+  getPolicyPageUrl: () => getPolicyPageUrl,
+  loadPolicy: () => loadPolicy,
+  policies: () => policies,
+  publishedPolicies: () => publishedPolicies
+});
+module.exports = __toCommonJS(policies_exports);
+const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
+const POLICY_SITE_URL = "https://tuwa.io";
+const POLICIES_INDEX_URL = "https://docs.tuwa.io/policies";
+const policies = [
+  {
+    slug: "terms",
+    title: "Terms of Service",
+    description: "The rules for using the TUWA websites and documentation, Quasar Cloud, Quasar Community Edition and the open-source packages.",
+    href: "/terms",
+    published: true
+  },
+  {
+    slug: "privacy",
+    title: "Privacy Policy",
+    description: "What data TUWA collects and why, how it is protected, and how to access or delete it.",
+    href: "/privacy",
+    published: true
+  },
+  {
+    slug: "cookie",
+    title: "Cookie Policy",
+    description: "The cookies and Local Storage that the TUWA sites and the Quasar dashboard use.",
+    href: "/cookie",
+    published: true
+  },
+  {
+    slug: "refund",
+    title: "Refund Policy",
+    description: "When and how payments for Quasar Cloud quota are refunded.",
+    href: "/refund",
+    // Quota purchases are paused; the policy is published again when they reopen
+    published: false
+  },
+  {
+    slug: "security",
+    title: "Security Policy",
+    description: "How to report a vulnerability, what TUWA promises in return, and who is responsible for what.",
+    href: "/security",
+    published: true
+  },
+  {
+    slug: "dpa",
+    title: "Data Processing Addendum",
+    description: "How we process the personal data of your app users on your behalf when you use Quasar Cloud.",
+    href: "/dpa",
+    published: true,
+    footer: false
+  }
+];
+const publishedPolicies = policies.filter((policy) => policy.published);
+const footerPolicies = publishedPolicies.filter((policy) => policy.footer !== false);
+function getPolicyPageUrl(slug, site = POLICY_SITE_URL) {
+  return `${site.replace(/\/+$/, "")}/${slug}`;
+}
+function getPolicyFileUrl(slug, format, source = POLICY_SOURCE) {
+  return `${source.replace(/\/+$/, "")}/${slug}.${format}`;
+}
+function isPolicyContent(value) {
+  if (!value || typeof value !== "object") return false;
+  const content = value;
+  return typeof content.title === "string" && typeof content.updated === "string" && typeof content.html === "string" && Array.isArray(content.sections) && content.sections.every(
+    (section) => !!section && typeof section.id === "string" && typeof section.title === "string"
+  );
+}
+async function loadPolicy(slug, options = {}) {
+  const url = getPolicyFileUrl(slug, "json", options.source);
+  const response = await fetch(url, { next: { revalidate: options.revalidate ?? 3600 } });
+  if (!response.ok) {
+    throw new Error(`loadPolicy: ${url} answered ${response.status}`);
+  }
+  const content = await response.json();
+  if (!isPolicyContent(content)) {
+    throw new Error(`loadPolicy: ${url} is not a policy page`);
+  }
+  return {
+    title: content.title,
+    updated: content.updated,
+    sections: content.sections.map(({ id, title }) => ({ id, title })),
+    html: content.html
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  POLICIES_INDEX_URL,
+  POLICY_SITE_URL,
+  POLICY_SOURCE,
+  footerPolicies,
+  getPolicyFileUrl,
+  getPolicyPageUrl,
+  loadPolicy,
+  policies,
+  publishedPolicies
+});

package/dist/policies.d.cts

@@ -0,0 +1,88 @@
+/** Slug of a TUWA policy: the path of its page on the TUWA sites and the name of its files in `TuwaIO/workflows/docs`. */
+type PolicySlug = 'terms' | 'privacy' | 'cookie' | 'refund' | 'security' | 'dpa';
+/** A TUWA policy, as listed in {@link policies}. */
+interface Policy {
+    /** Slug of the policy. */
+    slug: PolicySlug;
+    /** Title shown in footers and on the page. */
+    title: string;
+    /** One sentence on what the policy covers, for policy lists. */
+    description: string;
+    /** Path of the policy page on the website and the Quasar dashboard. */
+    href: `/${PolicySlug}`;
+    /** Whether the policy is in force. Drafts stay `false` until they are approved. */
+    published: boolean;
+    /** Whether footers link the policy (default: `true`); documents linked from other policies set `false`. */
+    footer?: boolean;
+}
+/** A section of a policy: a level-2 heading with its anchor. */
+interface PolicySection {
+    /** Anchor of the heading, without `#` (stable when sections are renumbered). */
+    id: string;
+    /** Text of the heading without its number. */
+    title: string;
+}
+/** Content of a policy page, generated next to its PDF by `generate_pdf.js` in `TuwaIO/workflows/docs`. */
+interface PolicyContent {
+    /** Title of the document. */
+    title: string;
+    /** Date of the current version as written in the document (`October 8, 2026`). */
+    updated: string;
+    /** Level-2 sections in document order. */
+    sections: PolicySection[];
+    /** Body of the document as HTML, without the title and the date line; headings carry their anchors as `id`. */
+    html: string;
+}
+/** Where the policy files live: the `docs` folder of `TuwaIO/workflows` on GitHub, branch `main`. */
+declare const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
+/** The site that hosts the policy pages; sites without their own policy pages (documentation sites) link there. */
+declare const POLICY_SITE_URL = "https://tuwa.io";
+/** The page that lists every TUWA policy in force: `/policies` of the docs hub. */
+declare const POLICIES_INDEX_URL = "https://docs.tuwa.io/policies";
+/**
+ * Every TUWA policy in the order footers list them. Footers of the website and the Quasar dashboard read
+ * {@link publishedPolicies}, so a policy appears everywhere once it is published.
+ */
+declare const policies: readonly Policy[];
+/** The policies in force, for policy lists: {@link policies} with `published: true`. */
+declare const publishedPolicies: readonly Policy[];
+/** The policies that footers link: {@link publishedPolicies} without those marked `footer: false`. */
+declare const footerPolicies: readonly Policy[];
+/**
+ * Returns the absolute URL of a policy page, for sites that do not host the policies themselves.
+ *
+ * @param slug - Slug of the policy.
+ * @param site - Origin of the site with the policy pages (default: {@link POLICY_SITE_URL}).
+ * @returns The URL of the page, for example `https://tuwa.io/terms`.
+ */
+declare function getPolicyPageUrl(slug: PolicySlug, site?: string): string;
+/**
+ * Returns the URL of a policy file.
+ *
+ * @param slug - Slug of the policy.
+ * @param format - `json` for the page content, `pdf` for the official document, `md` for the source text.
+ * @param source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
+ * @returns The URL of the file.
+ */
+declare function getPolicyFileUrl(slug: PolicySlug, format: 'json' | 'pdf' | 'md', source?: string): string;
+/**
+ * Loads the content of a policy page (its `json` file). Call it on the server, for example in a Server Component of
+ * the Next.js App Router, and pass the result to `PolicyDocument`.
+ *
+ * Network: one request to `getPolicyFileUrl(slug, 'json', source)` per revalidation, cached by the Next.js `fetch`
+ * cache for `revalidate` seconds (outside Next.js, a plain request).
+ *
+ * @param slug - Slug of the policy.
+ * @param options - Optional settings.
+ * @param options.source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
+ * @param options.revalidate - Seconds the Next.js `fetch` cache keeps the content, or `false` to cache it until the
+ *   next deployment (default: 3600).
+ * @returns The content of the policy.
+ * @throws Error when the request fails, the response is not `2xx`, or the file is not a policy page.
+ */
+declare function loadPolicy(slug: PolicySlug, options?: {
+    source?: string;
+    revalidate?: number | false;
+}): Promise<PolicyContent>;
+
+export { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, type Policy, type PolicyContent, type PolicySection, type PolicySlug, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies };