@easy-cookie/policy 0.0.0-stage → 0.1.1

package/dist/client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Legal document types and the fetch client. Kept free of the Markdown
+ * renderer so browser bundles (React component, Next.js) stay small.
+ */
+/** The three legal documents every site has. */
+type LegalKind = 'cookie' | 'privacy' | 'terms';
+declare const LEGAL_KINDS: readonly LegalKind[];
+declare const isLegalKind: (v: unknown) => v is LegalKind;
+interface LegalTranslation {
+    title: string;
+    /** Markdown, rendered with raw HTML disabled. */
+    body: string;
+}
+/** Content of a legal document: one entry per language it is written in. */
+interface LegalDocContent {
+    translations: Record<string, LegalTranslation>;
+}
+/** A published document as served by `GET /v1/sites/:publicKey/legal/:kind.json`. */
+interface PublishedLegalDocument {
+    kind: LegalKind;
+    /** Language actually shown (after fallback). */
+    lang: string;
+    /** Every language the document is written in. */
+    languages: string[];
+    title: string;
+    /** Rendered, safe HTML wrapped in `<div class="ec-legal" lang="…">`. */
+    html: string;
+    version: string;
+    publishedAt: string;
+}
+interface FetchLegalDocumentOptions {
+    /** Base URL of the consent server. */
+    endpoint: string;
+    /** Public site key (`pk_…`). */
+    siteKey: string;
+    kind: LegalKind;
+    lang?: string;
+    /** Extra fetch options (e.g. Next's `next: { revalidate }`). */
+    init?: RequestInit & Record<string, unknown>;
+    /** Custom fetch implementation. */
+    fetch?: typeof fetch;
+}
+/** URL of the published document JSON on the consent server. */
+declare function legalDocumentUrl(opts: Pick<FetchLegalDocumentOptions, 'endpoint' | 'siteKey' | 'kind' | 'lang'>): string;
+/**
+ * Fetch a published legal document from the consent server.
+ * Resolves to null when nothing is published yet (404); throws on other errors.
+ */
+declare function fetchLegalDocument(opts: FetchLegalDocumentOptions): Promise<PublishedLegalDocument | null>;
+
+export { type FetchLegalDocumentOptions, LEGAL_KINDS, type LegalDocContent, type LegalKind, type LegalTranslation, type PublishedLegalDocument, fetchLegalDocument, isLegalKind, legalDocumentUrl };

package/dist/client.js

