@roottale/cms-renderer-next 0.41.1 → 0.42.0

package/dist/seo-checks.d.ts

@@ -0,0 +1,87 @@
+type SeoCheckLevel = "good" | "warn" | "bad";
+interface SeoCheckResult {
+    id: string;
+    level: SeoCheckLevel;
+    label: string;
+    hint: string;
+}
+interface SeoCheckInput {
+    title: string;
+    seoTitle: string;
+    seoDescription: string;
+    excerpt: string;
+    slug: string;
+    /** Tiptap doc JSON (PostsEditor 의 editor.getJSON() 형태). */
+    bodyJson: TiptapNode | null | undefined;
+    hasFeaturedImage: boolean;
+    /** SEO 패널의 canonical URL — noindex 와 겸용 충돌 점검용 (선택). */
+    canonical?: string;
+    /** SEO 패널의 noindex 설정 (선택). */
+    noindex?: boolean;
+}
+interface TiptapMark {
+    type?: string;
+    attrs?: Record<string, unknown>;
+}
+interface TiptapNode {
+    type?: string;
+    text?: string;
+    attrs?: Record<string, unknown>;
+    content?: TiptapNode[];
+    marks?: TiptapMark[];
+}
+/** depth-first 로 모든 노드를 방문한다 (루트 포함). */
+declare function walkNodes(node: TiptapNode | null | undefined, visit: (node: TiptapNode) => void): void;
+/** 조건에 맞는 노드를 문서 순서대로 수집한다. */
+declare function collectNodes(node: TiptapNode | null | undefined, predicate: (node: TiptapNode) => boolean): TiptapNode[];
+/** 본문 텍스트 추출 — 블록 경계는 개행으로 구분. */
+declare function extractText(node: TiptapNode | null | undefined): string;
+/** 공백 제외 글자 수 — "본문 분량" 측정 기준. */
+declare function countBodyChars(node: TiptapNode | null | undefined): number;
+/**
+ * 사이트별 bounded 임계값 (ADR-0061 §5 content kind). seo-checks 는 KnowledgeKind 를
+ * 모르고(§4②) 평범한 숫자만 받는다 — content→thresholds 해석은 호출자(페이지)가.
+ * 필드명은 site-knowledge ContentPolicy 와 동일(구조적으로 그대로 전달 가능).
+ */
+interface SeoThresholds {
+    titleMaxLen: number;
+    descMaxLen: number;
+    bodyMinLen: number;
+}
+/** 기본값 = 한국어 SERP 기준 현행 상수. 미전달 시 동작 불변(하위호환). */
+declare const DEFAULT_SEO_THRESHOLDS: SeoThresholds;
+interface BusinessProfileCompleteness {
+    hasAddress: boolean;
+    hasTelephone: boolean;
+    hasOpeningHours: boolean;
+    hasGeo: boolean;
+}
+/**
+ * 비즈니스 프로필 완성도 체크 — `profile` 미전달(사이트 없음 등)이면 결과 자체를
+ * 내지 않는다(체크리스트 노이즈 방지, `checkNoindexCanonicalConflict` 와 동일 패턴).
+ */
+declare function checkBusinessProfile(profile: BusinessProfileCompleteness | undefined): SeoCheckResult | null;
+declare function runSeoChecks(input: SeoCheckInput, thresholds?: SeoThresholds): SeoCheckResult[];
+declare const SEO_SCORE_WEIGHTS: Readonly<Record<string, number>>;
+/**
+ * 가중합 0~100 점. 가중치가 정의된 id 만 합산(lexicon 등 확장 항목은 자동 제외).
+ * 결과 배열에 가중치 있는 항목이 하나도 없으면 0(평가 불가 상태를 0으로 fail-closed).
+ */
+declare function computeSeoScore(results: readonly SeoCheckResult[], weights?: Readonly<Record<string, number>>): number;
+interface ReadabilityThresholds {
+    /** 문장 평균 길이(공백 제외 글자 수) 상한. */
+    sentenceAvgMax: number;
+    /** 문장 최장 길이 상한. */
+    sentenceLongMax: number;
+    /** 문단 평균 길이 상한. */
+    paragraphAvgMax: number;
+    /** 소제목 사이(또는 첫 소제목 이전) 최대 글자 수 상한. */
+    headingDensityMax: number;
+    /** 이 글자 수 이상인데 목록이 없으면 권고. */
+    listRecommendBodyMin: number;
+}
+declare const DEFAULT_READABILITY_THRESHOLDS: ReadabilityThresholds;
+/** readability 4종 진입점 — 항목 순서 고정(문장→문단→밀도→목록). */
+declare function runReadabilityChecks(bodyJson: TiptapNode | null | undefined, thresholds?: ReadabilityThresholds): SeoCheckResult[];
+
+export { type BusinessProfileCompleteness, DEFAULT_READABILITY_THRESHOLDS, DEFAULT_SEO_THRESHOLDS, type ReadabilityThresholds, SEO_SCORE_WEIGHTS, type SeoCheckInput, type SeoCheckLevel, type SeoCheckResult, type SeoThresholds, type TiptapMark, type TiptapNode, checkBusinessProfile, collectNodes, computeSeoScore, countBodyChars, extractText, runReadabilityChecks, runSeoChecks, walkNodes };

