@easy-cookie/policy 0.0.0-stage → 0.1.1

package/dist/react.d.cts

@@ -0,0 +1,49 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { EasyCookieConfig } from '@easy-cookie/core/shared';
+import { B as BuildPolicyOptions, R as RenderPolicyOptions } from './render-DYrvn1cT.cjs';
+export { d as PolicyModel, h as buildPolicyModel } from './render-DYrvn1cT.cjs';
+import { FetchLegalDocumentOptions, PublishedLegalDocument } from './client.cjs';
+export { fetchLegalDocument } from './client.cjs';
+
+interface LegalDocumentProps extends Omit<FetchLegalDocumentOptions, 'init'> {
+    className?: string;
+    /** Shown while loading. */
+    loading?: ReactNode;
+    /** Shown when nothing is published or the request fails. */
+    fallback?: ReactNode;
+}
+/**
+ * Fetch a published legal document in the browser and render it. For
+ * server-rendered, indexable pages prefer `getLegalDocument()` (Next.js) or
+ * `fetchLegalDocument()` + `<LegalDocumentHtml>`.
+ */
+declare function LegalDocument({ endpoint, siteKey, kind, lang, fetch: fetchImpl, className, loading, fallback, }: LegalDocumentProps): react.JSX.Element;
+
+interface CookiePolicyProps extends BuildPolicyOptions, RenderPolicyOptions {
+    config: EasyCookieConfig;
+    lang: string;
+    className?: string;
+}
+/**
+ * The cookie section of a policy page, generated from the config.
+ * No hooks and no browser APIs: works as a React Server Component.
+ * Same markup and class names as `renderPolicyHtml()`.
+ */
+declare function CookiePolicy({ config, lang, date, labels, headingLevel, idPrefix, meta, hideEmpty, className, }: CookiePolicyProps): react.JSX.Element;
+
+interface LegalDocumentHtmlProps {
+    /** A document from `fetchLegalDocument()` / `getLegalDocument()` (or anything with `html`). */
+    doc: Pick<PublishedLegalDocument, 'html'> | null | undefined;
+    className?: string;
+    /** Shown when `doc` is null (nothing published yet). */
+    fallback?: ReactNode;
+}
+/**
+ * Render a legal document fetched on the server. The HTML comes from the
+ * consent server's renderer (raw HTML disabled, safe links only), so it is
+ * inserted as-is. Works as a React Server Component.
+ */
+declare function LegalDocumentHtml({ doc, className, fallback }: LegalDocumentHtmlProps): react.JSX.Element;
+
+export { CookiePolicy, type CookiePolicyProps, FetchLegalDocumentOptions, LegalDocument, LegalDocumentHtml, type LegalDocumentHtmlProps, type LegalDocumentProps, PublishedLegalDocument };

package/dist/react.d.ts

