@roottale/cms-renderer-next 0.52.0 → 0.53.0

package/dist/validate.d.ts

@@ -1,104 +0,0 @@
-import { Severity, MEDICAL_LINT_RULESET } from '@roottale/audit-medical';
-import { TAX_LINT_RULESET } from '@roottale/audit-tax';
-
-interface SectionLock {
-    move?: boolean;
-    remove?: boolean;
-    structure?: boolean;
-}
-type SectionLockViolationCode = "locked_section_inserted" | "locked_section_removed" | "locked_section_moved" | "locked_section_lock_changed" | "locked_section_structure_changed";
-interface SectionLockViolation {
-    code: SectionLockViolationCode;
-    sectionId: string;
-    sectionType: string;
-    field: string;
-}
-declare function isSectionContentPropPath(sectionType: string, path: readonly (string | number)[]): boolean;
-declare function findSectionLockViolations(beforeDoc: unknown, afterDoc: unknown): SectionLockViolation[];
-declare function formatSectionLockViolations(violations: readonly SectionLockViolation[]): string;
-
-declare const PUBLISH_GATE_RULESET = "publish-gate-2026-07-02";
-type PublishGateError = {
-    readonly code: string;
-    readonly message: string;
-    readonly ruleId?: string;
-    readonly severity?: Severity;
-    readonly snippet?: string;
-};
-type PublishGateRuleset = {
-    readonly publish: typeof PUBLISH_GATE_RULESET;
-    readonly medical?: typeof MEDICAL_LINT_RULESET;
-    readonly tax?: typeof TAX_LINT_RULESET;
-};
-type PublishGateResult = {
-    readonly errors: readonly PublishGateError[];
-    /** 비차단 소견 (warning·info) — 발행은 통과, meta.compliance 에 기록 (2026-07-11) */
-    readonly warnings: readonly PublishGateError[];
-    readonly ruleset: PublishGateRuleset;
-};
-type PublishGateDoc = {
-    readonly title?: string | null;
-    readonly excerpt?: string | null;
-    readonly bodyJson: Record<string, unknown>;
-    readonly metaJson?: Record<string, unknown> | null;
-    /**
-     * seo-checks 의 slug-length 체크용(선택). 미전달 시 "" — 항상 good 판정이라
-     * 안전한 기본값(fail-open, 차단 아님).
-     */
-    readonly slug?: string | null;
-    /**
-     * seo-checks 의 featured-image 체크용(선택). 미전달 시 false — 항상 warn
-     * 판정(경고일 뿐 warnings 도 아님, bad 만 승격되므로 무영향).
-     */
-    readonly hasFeaturedImage?: boolean;
-};
-/**
- * h1 모델 (W6-1) — 문서 타입별로 h1 소유자가 다르다:
- * - `"page"`: 본문(hero 섹션 또는 heading level=1)이 유일 h1. 렌더러가 `doc.title`
- *   을 h1 으로 그리지 않으므로 body h1Labels.length !== 1 → 차단.
- * - `"post"`: 렌더러(`RootTaleBlogPost`)가 `post.title` 을 h1 으로 그린다 —
- *   본문에 h1 이 있으면 실렌더 h1=2 가 되므로 body h1Labels.length !== 0 → 차단.
- * `documentType` 은 fail-closed 로 필수(optional 금지) — 신규 호출부가 실수로
- * type 분기를 빼먹으면 컴파일 에러가 나야 한다.
- */
-type PublishGateOptions = {
-    readonly vertical: string | null | undefined;
-    readonly complianceFlags?: readonly string[];
-    readonly documentType: "page" | "post";
-};
-type PublishOverrideInput = {
-    readonly reason: string;
-    readonly userId: string;
-    readonly at: string;
-};
-declare function assertPublishable(doc: PublishGateDoc, options: PublishGateOptions): PublishGateResult;
-declare function writePublishGateMeta(metaJson: Record<string, unknown> | null | undefined, result: PublishGateResult): Record<string, unknown>;
-declare function writePublishOverrideMeta(metaJson: Record<string, unknown> | null | undefined, override: PublishOverrideInput): Record<string, unknown>;
-declare function isComplianceBlocked(metaJson: Record<string, unknown> | null | undefined): boolean;
-declare function hasPublishOverride(metaJson: Record<string, unknown> | null | undefined): boolean;
-
-/** 검증 실패 1건. path = 문서 내 섹션 노드 위치(0-base), field = zod issue 경로. */
-interface SectionValidationIssue {
-    /** 문서 최상위 content 배열에서 섹션 노드의 index. */
-    index: number;
-    sectionType: string;
-    /** zod issue 경로 (예: "props.title"). */
-    field: string;
-    message: string;
-}
-interface SectionValidationResult {
-    valid: boolean;
-    issues: SectionValidationIssue[];
-}
-/**
- * 문서 내 모든 섹션 노드를 SectionSchema 로 검증. 섹션 노드가 없으면 valid=true
- * (no-op). 하나라도 스키마 위반이면 valid=false + issue 목록.
- *
- * posts.ts(create/update) 가 이 결과를 보고 저장을 거부한다. rawHtml 생성 금지 —
- * 실패는 저장 거부일 뿐 노드를 변형하지 않는다.
- */
-declare function validateSectionNodes(doc: unknown): SectionValidationResult;
-/** issue 목록을 사람이 읽는 한 줄 메시지로 (저장 거부 오류 문구용). */
-declare function formatSectionIssues(issues: SectionValidationIssue[]): string;
-
-export { PUBLISH_GATE_RULESET, type PublishGateDoc, type PublishGateError, type PublishGateOptions, type PublishGateResult, type PublishGateRuleset, type PublishOverrideInput, type SectionLock, type SectionLockViolation, type SectionLockViolationCode, type SectionValidationIssue, type SectionValidationResult, assertPublishable, findSectionLockViolations, formatSectionIssues, formatSectionLockViolations, hasPublishOverride, isComplianceBlocked, isSectionContentPropPath, validateSectionNodes, writePublishGateMeta, writePublishOverrideMeta };