package/dist/seo-checks.js

@@ -0,0 +1,27 @@
+import {
+  DEFAULT_READABILITY_THRESHOLDS,
+  DEFAULT_SEO_THRESHOLDS,
+  SEO_SCORE_WEIGHTS,
+  checkBusinessProfile,
+  collectNodes,
+  computeSeoScore,
+  countBodyChars,
+  extractText,
+  runReadabilityChecks,
+  runSeoChecks,
+  walkNodes
+} from "./chunk-6GQCFFHU.js";
+export {
+  DEFAULT_READABILITY_THRESHOLDS,
+  DEFAULT_SEO_THRESHOLDS,
+  SEO_SCORE_WEIGHTS,
+  checkBusinessProfile,
+  collectNodes,
+  computeSeoScore,
+  countBodyChars,
+  extractText,
+  runReadabilityChecks,
+  runSeoChecks,
+  walkNodes
+};
+//# sourceMappingURL=seo-checks.js.map

package/dist/seo-checks.js.map

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

package/dist/server.d.ts

@@ -2,7 +2,8 @@ import { ReactElement, ReactNode } from 'react';
 import { CmsPostContent, RootTaleTheme, CmsPostType } from '@roottale/cms-client/server';
 export { RootTaleTheme } from '@roottale/cms-client/server';
 import { Block, BindingResolver, RouteCollection } from '@roottale/cms-core';
-export { R as RootTaleCssVars, t as themeToCssVars } from './theme-css-vars-BiyHBsJG.js';
+export { R as RootTaleCssVars, t as themeToCssVars } from './theme-css-vars-CD3jcEkp.js';
+import '@roottale/ui-react/theme';
 
 /**
  * `<RootTalePostCard>` — server-only summary card for a single CmsPostContent.
@@ -74,6 +75,8 @@ declare function attachHeadingIds(doc: Record<string, unknown>, entries: TocEntr
 interface RootTaleTableOfContentsProps {
     entries: TocEntry[];
     title?: string;
+    /** 명시 `title` 없을 때 기본 제목의 locale. 미지정 = ko("목차"). */
+    locale?: string;
 }
 declare function RootTaleTableOfContents(props: RootTaleTableOfContentsProps): ReactElement | null;
 
@@ -116,10 +119,24 @@ declare function RootTaleFloatingCta(props: RootTaleFloatingCtaProps): ReactElem
  * PII 는 server 측에서 암호화 후 `inquiries` insert, 302 `?ok=1` / `?err=*` redirect.
  *
  * vertical prop:
- * - 미지정 = "분야 선택" select 노출 (consulting/medical/tax/legal)
+ * - 미지정 = "분야 선택" select 노출 (consulting/medical/tax/legal), 필드셋은
+ *   기존 B2B 세트 그대로(방문자가 vertical 을 스스로 고르는 범용 폼이라 필드를
+ *   vertical 별로 분기하지 않음)
  * - 지정   = hidden input + 표시 라벨 + vertical 별 추가 필드
  *   (medical = 국외이전 동의 — ADR-0018)
  *
+ * vertical="medical" 필드셋 (C5 1차, premium-component-backlog):
+ * 환자가 채우는 문의 폼에 B2B 리드 필드("사업체명" 필수·"현재 사이트 URL")를
+ * 노출하던 정합성 문제를 수정 — 의료는 이름·전화번호(필수) + 상담 희망
+ * 분야/증상·문의 내용(선택)만 노출한다. intake 계약(tenant-api `POST
+ * /v1/public/inquiries`, `packages/api-core/src/routes/inquiries.ts`)이
+ * `business_name` 을 vertical 불문 hard-required 로 검증하므로(신규 폼 백엔드
+ * 금지 — F3 계약 고정), 화면에는 안 보이지만 hidden input 으로 자리표시자
+ * `"-"` 를 전송해 계약을 만족시킨다. "상담 희망 분야/증상" 은 기존
+ * `consultation_field` 키(어드민 CRM "상담 분야" 표시)로, "문의 내용" 은 기존
+ * `message` 키로 매핑 — 둘 다 이미 intake 가 선택 필드로 수용하던 키라 서버
+ * 변경이 필요 없다. "현재 사이트 URL" 은 의료에 무의미해 필드 자체를 생략.
+ *
  * redirectPath prop:
  * - 외부 사이트가 폼 제출 후 돌아갈 path (API 가 allowlist 검증, ?ok=1 / ?err=*)
  *