@@ -0,0 +1,49 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { EasyCookieConfig } from '@easy-cookie/core/shared';
+import { B as BuildPolicyOptions, R as RenderPolicyOptions } from './render-DYrvn1cT.js';
+export { d as PolicyModel, h as buildPolicyModel } from './render-DYrvn1cT.js';
+import { FetchLegalDocumentOptions, PublishedLegalDocument } from './client.js';
+export { fetchLegalDocument } from './client.js';
+
+interface LegalDocumentProps extends Omit<FetchLegalDocumentOptions, 'init'> {
+    className?: string;
+    /** Shown while loading. */
+    loading?: ReactNode;
+    /** Shown when nothing is published or the request fails. */
+    fallback?: ReactNode;
+}
+/**
+ * Fetch a published legal document in the browser and render it. For
+ * server-rendered, indexable pages prefer `getLegalDocument()` (Next.js) or
+ * `fetchLegalDocument()` + `<LegalDocumentHtml>`.
+ */
+declare function LegalDocument({ endpoint, siteKey, kind, lang, fetch: fetchImpl, className, loading, fallback, }: LegalDocumentProps): react.JSX.Element;
+
+interface CookiePolicyProps extends BuildPolicyOptions, RenderPolicyOptions {
+    config: EasyCookieConfig;
+    lang: string;
+    className?: string;
+}
+/**
+ * The cookie section of a policy page, generated from the config.
+ * No hooks and no browser APIs: works as a React Server Component.
+ * Same markup and class names as `renderPolicyHtml()`.
+ */
+declare function CookiePolicy({ config, lang, date, labels, headingLevel, idPrefix, meta, hideEmpty, className, }: CookiePolicyProps): react.JSX.Element;
+
+interface LegalDocumentHtmlProps {
+    /** A document from `fetchLegalDocument()` / `getLegalDocument()` (or anything with `html`). */
+    doc: Pick<PublishedLegalDocument, 'html'> | null | undefined;
+    className?: string;
+    /** Shown when `doc` is null (nothing published yet). */
+    fallback?: ReactNode;
+}
+/**
+ * Render a legal document fetched on the server. The HTML comes from the
+ * consent server's renderer (raw HTML disabled, safe links only), so it is
+ * inserted as-is. Works as a React Server Component.
+ */
+declare function LegalDocumentHtml({ doc, className, fallback }: LegalDocumentHtmlProps): react.JSX.Element;
+
+export { CookiePolicy, type CookiePolicyProps, FetchLegalDocumentOptions, LegalDocument, LegalDocumentHtml, type LegalDocumentHtmlProps, type LegalDocumentProps, PublishedLegalDocument };

package/dist/react.js

