@cliff-format/i18n 0.0.0-stage → 0.2.0

package/dist/vocabulary-u-i15yFj.d.cts

@@ -0,0 +1,135 @@
+import { p as IcuDialect, o as IcuAnalysis, b as IcuRuntime, n as I18nRuntime, O as TranslationScope, j as EntryIdInput, P as Params, Q as TypeTag, h as EmotionTag, K as StatusTag, v as MessagePart, u as MessageMetadata, g as CommitOptions, T as TFunction, U as VariantTag } from './types-CtbwKSot.cjs';
+import { CliffEntry } from '@cliff-format/core';
+
+declare function detectDialect(message: string): IcuDialect;
+declare function argumentNames(message: string, dialect: IcuDialect): string[];
+declare function analyzePlain(message: string, dialect: IcuDialect, errors?: IcuAnalysis["errors"]): IcuAnalysis;
+
+declare function createLiteIcu(): IcuRuntime;
+
+declare class MessageBuilderImpl {
+    private readonly i18n;
+    private readonly scope;
+    private readonly entryIdInput;
+    private sourceText;
+    private sourceParams;
+    private targetText;
+    private targetParams;
+    private extraParams;
+    private typeTag;
+    private inheritType;
+    private emotionTags;
+    private statusTag;
+    private contextText;
+    private maxWidthCells;
+    private referencePaths;
+    private reviewerName;
+    private extensionMap;
+    private localeOverride;
+    constructor(i18n: I18nRuntime, scope: TranslationScope, entryIdInput: EntryIdInput);
+    source(text: string, params?: Params): MessageBuilderImpl;
+    type(tag: TypeTag): MessageBuilderImpl;
+    typeFromGroup(): MessageBuilderImpl;
+    emotion(...tags: readonly (EmotionTag | readonly EmotionTag[])[]): MessageBuilderImpl;
+    context(text: string): MessageBuilderImpl;
+    maxWidth(cells: number): MessageBuilderImpl;
+    reference(...paths: string[]): MessageBuilderImpl;
+    reviewer(name: string): MessageBuilderImpl;
+    extension(name: string, value: string): MessageBuilderImpl;
+    target(text: string, params?: Params): MessageBuilderImpl;
+    status(tag: StatusTag): MessageBuilderImpl;
+    locale(tag: string): MessageBuilderImpl;
+    params(params: Params): MessageBuilderImpl;
+    count(value: number): MessageBuilderImpl;
+    private activeLocale;
+    private resolved;
+    private recordFor;
+    private mergedParams;
+    private diagnose;
+    private requireEffectiveType;
+    private ensureAuthoringMetadata;
+    private groupEmotion;
+    private requireEmotionIfConfigured;
+    private createDraft;
+    private checkWidth;
+    private renderRecord;
+    private expectationDiagnostics;
+    private missing;
+    render(params?: Params): string;
+    renderToParts(params?: Params): MessagePart[];
+    meta(): MessageMetadata;
+    entry(): CliffEntry | undefined;
+    commit(options?: CommitOptions): MessageBuilderImpl;
+    private applyOverwrite;
+    private validateDocument;
+    width(params?: Params): number;
+    fits(params?: Params): boolean;
+    toString(): string;
+}
+declare function createT<EntryIds extends string = string>(i18n: I18nRuntime, scope: TranslationScope): TFunction<EntryIds>;
+
+declare class CliffI18nError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+declare class CliffScopeError extends CliffI18nError {
+    readonly scope: Partial<TranslationScope>;
+    constructor(message: string, scope?: Partial<TranslationScope>);
+}
+declare class CliffScopeMismatchError extends CliffScopeError {
+    readonly entryId: string;
+    constructor(entryId: string, scope: TranslationScope, expected: string);
+}
+declare class CliffMissingEntryError extends CliffI18nError {
+    readonly entryId: string;
+    readonly locale: string;
+    constructor(entryId: string, locale: string);
+}
+declare class CliffAmbiguousEntryError extends CliffI18nError {
+    readonly entryId: string;
+    readonly candidates: readonly string[];
+    constructor(entryId: string, candidates: readonly string[]);
+}
+declare class CliffDuplicateEntryError extends CliffI18nError {
+    readonly entryId: string;
+    readonly locale: string;
+    constructor(entryId: string, locale: string);
+}
+declare class CliffMissingMetadataError extends CliffI18nError {
+    readonly entryId: string;
+    readonly fields: readonly string[];
+    constructor(entryId: string, fields: readonly string[], detail?: string);
+}
+declare class CliffIcuError extends CliffI18nError {
+    readonly messageText: string;
+    constructor(messageText: string, detail: string);
+}
+
+declare const STATUS_TRANSITIONS: Record<StatusTag, readonly StatusTag[]>;
+declare function statusOf(entry: CliffEntry): StatusTag;
+declare function canTransitionStatus(from: StatusTag, to: StatusTag): boolean;
+interface StatusContext {
+    source?: string;
+    target?: string;
+    explicit?: StatusTag;
+}
+/**
+ * Return the status a write should leave on an entry.
+ * An explicit status wins. Otherwise a missing target is initial, and a changed
+ * source or reworked reviewed/final target returns to translated.
+ */
+declare function reconcileEntryStatus(entry: CliffEntry, previous?: StatusContext): StatusTag;
+declare function nextStatuses(status: StatusTag): readonly StatusTag[];
+declare function statusOrder(): readonly StatusTag[];
+
+declare function isTypeTag(value: string): value is TypeTag;
+declare function isEmotionTag(value: string): value is EmotionTag;
+declare function isStatusTag(value: string): value is StatusTag;
+declare function isVariantTag(value: string): value is VariantTag;
+declare function assertTypeTag(value: string): TypeTag;
+declare function assertEmotionTag(value: string): EmotionTag;
+declare function assertStatusTag(value: string): StatusTag;
+declare function assertVariantTag(value: string): VariantTag;
+
+export { CliffAmbiguousEntryError as C, MessageBuilderImpl as M, STATUS_TRANSITIONS as S, CliffDuplicateEntryError as a, CliffI18nError as b, CliffIcuError as c, CliffMissingEntryError as d, CliffMissingMetadataError as e, CliffScopeError as f, CliffScopeMismatchError as g, type StatusContext as h, analyzePlain as i, argumentNames as j, assertEmotionTag as k, assertStatusTag as l, assertTypeTag as m, assertVariantTag as n, canTransitionStatus as o, createLiteIcu as p, createT as q, detectDialect as r, isEmotionTag as s, isStatusTag as t, isTypeTag as u, isVariantTag as v, nextStatuses as w, reconcileEntryStatus as x, statusOf as y, statusOrder as z };

