cnice

Formulaic correspondence phrases: salutations and valedictions for every covered locale.

cnice is a facade over two deterministic correspondence libraries: salutations (cnice.greet, previously the German-only cgreet repo) and locale-specific valedictions (cnice.farewell, previously cfarewell). One matcher renders every language from table rows — a new language is a new row, never new code. Same input always yields the same output: no models, no I/O.

import { farewell, greet } from '@corbet-labs/cnice';

greet.salutation('de-ch', 'Frau Dr. Müller');
// Sehr geehrte Frau Dr. Müller
greet.salutation('fr', 'Madame Dupont');
// Madame Dupont,
farewell.closing('de-ch');
// Freundliche Grüsse

Install

Version 0.1.3 is published to registries.

The JavaScript distribution includes compiled ESM, CommonJS, TypeScript declarations, and a standalone browser module. Node.js 20+ is supported; no TypeScript loader is required.

// CommonJS
const { greet, farewell } = require('@corbet-labs/cnice');

<script type="module">
  import { greet } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cnice@0.1.3/dist/browser.js';
  console.log(greet.salutation('de-ch', 'Frau Dr. Müller'));
</script>

See the installation guide for CLI commands and other distribution options. JSR installation is documented there too.

Rust

use cnice::{farewell, greet};

assert_eq!(greet::salutation("de-ch", "Frau Dr. Müller"), "Sehr geehrte Frau Dr. Müller");
assert_eq!(greet::salutation("fr", "Madame Dupont"), "Madame Dupont,");
assert_eq!(farewell::closing("de-ch", None), "Freundliche Grüsse");

Typst in Rust hosts

The crate also ships the Typst package. Applications that embed the Typst compiler can register it from cnice::typst instead of downloading or vendoring a copy, so Rust and Typst always come from the same release. FILES holds package-relative paths (typst.toml, typst/lib.typ, and the tables/ the Typst sources read) with their bytes; spec() is the import specification.

use cnice::typst::{FILES, NAME, NAMESPACE, VERSION, spec};

assert_eq!((NAMESPACE, NAME), ("preview", "cnice"));
assert_eq!(spec(), format!("@preview/cnice:{VERSION}"));
for (path, bytes) in FILES {
    // Serve `bytes` for `path` inside the package `spec()` in your Typst world.
    let _ = (path, bytes.len());
}

Documents then import the package as usual, for example #import "@preview/cnice:0.1.3": greet, farewell.

Python

from cnice import farewell, greet

assert greet.salutation("de-ch", "Frau Dr. Müller") == 'Sehr geehrte Frau Dr. Müller'
assert greet.salutation("fr", "Madame Dupont") == 'Madame Dupont,'
assert farewell.closing("de-ch") == 'Freundliche Grüsse'

The Python CLI accepts bare and namespaced function names and writes JSON to stdout:

cnice greet.salutation '["de-ch", "Frau Dr. Müller"]'
cnice closing '["de-ch"]'
python -m cnice --help

API

Covered salutation locales: de, de-ch, de-at, de-li, fr, it, rm, en, en-gb, en-us. Comma behavior, title precedence and formal fallbacks are row data, identical on every port. A recognized Professor title takes precedence over Dr. Missing honorifics or surnames produce the formal fallback. The library does not infer a person’s gender from their name. Valediction lookups are case-insensitive and resolve the exact locale, then its base language, then English; an explicit override always wins.

Correspondence family

Development

Behavior is defined by the locale tables and shared conformance vectors. Rust, JavaScript, Python, and Typst run the same 189 vectors. Selected CI checks exercise installed JavaScript tarballs, Python wheels and command-line entrypoints, and Typst packages. Release validation records the actual runtime and platform; Linux results do not establish native Windows or macOS coverage. All crates forbid unsafe code in their own source.

See the release guide for generation, verification, and publication commands.

License

Copyright 2026 Julian Y. Richard Corbet. The 0.1.3 release line is licensed under LGPL-3.0-only WITH LGPL-3.0-linking-exception, with the incorporated GPL version 3. Combined works may link statically or dynamically without relinking duties; library modifications stay LGPL. Applications can use a different license subject to the LGPL's conditions. The cgreet and cfarewell repositories keep their own release grants untouched; this facade does not relicense them.

See the licensing notes for distribution conditions and retained notices. Contributions are accepted under the Contributor License Agreement.