@@ -0,0 +1,80 @@
+import {
+  buildPolicyModel,
+  formatPolicyDate,
+  policyRows
+} from "./chunk-P3F5NQPR.js";
+import {
+  fetchLegalDocument
+} from "./chunk-HDY2VYU4.js";
+
+// src/react.tsx
+import { LegalDocument } from "./legal-document.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function CookiePolicy({
+  config,
+  lang,
+  date,
+  labels,
+  headingLevel = 2,
+  idPrefix = "ec-policy-",
+  meta = true,
+  hideEmpty = false,
+  className
+}) {
+  const model = buildPolicyModel(config, lang, { date, labels });
+  const L = model.labels;
+  const H = `h${headingLevel}`;
+  const displayDate = formatPolicyDate(model);
+  const categories = hideEmpty ? model.categories.filter((c) => c.services.length > 0) : model.categories;
+  return /* @__PURE__ */ jsxs("div", { className: ["ec-policy", className].filter(Boolean).join(" "), lang: model.lang, children: [
+    meta && /* @__PURE__ */ jsxs("p", { className: "ec-policy__meta", children: [
+      displayDate && /* @__PURE__ */ jsxs(Fragment, { children: [
+        L.updated,
+        ": ",
+        /* @__PURE__ */ jsx("time", { dateTime: model.date, children: displayDate }),
+        " \xB7 "
+      ] }),
+      L.revision,
+      ": ",
+      /* @__PURE__ */ jsx("span", { className: "ec-policy__revision", children: model.revision })
+    ] }),
+    categories.map((cat) => {
+      const id = `${idPrefix}${cat.id}`;
+      const rows = policyRows(cat);
+      return /* @__PURE__ */ jsxs("section", { className: "ec-policy__category", id, "data-category": cat.id, "aria-labelledby": `${id}-title`, children: [
+        /* @__PURE__ */ jsx(H, { className: "ec-policy__title", id: `${id}-title`, children: cat.title }),
+        cat.readOnly && /* @__PURE__ */ jsx("p", { className: "ec-policy__badge", children: L.alwaysOn }),
+        cat.description && /* @__PURE__ */ jsx("p", { className: "ec-policy__description", children: cat.description }),
+        rows.length === 0 ? /* @__PURE__ */ jsx("p", { className: "ec-policy__empty", children: L.noCookies }) : /* @__PURE__ */ jsx("div", { className: "ec-policy__table-wrap", children: /* @__PURE__ */ jsxs("table", { className: "ec-policy__table", children: [
+          /* @__PURE__ */ jsx("caption", { className: "ec-policy__caption", children: L.caption.replace("{category}", cat.title) }),
+          /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { children: [L.cookie, L.service, L.provider, L.duration, L.purpose].map((t) => /* @__PURE__ */ jsx("th", { scope: "col", children: t }, t)) }) }),
+          /* @__PURE__ */ jsx("tbody", { children: rows.map(({ service, cookie }) => /* @__PURE__ */ jsxs("tr", { "data-service": service.id, children: [
+            /* @__PURE__ */ jsx("th", { scope: "row", children: cookie ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("code", { className: "ec-policy__cookie", title: cookie.pattern ? cookie.name : void 0, children: cookie.displayName }),
+              cookie.domain && /* @__PURE__ */ jsxs(Fragment, { children: [
+                " ",
+                /* @__PURE__ */ jsx("span", { className: "ec-policy__domain", children: cookie.domain })
+              ] })
+            ] }) : /* @__PURE__ */ jsx("span", { className: "ec-policy__none", children: L.noCookie }) }),
+            /* @__PURE__ */ jsx("td", { className: "ec-policy__service", children: service.label }),
+            /* @__PURE__ */ jsx("td", { className: "ec-policy__provider", children: service.privacyUrl && /^(https?:|mailto:|\/|#)/i.test(service.privacyUrl.trim()) ? /* @__PURE__ */ jsx("a", { className: "ec-policy__link", href: service.privacyUrl, rel: "noopener noreferrer", target: "_blank", children: service.provider || L.privacyPolicy }) : service.provider }),
+            /* @__PURE__ */ jsx("td", { className: "ec-policy__duration", children: cookie?.duration ?? "" }),
+            /* @__PURE__ */ jsx("td", { className: "ec-policy__purpose", children: cookie?.description || service.purpose })
+          ] }, `${service.id}:${cookie?.name ?? ""}`)) })
+        ] }) })
+      ] }, cat.id);
+    })
+  ] });
+}
+function LegalDocumentHtml({ doc, className, fallback = null }) {
+  if (!doc?.html) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  return /* @__PURE__ */ jsx("div", { className, dangerouslySetInnerHTML: { __html: doc.html } });
+}
+export {
+  CookiePolicy,
+  LegalDocument,
+  LegalDocumentHtml,
+  buildPolicyModel,
+  fetchLegalDocument
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"sourcesContent":["import type { EasyCookieConfig } from '@easy-cookie/core/shared';\nimport { buildPolicyModel, formatPolicyDate, type BuildPolicyOptions } from './model';\nimport { policyRows, type RenderPolicyOptions } from './render';\nimport type { ReactNode } from 'react';\nimport type { PublishedLegalDocument } from './legal-client';\n\nexport interface CookiePolicyProps extends BuildPolicyOptions, RenderPolicyOptions {\n  config: EasyCookieConfig;\n  lang: string;\n  className?: string;\n}\n\n/**\n * The cookie section of a policy page, generated from the config.\n * No hooks and no browser APIs: works as a React Server Component.\n * Same markup and class names as `renderPolicyHtml()`.\n */\nexport function CookiePolicy({\n  config,\n  lang,\n  date,\n  labels,\n  headingLevel = 2,\n  idPrefix = 'ec-policy-',\n  meta = true,\n  hideEmpty = false,\n  className,\n}: CookiePolicyProps) {\n  const model = buildPolicyModel(config, lang, { date, labels });\n  const L = model.labels;\n  const H = `h${headingLevel}` as 'h2';\n  const displayDate = formatPolicyDate(model);\n  const categories = hideEmpty ? model.categories.filter((c) => c.services.length > 0) : model.categories;\n\n  return (\n    <div className={['ec-policy', className].filter(Boolean).join(' ')} lang={model.lang}>\n      {meta && (\n        <p className=\"ec-policy__meta\">\n          {displayDate && (\n            <>\n              {L.updated}: <time dateTime={model.date}>{displayDate}</time>\n              {' · '}\n            </>\n          )}\n          {L.revision}: <span className=\"ec-policy__revision\">{model.revision}</span>\n        </p>\n      )}\n      {categories.map((cat) => {\n        const id = `${idPrefix}${cat.id}`;\n        const rows = policyRows(cat);\n        return (\n          <section key={cat.id} className=\"ec-policy__category\" id={id} data-category={cat.id} aria-labelledby={`${id}-title`}>\n            <H className=\"ec-policy__title\" id={`${id}-title`}>\n              {cat.title}\n            </H>\n            {cat.readOnly && <p className=\"ec-policy__badge\">{L.alwaysOn}</p>}\n            {cat.description && <p className=\"ec-policy__description\">{cat.description}</p>}\n            {rows.length === 0 ? (\n              <p className=\"ec-policy__empty\">{L.noCookies}</p>\n            ) : (\n              <div className=\"ec-policy__table-wrap\">\n                <table className=\"ec-policy__table\">\n                  <caption className=\"ec-policy__caption\">{L.caption.replace('{category}', cat.title)}</caption>\n                  <thead>\n                    <tr>\n                      {[L.cookie, L.service, L.provider, L.duration, L.purpose].map((t) => (\n                        <th key={t} scope=\"col\">\n                          {t}\n                        </th>\n                      ))}\n                    </tr>\n                  </thead>\n                  <tbody>\n                    {rows.map(({ service, cookie }) => (\n                      <tr key={`${service.id}:${cookie?.name ?? ''}`} data-service={service.id}>\n                        <th scope=\"row\">\n                          {cookie ? (\n                            <>\n                              <code className=\"ec-policy__cookie\" title={cookie.pattern ? cookie.name : undefined}>\n                                {cookie.displayName}\n                              </code>\n                              {cookie.domain && (\n                                <>\n                                  {' '}\n                                  <span className=\"ec-policy__domain\">{cookie.domain}</span>\n                                </>\n                              )}\n                            </>\n                          ) : (\n                            <span className=\"ec-policy__none\">{L.noCookie}</span>\n                          )}\n                        </th>\n                        <td className=\"ec-policy__service\">{service.label}</td>\n                        <td className=\"ec-policy__provider\">\n                          {service.privacyUrl && /^(https?:|mailto:|\\/|#)/i.test(service.privacyUrl.trim()) ? (\n                            <a className=\"ec-policy__link\" href={service.privacyUrl} rel=\"noopener noreferrer\" target=\"_blank\">\n                              {service.provider || L.privacyPolicy}\n                            </a>\n                          ) : (\n                            service.provider\n                          )}\n                        </td>\n                        <td className=\"ec-policy__duration\">{cookie?.duration ?? ''}</td>\n                        <td className=\"ec-policy__purpose\">{cookie?.description || service.purpose}</td>\n                      </tr>\n                    ))}\n                  </tbody>\n                </table>\n              </div>\n            )}\n          </section>\n        );\n      })}\n    </div>\n  );\n}\n\nexport { buildPolicyModel, type PolicyModel } from './model';\n\nexport interface LegalDocumentHtmlProps {\n  /** A document from `fetchLegalDocument()` / `getLegalDocument()` (or anything with `html`). */\n  doc: Pick<PublishedLegalDocument, 'html'> | null | undefined;\n  className?: string;\n  /** Shown when `doc` is null (nothing published yet). */\n  fallback?: ReactNode;\n}\n\n/**\n * Render a legal document fetched on the server. The HTML comes from the\n * consent server's renderer (raw HTML disabled, safe links only), so it is\n * inserted as-is. Works as a React Server Component.\n */\nexport function LegalDocumentHtml({ doc, className, fallback = null }: LegalDocumentHtmlProps) {\n  if (!doc?.html) return <>{fallback}</>;\n  return <div className={className} dangerouslySetInnerHTML={{ __html: doc.html }} />;\n}\n\n// Client component: built as its own file with a \"use client\" banner (see tsup.config.ts).\nexport { LegalDocument, type LegalDocumentProps } from './legal-document';\nexport { fetchLegalDocument, type FetchLegalDocumentOptions, type PublishedLegalDocument } from './legal-client';\n"],"mappings":"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","names":[]}