@@ -0,0 +1,13 @@
+import {
+  LEGAL_KINDS,
+  fetchLegalDocument,
+  isLegalKind,
+  legalDocumentUrl
+} from "./chunk-HDY2VYU4.js";
+export {
+  LEGAL_KINDS,
+  fetchLegalDocument,
+  isLegalKind,
+  legalDocumentUrl
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/easy-cookie-legal.css

@@ -0,0 +1,129 @@
+/*
+ * @easy-cookie/policy: legal documents (cookie policy, privacy policy, terms).
+ * Neutral and readable on its own; restyle it through the --ec-legal-* variables,
+ * set on :root, on .ec-legal or on any ancestor.
+ * Selectors use :where() so any site rule wins without !important.
+ */
+:where(.ec-legal) {
+  box-sizing: border-box;
+  max-width: var(--ec-legal-max-width, 72ch);
+  font-family: var(--ec-legal-font, system-ui, sans-serif);
+  font-size: 1rem;
+  line-height: 1.6;
+  color: var(--ec-legal-ink, #1c1c1a);
+  overflow-wrap: break-word;
+}
+
+:where(.ec-legal) *,
+:where(.ec-legal) *::before,
+:where(.ec-legal) *::after {
+  box-sizing: inherit;
+}
+
+:where(.ec-legal) :where(h1, h2, h3, h4) {
+  line-height: 1.25;
+  margin: 2em 0 0.6em;
+  font-weight: 650;
+}
+:where(.ec-legal) :where(h1) { font-size: 2em; margin-top: 0; }
+:where(.ec-legal) :where(h2) { font-size: 1.4em; padding-bottom: 0.3em; border-bottom: 1px solid var(--ec-legal-line, #dcdcd6); }
+:where(.ec-legal) :where(h3) { font-size: 1.15em; }
+:where(.ec-legal) :where(h4) { font-size: 1em; }
+
+:where(.ec-legal) :where(p, ul, ol, table, blockquote, .ec-policy__table-wrap) { margin: 0 0 1em; }
+:where(.ec-legal) :where(ul, ol) { padding-left: 1.5em; }
+:where(.ec-legal) :where(li) { margin: 0.25em 0; }
+
+:where(.ec-legal) :where(a) {
+  color: var(--ec-legal-accent, #1a56c4);
+  text-decoration: underline;
+  text-underline-offset: 0.15em;
+}
+:where(.ec-legal) :where(a:focus-visible) {
+  outline: 2px solid var(--ec-legal-accent, #1a56c4);
+  outline-offset: 2px;
+}
+
+:where(.ec-legal) :where(code) {
+  font-family: ui-monospace, monospace;
+  font-size: 0.9em;
+}
+
+:where(.ec-legal) :where(blockquote) {
+  margin-left: 0;
+  padding-left: 1em;
+  border-left: 1px solid var(--ec-legal-line, #dcdcd6);
+  color: var(--ec-legal-muted, #5a5a55);
+}
+
+:where(.ec-legal) :where(hr) {
+  border: 0;
+  border-top: 1px solid var(--ec-legal-line, #dcdcd6);
+  margin: 2em 0;
+}
+
+/* Tables: Markdown tables and the generated cookie tables. */
+:where(.ec-legal) :where(.ec-policy__table-wrap) { overflow-x: auto; }
+:where(.ec-legal) :where(table) {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.92em;
+}
+:where(.ec-legal) :where(th, td) {
+  text-align: left;
+  vertical-align: top;
+  padding: 0.5em 0.75em;
+  border-bottom: 1px solid var(--ec-legal-line, #dcdcd6);
+}
+:where(.ec-legal) :where(thead th) {
+  font-weight: 600;
+  border-bottom-width: 2px;
+  white-space: nowrap;
+}
+:where(.ec-legal) :where(tbody th) { font-weight: 400; }
+
+/* Generated cookie policy (`{{cookie-table}}`). */
+:where(.ec-legal) :where(.ec-policy__category) { margin: 0 0 1.75em; }
+:where(.ec-legal) :where(.ec-policy__caption) {
+  caption-side: top;
+  text-align: left;
+  font-size: 0.85em;
+  color: var(--ec-legal-muted, #5a5a55);
+  padding-bottom: 0.4em;
+}
+:where(.ec-legal) :where(.ec-policy__badge) {
+  display: inline-block;
+  font-size: 0.8em;
+  padding: 0.1em 0.6em;
+  border: 1px solid var(--ec-legal-line, #dcdcd6);
+  border-radius: 999px;
+  color: var(--ec-legal-muted, #5a5a55);
+}
+:where(.ec-legal) :where(.ec-policy__domain, .ec-policy__none, .ec-policy__empty) { color: var(--ec-legal-muted, #5a5a55); }
+
+/* Services list (`{{services-list}}`). */
+:where(.ec-legal) :where(.ec-legal__services) { list-style: none; padding: 0; }
+:where(.ec-legal) :where(.ec-legal__service) {
+  margin: 0;
+  padding: 0.75em 0;
+  border-bottom: 1px solid var(--ec-legal-line, #dcdcd6);
+}
+:where(.ec-legal) :where(.ec-legal__service p) { margin: 0.15em 0; }
+:where(.ec-legal) :where(.ec-legal__service-meta) { font-size: 0.9em; color: var(--ec-legal-muted, #5a5a55); }
+
+:where(.ec-legal) :where(.ec-legal__updated, .ec-legal__notice, .ec-legal__empty) { color: var(--ec-legal-muted, #5a5a55); }
+
+/* `[[placeholders]]` the owner still has to fill in. */
+:where(.ec-legal) :where(.ec-legal__todo) {
+  background: var(--ec-legal-todo, #fff2a8);
+  color: inherit;
+  padding: 0.05em 0.25em;
+  border-radius: 3px;
+  box-decoration-break: clone;
+  -webkit-box-decoration-break: clone;
+}
+
+@media print {
+  :where(.ec-legal) { max-width: none; }
+  :where(.ec-legal) :where(a) { color: inherit; }
+}