@@ -274,6 +291,19 @@ type RootTaleBlogListProps = {
      * `fetchCollections()` 결과를 넘긴다(`collections.md` 참고).
      */
     collections?: readonly RouteCollection[];
+    /**
+     * **네거티브** 스코프 — `collections` 와 함께 주면 어느 스트림에도 안 속한
+     * ("미소속") 글만 렌더한다(`postsNotInAnyCollection`, `blog-list-collection-scope.md`
+     * §2①). `collection`(포지티브) 과 배타적이며 **동시 지정은 throw**. `collections`
+     * 없이 `excludeCollections` 만 주는 것도 **throw**(조용한 no-op 금지, fail-closed).
+     *
+     * **적용 조건 한정** — `/blog` 가 *선언 컬렉션이 아닌*(미소속 글이 `/blog` 를 받는)
+     * 사이트에서만 쓴다. **`blog` 자체가 선언 컬렉션인 사이트(예: kjmtax — 글의
+     * `collectionKey === "blog"`) 는 반대로 포지티브 `collection="blog"` 가 정경로다.**
+     * 그런 사이트에 `excludeCollections` 를 적용하면 블로그 글까지 전부 "소속 글"로
+     * 걸려 제외되므로 목록이 비게 된다 — 동시 지정 throw 로는 이 오적용을 못 잡는다.
+     */
+    excludeCollections?: boolean;
     /**
      * 카테고리 필터 칩을 목록 위에 렌더. SSR-only — 칩은 `<a>` 링크이고
      * `?category=<slug>` URL 파라미터로 동작한다(client JS 불요). consumer 는
@@ -301,6 +331,12 @@ type RootTaleBlogListProps = {
      * `<RootTaleThemeProvider>` 가 변수를 이미 설정한 경우 유용).
      */
     theme?: RootTaleThemeInput;
+    /**
+     * ADR-0052 A안 (W4-6 PR C1) — 언어판 필터(`fetchPosts` 의 `locale` 그대로 전달).
+     * 미지정 시 서버가 사이트 기본 locale 반환(하위호환). cms-i18n 기본 문자열
+     * (`emptyMessage`/`allCategoriesLabel` 미지정 시)의 locale 해석에도 쓰인다.
+     */
+    locale?: string;
 };
 declare function RootTaleBlogList(props: RootTaleBlogListProps): Promise<ReactElement>;
 type RootTaleBlogCategoriesProps = {
@@ -321,6 +357,8 @@ type RootTaleBlogCategoriesProps = {
     collections?: readonly RouteCollection[];
     /** See `RootTaleBlogListProps['theme']`. */
     theme?: RootTaleThemeInput;
+    /** See `RootTaleBlogListProps['locale']`. */
+    locale?: string;
 };
 declare function RootTaleBlogCategories(props: RootTaleBlogCategoriesProps): Promise<ReactElement>;
 type RootTaleBlogPostProps = {
@@ -348,8 +386,17 @@ type RootTaleBlogPostProps = {
     postHref?: (post: CmsPostContent) => string;
     /** 다중 스트림 라우팅(ADR-0060) — 관련 글 링크 해석에 사용. */
     collections?: readonly RouteCollection[];
+    /**
+     * W5-2 — 양식(필드 그룹) 스칼라 값을 연관 박스 아래 정보 패널로 렌더.
+     * 라벨·타입은 서버 동봉 `fieldsMeta` 를 사용 — 렌더러는 vertical 지식 없음.
+     * relationship 계열은 연관 박스가 담당하므로 제외. 표시할 값이 하나도 없으면
+     * 패널 자체 미렌더(빈 껍데기 금지). 기본 false — 기존 소비자 마크업 불변.
+     */
+    showFieldFacts?: boolean;
     /** See `RootTaleBlogListProps['theme']`. */
     theme?: RootTaleThemeInput;
+    /** See `RootTaleBlogListProps['locale']`. `fetchPost`/관련 글 fetch 양쪽에 적용. */
+    locale?: string;
 };
 declare function RootTaleBlogPost(props: RootTaleBlogPostProps): Promise<ReactElement>;
 declare function RootTaleFaqJsonLd({ doc, }: {
@@ -369,6 +416,8 @@ type RootTalePageProps = {
     showTitle?: boolean;
     /** See `RootTaleBlogListProps['theme']`. */
     theme?: RootTaleThemeInput;
+    /** See `RootTaleBlogListProps['locale']`. */
+    locale?: string;
 };
 /**
  * 고정 페이지(posts type='page') 렌더러 — RootTaleBlogPost 의 경량판.

package/dist/server.js

@@ -17,14 +17,20 @@ import {
   renderBlocks,
   renderBoundBlocks,
   themeToCssVars
-} from "./chunk-GOHP7RWD.js";
+} from "./chunk-RSNUZ4BF.js";
+import "./chunk-U5AKACPN.js";
+import "./chunk-4LQPZDXZ.js";
+import "./chunk-K62RR4UQ.js";
+import "./chunk-H46JUIHZ.js";
+import "./chunk-WWS43XCT.js";
 import {
   collectCategories,
   collectCategoriesWithCounts,
   defaultCategoryHref,
   filterPostsByCategory
 } from "./chunk-FUA5H6JE.js";
-import "./chunk-IOYBEH6E.js";
+import "./chunk-NUUTTSGT.js";
+import "./chunk-F3G6RVIR.js";
 export {
   RenderTiptap,
   RootTaleBlogCategories,