package/dist/render-DYrvn1cT.d.cts

@@ -0,0 +1,115 @@
+import { EasyCookieConfig } from '@easy-cookie/core/shared';
+
+interface PolicyLabels {
+    cookie: string;
+    service: string;
+    provider: string;
+    duration: string;
+    purpose: string;
+    /** Prefix of the "last updated" line. */
+    updated: string;
+    revision: string;
+    alwaysOn: string;
+    privacyPolicy: string;
+    /** Shown in a category without services. */
+    noCookies: string;
+    /** Shown in the cookie column for a service that sets no cookies. */
+    noCookie: string;
+    /** Table caption: `{category}` is replaced with the category title. */
+    caption: string;
+}
+/** Built-in table headers and labels. Unknown languages fall back to English. */
+declare const POLICY_LABELS: Record<'it' | 'en', PolicyLabels>;
+interface PolicyCookie {
+    /** Name as declared (a regular expression source when `pattern` is true). */
+    name: string;
+    /** Human-friendly name: anchors stripped, `.*` shown as `*` for patterns. */
+    displayName: string;
+    pattern: boolean;
+    duration: string;
+    description: string;
+    domain?: string;
+}
+interface PolicyService {
+    id: string;
+    label: string;
+    provider: string;
+    privacyUrl?: string;
+    purpose: string;
+    cookies: PolicyCookie[];
+}
+interface PolicyCategory {
+    id: string;
+    title: string;
+    description: string;
+    readOnly: boolean;
+    color: string;
+    services: PolicyService[];
+}
+interface PolicyModel {
+    lang: string;
+    revision: string;
+    /** ISO date (YYYY-MM-DD) of the revision, when known. */
+    date?: string;
+    policyUrl?: string;
+    labels: PolicyLabels;
+    categories: PolicyCategory[];
+}
+interface BuildPolicyOptions {
+    /** Date of this revision (ISO). Defaults to the revision itself when it starts with YYYY-MM-DD. */
+    date?: string | Date;
+    /** Override some labels. */
+    labels?: Partial<PolicyLabels>;
+}
+/** Make a cookie-name regular expression readable: `^_ga_.*$` → `_ga_*`. */
+declare function prettyCookiePattern(source: string): string;
+/**
+ * Turn the config into a localized, render-agnostic cookie policy model:
+ * categories → services → cookies. Pure and DOM-free.
+ */
+declare function buildPolicyModel(config: EasyCookieConfig, lang: string, opts?: BuildPolicyOptions): PolicyModel;
+/** Format the model date for display, e.g. "13 novembre 2026" / "November 13, 2026". */
+declare function formatPolicyDate(model: Pick<PolicyModel, 'date' | 'lang'>): string | undefined;
+interface AutoClearRule {
+    /** Cookie name, or a regular expression source when `pattern` is true. */
+    name: string;
+    pattern: boolean;
+    domain?: string;
+    service: string;
+}
+/**
+ * Cookies to delete when a category is withdrawn, per category id.
+ * Read-only (necessary) categories are omitted: they cannot be withdrawn.
+ */
+declare function autoClearRules(config: EasyCookieConfig): Record<string, AutoClearRule[]>;
+/** True when `cookieName` matches the rule. */
+declare function matchesRule(rule: Pick<AutoClearRule, 'name' | 'pattern'>, cookieName: string): boolean;
+
+interface RenderPolicyOptions {
+    /** Heading level of category titles (2 → `<h2>`). Default 2. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Prefix for section ids (`#ec-policy-measurement`). Default `ec-policy-`. */
+    idPrefix?: string;
+    /** Show the "last updated / revision" line. Default true. */
+    meta?: boolean;
+    /** Omit categories without services. Default false. */
+    hideEmpty?: boolean;
+}
+declare function escapeHtml(value: string): string;
+interface PolicyRow {
+    service: PolicyService;
+    cookie?: PolicyService['cookies'][number];
+    /** First row of this service (for grouping). */
+    first: boolean;
+}
+/** Flatten a category to table rows: one per cookie, or one per service without cookies. */
+declare function policyRows(cat: PolicyCategory): PolicyRow[];
+/**
+ * Semantic HTML for the cookie section of a policy: one `<section>` and one
+ * `<table>` per category. Class names only (`ec-policy*`), no inline styles.
+ */
+declare function renderPolicyHtml(model: PolicyModel, opts?: RenderPolicyOptions): string;
+/** GitHub-flavoured Markdown version of the policy (one table per category). */
+declare function renderPolicyMarkdown(model: PolicyModel, opts?: Pick<RenderPolicyOptions, 'headingLevel' | 'meta' | 'hideEmpty'>): string;
+
+export { type AutoClearRule as A, type BuildPolicyOptions as B, POLICY_LABELS as P, type RenderPolicyOptions as R, type PolicyCategory as a, type PolicyCookie as b, type PolicyLabels as c, type PolicyModel as d, type PolicyRow as e, type PolicyService as f, autoClearRules as g, buildPolicyModel as h, escapeHtml as i, formatPolicyDate as j, prettyCookiePattern as k, renderPolicyMarkdown as l, matchesRule as m, policyRows as p, renderPolicyHtml as r };

