@ryusenkei/legal 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RYUSENKEI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @ryusenkei/legal
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Builds a privacy policy, a notice under Japan's Act on Specified Commercial Transactions (`特定商取引法に基づく表記`), and the operator details for a footer from a short declaration. The output is structured data (articles, paragraphs, lists, tables) in Japanese; rendering is yours.
+
+> The standard wording is a starting point, not legal advice. Have it reviewed before you publish.
+
+## Install
+
+```sh
+pnpm add @ryusenkei/legal
+```
+
+## Operator
+
+```ts
+import type { Operator } from '@ryusenkei/legal';
+
+const operator: Operator = {
+  name: 'Example',
+  url: 'https://www.example.com/',
+  status: 'registered', // or 'preparing'
+  legalName: { disclosure: 'on_request' },
+  address: { disclosure: 'on_request' },
+  representative: { disclosure: 'public', value: '...' },
+  email: 'hi@example.com',
+};
+```
+
+- Each detail is either `public` with a value, or `on_request` without one; the latter is shown as `ご請求があれば、遅滞なくお知らせします` (disclosed on request). Because an `on_request` detail carries no value, the declaration can live in a public repository without a personal name.
+- `operatorRows(operator)` gives the table rows. `copyrightLine(operator, year)` gives the footer line.
+
+## Privacy policy
+
+Declare what you collect and which services see it:
+
+```ts
+import { privacyPolicy, retentionDaysOf } from '@ryusenkei/legal';
+
+const declaration = {
+  subject: 'Example のウェブサイト',
+  operator,
+  enactedOn: '2026-11-07', // null while drafting
+  collected: [{ name: 'お問い合わせの内容', method: 'お問い合わせのフォーム', purposes: ['お問い合わせへの対応'], retention: { days: 365 } }],
+  services: [{ name: 'Turnstile', provider: 'Cloudflare, Inc.', country: '米国', role: 'transmission', purpose: '不正な送信の防止', items: ['端末と操作の情報'] }],
+  cookies: { analytics: [] },
+} satisfies PrivacyDeclaration;
+
+const doc = privacyPolicy(declaration);
+const retentionDays = retentionDaysOf(declaration, 'お問い合わせの内容'); // 365, for the deletion job
+```
+
+What the declaration drives:
+
+| Declared | Generated |
+| --- | --- |
+| `collected` | The items with their method and purposes, and a retention article (`{ days }`, or `{ until: 'request' }`). Multiples of 365 days are written in years |
+| `services` with `role: 'processor'` | An outsourcing (`委託`) article |
+| `services` with `role: 'transmission'` | What is sent, to whom, and why (external transmission from the user's device) |
+| any service outside 日本 | An article on provision to third parties in foreign countries, and a security-measure line about understanding those countries' rules |
+| `cookies` | The purposes and services that use cookies, or a statement that no cookies or external analytics are used |
+| `revisions` | `revisedOn` (the latest) and the history |
+
+The standard articles (disclosure, correction and suspension, security measures, contact with the operator table, changes) are always included.
+
+Drafting:
+
+- With `enactedOn: null`, undecided items are allowed and listed in `doc.missing`: the operator's legal name, address, and representative; retention periods; service countries.
+- Setting `enactedOn` while anything is still missing throws `LegalDeclarationError`.
+
+Keep the retention in the declaration and read it with `retentionDaysOf` in the deletion job, so the policy text and the actual deletion never disagree.
+
+## 特定商取引法に基づく表記
+
+```ts
+import { tokushoNotice } from '@ryusenkei/legal';
+
+const notice = tokushoNotice({
+  operator: { ...operator, phone: { disclosure: 'on_request' } },
+  finalConfirmationScreen: false,
+  price: { disclosure: 'on_request' },
+  extraFees: '...', paymentMethods: ['クレジットカード'], paymentTiming: '...', delivery: '...', returns: '...',
+  updatedOn: '2026-11-07',
+});
+```
+
+- When any detail is `on_request`, the notice ends with a `表示の省略について` (omitted items) row. Omission relies on the proviso of Article 11.
+- With `finalConfirmationScreen: true`, the site has a final order-confirmation screen, so Article 12-6 requires every item to be shown:
+  - `price` must be `public` (enforced by the type).
+  - An `on_request` seller name, address, or phone throws `LegalDeclarationError`.
+- A missing seller name, address, phone, or price also throws.
+
+Terms of use are not generated; they differ too much between products.
+
+## License
+
+MIT

package/dist/document.d.ts

@@ -0,0 +1,49 @@
+/** 段落の部品（文字列と、メールアドレス・URL のリンク） */
+export type Inline = string | Readonly<{
+    email: string;
+}> | Readonly<{
+    url: string;
+    text: string;
+}>;
+/** 段落（文字列か、部品の列） */
+export type Paragraph = string | readonly Inline[];
+/** 表の行（運営者の表など） */
+export type Row = Readonly<{
+    label: string;
+    value: Paragraph;
+}>;
+/**
+ * 条。番号の付け方と記号は描画の側が決める
+ * - `items`: 番号付きの列挙、`bullets`: 番号なしの列挙、`after`: 列挙の後の段落
+ */
+export type Article = Readonly<{
+    title: string;
+    paragraphs: readonly Paragraph[];
+    items?: readonly Paragraph[];
+    bullets?: readonly Paragraph[];
+    after?: readonly Paragraph[];
+    table?: readonly Row[];
+}>;
+export type Revision = Readonly<{
+    date: string;
+    note?: string;
+}>;
+/**
+ * 組み立てた文書（見た目は持たない）
+ * - `missing`: 下書きの間に未定のままの項目（制定の前に埋める）
+ */
+export type LegalDocument = Readonly<{
+    title: string;
+    intro: readonly Paragraph[];
+    articles: readonly Article[];
+    enactedOn: string | null;
+    revisedOn: string | undefined;
+    revisions: readonly Revision[];
+    missing: readonly string[];
+}>;
+/** 宣言の誤り（制定したのに未定の項目がある、特商法で省略できない項目を省略した、など） */
+export declare class LegalDeclarationError extends Error {
+    readonly name = "LegalDeclarationError";
+    readonly problems: readonly string[];
+    constructor(message: string, problems: readonly string[]);
+}

package/dist/document.js

@@ -0,0 +1,9 @@
+/** 宣言の誤り（制定したのに未定の項目がある、特商法で省略できない項目を省略した、など） */
+export class LegalDeclarationError extends Error {
+    name = 'LegalDeclarationError';
+    problems;
+    constructor(message, problems) {
+        super(`${message}: ${problems.join('、')}`);
+        this.problems = problems;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { LegalDeclarationError, type Article, type Inline, type LegalDocument, type Paragraph, type Revision, type Row } from './document.ts';
+export { copyrightLine, ON_REQUEST_TEXT, operatorRows, type Disclosure, type Operator } from './operator.ts';
+export { privacyPolicy, retentionDaysOf, retentionText, type CollectedItem, type ExternalService, type PrivacyDeclaration, type Retention } from './privacy.ts';
+export { tokushoNotice, type TokushoDeclaration, type TokushoNotice } from './tokusho.ts';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { LegalDeclarationError } from "./document.js";
+export { copyrightLine, ON_REQUEST_TEXT, operatorRows } from "./operator.js";
+export { privacyPolicy, retentionDaysOf, retentionText } from "./privacy.js";
+export { tokushoNotice } from "./tokusho.js";

package/dist/operator.d.ts

@@ -0,0 +1,36 @@
+import type { Row } from './document.ts';
+/**
+ * 運営者の項目の公開の仕方
+ * - `public`: 値を表示する
+ * - `on_request`: 表示せず、請求があれば知らせる。値を持たないので、公開のリポにも置ける
+ */
+export type Disclosure = Readonly<{
+    disclosure: 'public';
+    value: string;
+}> | Readonly<{
+    disclosure: 'on_request';
+}>;
+/** 運営者（会社の値。platform の `company` から渡す） */
+export type Operator = Readonly<{
+    /** 表示名（屋号、サービス名） */
+    name: string;
+    url?: string;
+    /** 登記の状態。設立の準備中は正式な名称の代わりに「設立準備中」と出す */
+    status: 'registered' | 'preparing';
+    /** 正式な名称（商号）。未定なら下書きの間だけ省略できる */
+    legalName?: Disclosure;
+    representative?: Disclosure;
+    address?: Disclosure;
+    phone?: Disclosure;
+    /** 窓口のメールアドレス（公開） */
+    email: string;
+}>;
+export declare const ON_REQUEST_TEXT = "\u3054\u8ACB\u6C42\u304C\u3042\u308C\u3070\u3001\u9045\u6EDE\u306A\u304F\u304A\u77E5\u3089\u305B\u3057\u307E\u3059";
+export declare const isOnRequest: (d: Disclosure | undefined) => boolean;
+/**
+ * 運営者の表の行（プライバシーポリシーの窓口、会社の情報の欄）
+ * - 未定の項目は行を出さない
+ */
+export declare function operatorRows(operator: Operator): Row[];
+/** フッターの著作権の表示 */
+export declare const copyrightLine: (operator: Operator, year: number) => string;

package/dist/operator.js

@@ -0,0 +1,24 @@
+export const ON_REQUEST_TEXT = 'ご請求があれば、遅滞なくお知らせします';
+export const isOnRequest = (d) => d?.disclosure === 'on_request';
+const show = (d) => (d.disclosure === 'public' ? d.value : ON_REQUEST_TEXT);
+/**
+ * 運営者の表の行（プライバシーポリシーの窓口、会社の情報の欄）
+ * - 未定の項目は行を出さない
+ */
+export function operatorRows(operator) {
+    const rows = [{ label: '運営', value: operator.url ? [{ url: operator.url, text: operator.name }] : operator.name }];
+    if (operator.legalName)
+        rows.push({ label: '名称', value: show(operator.legalName) });
+    else if (operator.status === 'preparing')
+        rows.push({ label: '名称', value: '設立準備中' });
+    if (operator.address)
+        rows.push({ label: '所在地', value: show(operator.address) });
+    if (operator.representative)
+        rows.push({ label: '代表者', value: show(operator.representative) });
+    if (operator.phone)
+        rows.push({ label: '電話番号', value: show(operator.phone) });
+    rows.push({ label: '窓口', value: [{ email: operator.email }] });
+    return rows;
+}
+/** フッターの著作権の表示 */
+export const copyrightLine = (operator, year) => `© ${year} ${operator.name}`;

package/dist/privacy.d.ts

@@ -0,0 +1,62 @@
+import { type LegalDocument, type Revision } from './document.ts';
+import { type Operator } from './operator.ts';
+/** 保管期間。日数は削除の処理からも `retentionDaysOf` で参照する */
+export type Retention = Readonly<{
+    days: number;
+}> | Readonly<{
+    until: 'request';
+}>;
+/** 集める情報 */
+export type CollectedItem = Readonly<{
+    /** 情報の名前（例: 「お問い合わせの内容」） */
+    name: string;
+    /** 取得の方法（例: 「お問い合わせのフォーム」） */
+    method: string;
+    purposes: readonly string[];
+    /** 未定なら下書きの間だけ省略できる */
+    retention?: Retention;
+}>;
+/**
+ * 外部のサービス
+ * - `processor`: 取扱いの委託（サーバー、メールの配信など）
+ * - `transmission`: 利用者の端末から外部へ送られる情報（解析、広告、bot の判定などのタグ）
+ */
+export type ExternalService = Readonly<{
+    name: string;
+    provider: string;
+    /** 事業者の国（例: 「米国」）。日本以外なら外国にある第三者への提供の条文を出す。未定なら下書きの間だけ省略できる */
+    country?: string;
+    role: 'processor' | 'transmission';
+    purpose: string;
+    /** 扱う、または送られる情報 */
+    items: readonly string[];
+}>;
+export type PrivacyDeclaration = Readonly<{
+    /** 対象（例: 「〇〇のウェブサイト」） */
+    subject: string;
+    /** 対象の呼び方（既定は「当サイト」） */
+    subjectShort?: string;
+    operator: Operator;
+    /** 制定日（YYYY-MM-DD）。`null` は下書きで、未定の項目を `missing` に出す */
+    enactedOn: string | null;
+    /** 改定の履歴（新しい順） */
+    revisions?: readonly Revision[];
+    collected: readonly CollectedItem[];
+    services?: readonly ExternalService[];
+    /** Cookie を使う目的ごとのサービス名。どれもなければ「使用していません」と出す */
+    cookies?: Readonly<{
+        analytics?: readonly string[];
+        advertising?: readonly string[];
+        affiliate?: readonly string[];
+    }>;
+}>;
+/** 保管期間の表示（365日の倍数は年、それ以外は日） */
+export declare function retentionText(retention: Retention): string;
+/** 削除の処理が参照する保管期間（日）。日数でない、または未定なら `undefined` */
+export declare function retentionDaysOf(declaration: Pick<PrivacyDeclaration, 'collected'>, name: string): number | undefined;
+/**
+ * プライバシーポリシーを組み立てる
+ * - 外部のサービスに日本以外の国があれば、外国にある第三者への提供の条文と、安全管理措置の外的環境の把握を出す
+ * - 制定日があるのに未定の項目が残っていれば `LegalDeclarationError`
+ */
+export declare function privacyPolicy(d: PrivacyDeclaration): LegalDocument;

package/dist/privacy.js

@@ -0,0 +1,137 @@
+// プライバシーポリシーを宣言から組み立てる（日本語、敬体、前文と第 N 条の形）
+// 定型の文面は公開の前に人が確認する（文面の正しさは、このパッケージでは保証しない）
+import { LegalDeclarationError } from "./document.js";
+import { operatorRows } from "./operator.js";
+const JAPAN = '日本';
+/** 保管期間の表示（365日の倍数は年、それ以外は日） */
+export function retentionText(retention) {
+    if ('until' in retention)
+        return '利用者からの削除のお申し出まで';
+    const { days } = retention;
+    return days % 365 === 0 ? `${days / 365}年間` : `${days}日間`;
+}
+/** 削除の処理が参照する保管期間（日）。日数でない、または未定なら `undefined` */
+export function retentionDaysOf(declaration, name) {
+    const retention = declaration.collected.find((c) => c.name === name)?.retention;
+    return retention && 'days' in retention ? retention.days : undefined;
+}
+function missingOf(d) {
+    const missing = [];
+    if (!d.operator.legalName && d.operator.status === 'registered')
+        missing.push('operator.legalName');
+    if (!d.operator.address)
+        missing.push('operator.address');
+    if (!d.operator.representative)
+        missing.push('operator.representative');
+    d.collected.forEach((c, i) => void (!c.retention && missing.push(`collected.${i}.retention`)));
+    (d.services ?? []).forEach((s, i) => void (!s.country && missing.push(`services.${i}.country`)));
+    return missing;
+}
+/**
+ * プライバシーポリシーを組み立てる
+ * - 外部のサービスに日本以外の国があれば、外国にある第三者への提供の条文と、安全管理措置の外的環境の把握を出す
+ * - 制定日があるのに未定の項目が残っていれば `LegalDeclarationError`
+ */
+export function privacyPolicy(d) {
+    const missing = missingOf(d);
+    if (d.enactedOn && missing.length)
+        throw new LegalDeclarationError('制定したプライバシーポリシーに未定の項目がある', missing);
+    const site = d.subjectShort ?? '当サイト';
+    const services = d.services ?? [];
+    const processors = services.filter((s) => s.role === 'processor');
+    const transmissions = services.filter((s) => s.role === 'transmission');
+    const foreign = services.filter((s) => s.country && s.country !== JAPAN);
+    const countries = [...new Set(foreign.map((s) => s.country))];
+    const cookieUses = Object.entries({ アクセスの解析: d.cookies?.analytics, 広告の配信: d.cookies?.advertising, アフィリエイトの成果の計測: d.cookies?.affiliate }).filter(([, names]) => names?.length);
+    const at = (s) => `${s.provider}${s.country ? `（${s.country}）` : ''}`;
+    const articles = [
+        {
+            title: '取得する情報と利用目的',
+            paragraphs: [`当社は、${site}で以下の情報を取得し、それぞれの目的で利用します。`],
+            bullets: d.collected.map((c) => `${c.name}（${c.method}）: ${c.purposes.join('、')}`),
+            after: ['当社は、利用者の同意を得ることなく、上記の目的の範囲を超えて個人情報等を利用しません。'],
+        },
+        {
+            title: '保管期間',
+            paragraphs: ['当社は、取得した情報を以下の期間保管し、期間を過ぎた情報は遅滞なく消去します。'],
+            bullets: d.collected.map((c) => `${c.name}: ${c.retention ? retentionText(c.retention) : '（未定）'}`),
+        },
+        cookieUses.length || transmissions.length
+            ? {
+                title: 'Cookie と外部への情報の送信',
+                paragraphs: [
+                    ...(cookieUses.length ? [`${site}は、以下の目的で Cookie を使用します。利用者は、ブラウザーの設定で Cookie を無効にできます。`] : [`${site}は、Cookie を使用していません。`]),
+                ],
+                ...(cookieUses.length && { bullets: cookieUses.map(([use, names]) => `${use}: ${names.join('、')}`) }),
+                ...(transmissions.length && {
+                    after: [`${site}は、以下のサービスのために、利用者の端末から外部へ情報を送信します。`, ...transmissions.map((s) => `${s.name}（送信先: ${at(s)}）: ${s.items.join('、')}を、${s.purpose}のために送信します。`)],
+                }),
+            }
+            : { title: 'Cookie と外部への情報の送信', paragraphs: [`${site}は、Cookie を使用していません。また、アクセスの解析や広告のために、外部のサービスへ利用者の情報を送信していません。`] },
+        {
+            title: '個人情報等の第三者提供',
+            paragraphs: ['当社は、以下の場合を除き、あらかじめ利用者の同意を得ることなく、個人情報等を第三者に提供しません。'],
+            items: [
+                '利用目的の達成に必要な範囲で、個人情報等の取扱いの全部または一部を委託する場合',
+                '合併その他の事由による事業の承継に伴って個人情報等が提供される場合',
+                '国の機関もしくは地方公共団体またはその委託を受けた者が法令の定める事務を遂行することに対して協力する必要がある場合であって、利用者の同意を得ることにより当該事務の遂行に支障を及ぼすおそれがあるとき',
+                'その他、法令で認められる場合',
+            ],
+        },
+        ...(processors.length
+            ? [{ title: '取扱いの委託', paragraphs: ['当社は、利用目的の達成に必要な範囲で、以下の事業者に個人情報等の取扱いを委託し、委託先を適切に監督します。'], bullets: processors.map((s) => `${at(s)}: ${s.purpose}（${s.items.join('、')}）`) }]
+            : []),
+        ...(foreign.length
+            ? [
+                {
+                    title: '外国にある第三者への提供',
+                    paragraphs: [
+                        `当社は、${[...new Set(foreign.map((s) => `${s.country}の ${s.provider}`))].join('、')} に個人情報等の取扱いを委託し、または個人情報等を提供します。この場合、法令に従い、当該国の個人情報の保護に関する制度を把握した上で、必要な措置を講じます。講じている措置の内容は、ご請求があれば遅滞なくお知らせします。`,
+                    ],
+                },
+            ]
+            : []),
+        {
+            title: '個人情報等の開示',
+            paragraphs: ['当社は、利用者から個人情報の保護に関する法律の定めに基づき個人情報等の開示を求められたときは、利用者ご本人からのご請求であることを確認の上で、遅滞なく開示します（開示すべき個人情報等が存在しないときは、その旨を通知します）。ただし、法令により開示の義務を負わない場合は、この限りではありません。'],
+        },
+        {
+            title: '個人情報等の訂正及び利用停止等',
+            paragraphs: [
+                '当社は、利用者から、個人情報等が真実でないという理由によって訂正を求められた場合、または利用目的の範囲を超えて取り扱われているという理由もしくは不正の手段により取得されたという理由によって利用の停止もしくは消去を求められた場合には、利用者ご本人からのご請求であることを確認の上で遅滞なく必要な調査を行い、その結果に基づき、訂正、利用の停止または消去を行い、その旨を利用者に通知します。',
+                '前項の規定は、法令により当社が訂正、利用の停止または消去の義務を負わない場合は、適用しません。',
+            ],
+        },
+        {
+            title: '安全管理措置の実施',
+            paragraphs: ['当社は、個人情報等の漏えい、滅失または毀損の防止のため、以下の措置を講じます。'],
+            bullets: [
+                '個人情報等の取扱いの責任者の設置と、取扱いの状況の定期的な点検',
+                '個人情報等を取り扱う者への秘密の保持の義務づけ',
+                '個人情報等を扱う権限の限定と、アクセスの制御',
+                '通信の暗号化',
+                '委託先との秘密の保持に関する取り決めと、委託先の監督',
+                ...(countries.length ? [`外国（${countries.join('、')}）で個人情報等を取り扱う場合の、当該国の個人情報の保護に関する制度の把握`] : []),
+            ],
+        },
+        {
+            title: 'お問い合わせ先',
+            paragraphs: [['本ポリシーに関するご意見、ご質問、個人情報等の取扱いに関するお問い合わせは、', { email: d.operator.email }, 'までご連絡ください。']],
+            table: operatorRows(d.operator),
+        },
+        {
+            title: 'プライバシーポリシーの変更手続',
+            paragraphs: [`当社は、本ポリシーの内容を適宜見直し、その改善に努めます。本ポリシーは、法令に別段の定めがある場合を除き、変更することができます。変更後の本ポリシーは、${site}に掲載した時から効力を生じます。`],
+        },
+    ];
+    const revisions = d.revisions ?? [];
+    return {
+        title: 'プライバシーポリシー',
+        intro: [`当社は、${d.subject}（以下「${site}」といいます。）の運営にあたり取得した利用者の個人情報等の取扱いについて、以下のとおりプライバシーポリシー（以下「本ポリシー」といいます。）を定めます。`],
+        articles,
+        enactedOn: d.enactedOn,
+        revisedOn: revisions[0]?.date,
+        revisions,
+        missing,
+    };
+}

package/dist/tokusho.d.ts

@@ -0,0 +1,47 @@
+import { type Row } from './document.ts';
+import { type Disclosure, type Operator } from './operator.ts';
+type Common = Readonly<{
+    operator: Operator;
+    /** 運営の責任者（任意） */
+    responsiblePerson?: Disclosure;
+    /** 商品代金以外の必要料金 */
+    extraFees: string;
+    paymentMethods: readonly string[];
+    paymentTiming: string;
+    /** 商品の引渡し、サービスの提供の時期 */
+    delivery: string;
+    /** 返品・キャンセル */
+    returns: string;
+    installments?: string;
+    /** 動作環境（ソフトウェア、デジタルの商品） */
+    environment?: string;
+    /** 最終の更新日（YYYY-MM-DD） */
+    updatedOn: string;
+}>;
+/**
+ * 特商法の表記の宣言
+ * - `finalConfirmationScreen: true`（サイトに申込の最終確認画面がある）なら、価格は公開が必須（型で防ぐ）。販売業者の項目は実行時に検査する
+ */
+export type TokushoDeclaration = (Common & Readonly<{
+    finalConfirmationScreen: true;
+    price: Readonly<{
+        disclosure: 'public';
+        value: string;
+    }>;
+}>) | (Common & Readonly<{
+    finalConfirmationScreen: false;
+    price: Disclosure;
+}>);
+export type TokushoNotice = Readonly<{
+    title: string;
+    rows: readonly Row[];
+    updatedOn: string;
+    omitted: boolean;
+}>;
+/**
+ * 特商法の表記を組み立てる
+ * - 「請求があれば開示」の項目が1つでもあれば、「表示の省略について」の行を最後に足す
+ * - 最終確認画面があるのに省略した項目があれば `LegalDeclarationError`
+ */
+export declare function tokushoNotice(d: TokushoDeclaration): TokushoNotice;
+export {};

package/dist/tokusho.js

@@ -0,0 +1,48 @@
+// 特定商取引法に基づく表記を宣言から組み立てる
+// 省略（請求があれば開示）は11条ただし書による。申込の最終確認画面を持つと12条の6で全項目の表示が要るので、省略を使えない
+// 定型の文面は公開の前に人が確認する（文面の正しさは、このパッケージでは保証しない）
+import { LegalDeclarationError } from "./document.js";
+import { isOnRequest, ON_REQUEST_TEXT } from "./operator.js";
+const show = (d) => (d.disclosure === 'public' ? d.value : ON_REQUEST_TEXT);
+/**
+ * 特商法の表記を組み立てる
+ * - 「請求があれば開示」の項目が1つでもあれば、「表示の省略について」の行を最後に足す
+ * - 最終確認画面があるのに省略した項目があれば `LegalDeclarationError`
+ */
+export function tokushoNotice(d) {
+    const o = d.operator;
+    // 販売業者は正式な名称（個人の事業なら氏名）。請求開示にもできる
+    const seller = o.legalName;
+    const fields = [
+        ['販売業者', seller],
+        ['所在地', o.address],
+        ['電話番号', o.phone],
+        ['運営責任者', d.responsiblePerson],
+        ['販売価格', d.price],
+    ];
+    const missing = fields.filter(([label, v]) => !v && label !== '運営責任者').map(([label]) => label);
+    if (missing.length)
+        throw new LegalDeclarationError('特商法の表記に必要な項目がない', missing);
+    const omittedLabels = fields.filter(([, v]) => isOnRequest(v)).map(([label]) => label);
+    if (d.finalConfirmationScreen && omittedLabels.length)
+        throw new LegalDeclarationError('申込の最終確認画面があると省略できない（12条の6）', omittedLabels);
+    const rows = [
+        { label: '販売業者', value: `${o.name}\n${show(seller)}` },
+        { label: '所在地', value: show(o.address) },
+        { label: '電話番号', value: show(o.phone) },
+        ...(d.responsiblePerson ? [{ label: '運営責任者', value: show(d.responsiblePerson) }] : []),
+        { label: 'メールアドレス', value: [{ email: o.email }] },
+        { label: '販売価格', value: show(d.price) },
+        { label: '商品代金以外の必要料金', value: d.extraFees },
+        { label: '支払方法', value: d.paymentMethods.join('\n') },
+        ...(d.installments ? [{ label: '分割払い', value: d.installments }] : []),
+        { label: '支払時期', value: d.paymentTiming },
+        { label: '引渡し・提供の時期', value: d.delivery },
+        { label: '返品・キャンセル', value: d.returns },
+        ...(d.environment ? [{ label: '動作環境', value: d.environment }] : []),
+    ];
+    const omitted = omittedLabels.length > 0;
+    if (omitted)
+        rows.push({ label: '表示の省略について', value: '本表記に記載のない事項、および「ご請求があれば、遅滞なくお知らせします」とした事項は、ご請求があれば、お申し込みのご判断に先立って遅滞なく、書面または電子メールで提供します。' });
+    return { title: '特定商取引法に基づく表記', rows, updatedOn: d.updatedOn, omitted };
+}

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@ryusenkei/legal",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "法務の本文（プライバシーポリシー、特定商取引法の表記、運営者の表示）を宣言から組み立てる",
+  "license": "MIT",
+  "author": "RYUSENKEI",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryusenkei-inc/toolkit.git",
+    "directory": "packages/runtime/legal"
+  },
+  "homepage": "https://github.com/ryusenkei-inc/toolkit/tree/main/packages/runtime/legal",
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
 }