package/package.json

@@ -1,6 +1,119 @@
 {
   "name": "@cliff-format/i18n",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "CLIFF-native runtime localization, authoring and ICU formatting",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.12"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./lite": {
+      "browser": {
+        "types": "./dist/lite.d.ts",
+        "default": "./dist/lite.js"
+      },
+      "import": {
+        "types": "./dist/lite.d.ts",
+        "default": "./dist/lite.js"
+      },
+      "require": {
+        "types": "./dist/lite.d.cts",
+        "default": "./dist/lite.cjs"
+      }
+    },
+    "./react": {
+      "browser": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lite": [
+        "dist/lite.d.ts"
+      ],
+      "react": [
+        "dist/react.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@messageformat/icu-messageformat-1": "^0.13.0",
+    "messageformat": "^4.1.0"
+  },
+  "peerDependencies": {
+    "@cliff-format/core": "^0.2.0",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@cliff-format/core": "workspace:*",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@types/react-dom": "^19.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cliff-format/cliff-js.git",
+    "directory": "packages/i18n"
+  },
+  "keywords": [
+    "cliff",
+    "i18n",
+    "l10n",
+    "localization",
+    "icu",
+    "messageformat",
+    "react"
+  ],
+  "homepage": "https://github.com/cliff-format/cliff-js#readme",
+  "bugs": {
+    "url": "https://github.com/cliff-format/cliff-js/issues"
+  }
+}