@etamong-playground/legal

About — One of several small shared libraries used across a personal "fleet" of small apps (error handling · audit logging · encryption-at-rest · i18n · UI · …). Authored and maintained with Claude Code (Anthropic's agentic CLI). Each README documents the design rationale behind the library.

This is a public repository — keep internal infrastructure details (hostnames, secret/Vault paths, private URLs, internal issue/MR references) out of code, comments, and commit messages.

Shared, versioned legal-document toolkit for etamong-playground apps — one model, renderers, and advance-notice logic for Terms (이용약관) / Privacy (개인정보처리방침), so each app stops re-implementing its own.

Headless & styleless. Ships a model + helpers + renderers that emit legal-* class names only. Theme via the optional stylesheet's CSS variables, or style the classes yourself. No router, no bundled content — each app owns its own version data in its own repo (so the legal audit trail stays in git).

Install

pnpm add @etamong-playground/legal

Resolving @etamong-playground/* from GitHub Packages requires the registry in .npmrc:

@etamong-playground:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<your-github-token>

Model

interface LegalVersion {
  version: string;          // "1.0"
  publishedDate: string;    // 공고일 YYYY-MM-DD
  effectiveDate: string;    // 시행일 YYYY-MM-DD
  summary?: string;
  adverse?: boolean;        // 불리/중대 → 30일 사전공지 (else 7일)
  sections: { title: string; content: ReactNode }[];
  changes?: VersionChange[]; // diff vs previous version
}
interface LegalDocMeta { kind: "terms" | "privacy"; title: string; versions: LegalVersion[] }

Newest version first. Publishing a change = append a version with a future effectiveDate. Advance-notice (공시) and the effective-date flip are pure date functions — no scheduled job.

Helpers

• effectiveVersion(versions, today?) — the version in force.
• upcomingVersion(versions, today?) — soonest announced-but-not-yet-effective version, or null. Guarded by publishedDate <= today so drafts don't trigger a public banner.
• todayISO(timeZone = "Asia/Seoul") — today as YYYY-MM-DD in the jurisdiction.

Components

| Component | Purpose | |---|---| | <LegalDocument version> | Renders a version's titled sections. | | <VersionDiff changes fromVersion toVersion> | 3-column 변경 전/후 table; ==highlight== markup. | | <VersionHistory versions selectedIdx onSelect> | Controlled version picker. | | <UpcomingNotice docTitle version onPreview?> | Per-doc 변경 예정 card. | | <PolicyNotice docs hrefFor renderLink?> | Site-wide dismissible 사전공시 banner. |

PolicyNotice is router-agnostic — pass renderLink={(href, kids) => <Link to={href}>{kids}</Link>} to use your app's Link. Interactive components use state; mount them inside a client boundary (Next.js "use client").

Theming

import "@etamong-playground/legal/styles.css";

Override CSS variables for theme / dark mode:

.dark {
  --legal-fg: #d4d4d8;
  --legal-border: #3f3f46;
  --legal-surface: #27272a;
  --legal-notice-bg: #1e3a8a33;
  /* ... see src/styles.css for the full list */
}

Releasing

Bump version in package.json, commit, then push a matching tag:

git tag v0.1.0 && git push origin v0.1.0

CI publishes to GitHub Packages on tags matching vX.Y.Z.

Acknowledgements

Built for React (peer dependency, MIT).

License

MIT — see LICENSE.