package/dist/render-DYrvn1cT.d.ts

@@ -0,0 +1,115 @@
+import { EasyCookieConfig } from '@easy-cookie/core/shared';
+
+interface PolicyLabels {
+    cookie: string;
+    service: string;
+    provider: string;
+    duration: string;
+    purpose: string;
+    /** Prefix of the "last updated" line. */
+    updated: string;
+    revision: string;
+    alwaysOn: string;
+    privacyPolicy: string;
+    /** Shown in a category without services. */
+    noCookies: string;
+    /** Shown in the cookie column for a service that sets no cookies. */
+    noCookie: string;
+    /** Table caption: `{category}` is replaced with the category title. */
+    caption: string;
+}
+/** Built-in table headers and labels. Unknown languages fall back to English. */
+declare const POLICY_LABELS: Record<'it' | 'en', PolicyLabels>;
+interface PolicyCookie {
+    /** Name as declared (a regular expression source when `pattern` is true). */
+    name: string;
+    /** Human-friendly name: anchors stripped, `.*` shown as `*` for patterns. */
+    displayName: string;
+    pattern: boolean;
+    duration: string;
+    description: string;
+    domain?: string;
+}
+interface PolicyService {
+    id: string;
+    label: string;
+    provider: string;
+    privacyUrl?: string;
+    purpose: string;
+    cookies: PolicyCookie[];
+}
+interface PolicyCategory {
+    id: string;
+    title: string;
+    description: string;
+    readOnly: boolean;
+    color: string;
+    services: PolicyService[];
+}
+interface PolicyModel {
+    lang: string;
+    revision: string;
+    /** ISO date (YYYY-MM-DD) of the revision, when known. */
+    date?: string;
+    policyUrl?: string;
+    labels: PolicyLabels;
+    categories: PolicyCategory[];
+}
+interface BuildPolicyOptions {
+    /** Date of this revision (ISO). Defaults to the revision itself when it starts with YYYY-MM-DD. */
+    date?: string | Date;
+    /** Override some labels. */
+    labels?: Partial<PolicyLabels>;
+}
+/** Make a cookie-name regular expression readable: `^_ga_.*$` → `_ga_*`. */
+declare function prettyCookiePattern(source: string): string;
+/**
+ * Turn the config into a localized, render-agnostic cookie policy model:
+ * categories → services → cookies. Pure and DOM-free.
+ */
+declare function buildPolicyModel(config: EasyCookieConfig, lang: string, opts?: BuildPolicyOptions): PolicyModel;
+/** Format the model date for display, e.g. "13 novembre 2026" / "November 13, 2026". */
+declare function formatPolicyDate(model: Pick<PolicyModel, 'date' | 'lang'>): string | undefined;
+interface AutoClearRule {
+    /** Cookie name, or a regular expression source when `pattern` is true. */
+    name: string;
+    pattern: boolean;
+    domain?: string;
+    service: string;
+}
+/**
+ * Cookies to delete when a category is withdrawn, per category id.
+ * Read-only (necessary) categories are omitted: they cannot be withdrawn.
+ */
+declare function autoClearRules(config: EasyCookieConfig): Record<string, AutoClearRule[]>;
+/** True when `cookieName` matches the rule. */
+declare function matchesRule(rule: Pick<AutoClearRule, 'name' | 'pattern'>, cookieName: string): boolean;
+
+interface RenderPolicyOptions {
+    /** Heading level of category titles (2 → `<h2>`). Default 2. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Prefix for section ids (`#ec-policy-measurement`). Default `ec-policy-`. */
+    idPrefix?: string;
+    /** Show the "last updated / revision" line. Default true. */
+    meta?: boolean;
+    /** Omit categories without services. Default false. */
+    hideEmpty?: boolean;
+}
+declare function escapeHtml(value: string): string;
+interface PolicyRow {
+    service: PolicyService;
+    cookie?: PolicyService['cookies'][number];
+    /** First row of this service (for grouping). */
+    first: boolean;
+}
+/** Flatten a category to table rows: one per cookie, or one per service without cookies. */
+declare function policyRows(cat: PolicyCategory): PolicyRow[];
+/**
+ * Semantic HTML for the cookie section of a policy: one `<section>` and one
+ * `<table>` per category. Class names only (`ec-policy*`), no inline styles.
+ */
+declare function renderPolicyHtml(model: PolicyModel, opts?: RenderPolicyOptions): string;
+/** GitHub-flavoured Markdown version of the policy (one table per category). */
+declare function renderPolicyMarkdown(model: PolicyModel, opts?: Pick<RenderPolicyOptions, 'headingLevel' | 'meta' | 'hideEmpty'>): string;
+
+export { type AutoClearRule as A, type BuildPolicyOptions as B, POLICY_LABELS as P, type RenderPolicyOptions as R, type PolicyCategory as a, type PolicyCookie as b, type PolicyLabels as c, type PolicyModel as d, type PolicyRow as e, type PolicyService as f, autoClearRules as g, buildPolicyModel as h, escapeHtml as i, formatPolicyDate as j, prettyCookiePattern as k, renderPolicyMarkdown as l, matchesRule as m, policyRows as p, renderPolicyHtml as r };

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@easy-cookie/policy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Generate the cookie policy (HTML, Markdown, React) and autoClear rules from an easy-cookie config.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Aleloca/easy-cookie.git",
+    "directory": "packages/policy"
+  },
+  "bugs": {
+    "url": "https://github.com/Aleloca/easy-cookie/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./legal.css": "./dist/easy-cookie-legal.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "markdown-it": "^14.3.3",
+    "@easy-cookie/core": "^0.1.1"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/markdown-it": "^14.2.0",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://consent.aleloca.dev",
+  "keywords": [
+    "cookie",
+    "consent",
+    "gdpr",
+    "cookie-banner",
+    "consent-mode"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsup && node -e \"require('fs').copyFileSync('src/legal.css','dist/easy-cookie-legal.css')\"",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }