@kontourai/survey 1.2.1 → 1.3.0

package/README.md

@@ -40,6 +40,13 @@ The Review Workbench rendering a real example queue — current vs proposed valu
 npm install @kontourai/survey @kontourai/surface
 ```
 
+Requires Node.js >=22. TypeScript >=5.0 is required to compile against
+Survey's published type declarations (`defineProductVocabulary`'s `const`
+type parameters are TS 5.0+ syntax) — JavaScript consumers are unaffected;
+TypeScript consumers on an older compiler should stay on `1.2.x`. See the
+[Upgrade Guide](docs/upgrade-guide.md#consuming-decisioneffects-safely) for
+details.
+
 ```ts
 import { buildTrustReport, validateTrustBundle } from "@kontourai/surface";
 import { buildSurveyTrustBundle, SurveyInputBuilder } from "@kontourai/survey";

package/dist/src/vocabulary.d.ts

@@ -27,8 +27,20 @@ export interface ProductVocabularyDefinition<TClaimTypes extends Readonly<Record
  * `currentProposedReviewItem` caller can pass instead of loose top-level
  * constants. Returns the same shape it received, frozen so callers cannot
  * mutate a shared vocabulary at runtime.
+ *
+ * The type parameters carry the `const` modifier, so `claimTypes` and
+ * `decisionEffects` string properties keep their literal types whether or
+ * not the caller appends `as const` to the argument — do not re-add an
+ * `as const` requirement to this helper's documented usage; it is not
+ * needed here (requires TypeScript 5.0+; unlike a plain object literal
+ * passed to a non-`const` generic elsewhere), and callers who already write
+ * `as const` continue to compile identically. Note: the `const` type-
+ * parameter syntax itself requires a TypeScript 5.0+ compiler to parse this
+ * function's declaration at all (see `package.json`'s
+ * `peerDependencies.typescript` and `docs/upgrade-guide.md`); this is a
+ * types-only floor and does not affect JavaScript consumers.
  */
-export declare function defineProductVocabulary<TClaimTypes extends Readonly<Record<string, string>>, TDecisionEffects extends Readonly<Record<string, string>>>(definition: ProductVocabularyDefinition<TClaimTypes, TDecisionEffects>): ProductVocabularyDefinition<TClaimTypes, TDecisionEffects>;
+export declare function defineProductVocabulary<const TClaimTypes extends Readonly<Record<string, string>>, const TDecisionEffects extends Readonly<Record<string, string>>>(definition: ProductVocabularyDefinition<TClaimTypes, TDecisionEffects>): ProductVocabularyDefinition<TClaimTypes, TDecisionEffects>;
 export interface ConfidenceBasisForReviewInput {
     readonly status: TrustStatus;
     readonly impactLevel: ImpactLevel;

package/dist/src/vocabulary.js

@@ -21,6 +21,18 @@ export function stableId(parts) {
  * `currentProposedReviewItem` caller can pass instead of loose top-level
  * constants. Returns the same shape it received, frozen so callers cannot
  * mutate a shared vocabulary at runtime.
+ *
+ * The type parameters carry the `const` modifier, so `claimTypes` and
+ * `decisionEffects` string properties keep their literal types whether or
+ * not the caller appends `as const` to the argument — do not re-add an
+ * `as const` requirement to this helper's documented usage; it is not
+ * needed here (requires TypeScript 5.0+; unlike a plain object literal
+ * passed to a non-`const` generic elsewhere), and callers who already write
+ * `as const` continue to compile identically. Note: the `const` type-
+ * parameter syntax itself requires a TypeScript 5.0+ compiler to parse this
+ * function's declaration at all (see `package.json`'s
+ * `peerDependencies.typescript` and `docs/upgrade-guide.md`); this is a
+ * types-only floor and does not affect JavaScript consumers.
  */
 export function defineProductVocabulary(definition) {
     return deepFreeze({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",
@@ -71,11 +71,15 @@
     "@kontourai/surface": "^1.3.0"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": ">=0.20.0"
+    "@anthropic-ai/sdk": ">=0.20.0",
+    "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "@anthropic-ai/sdk": {
       "optional": true
+    },
+    "typescript": {
+      "optional": true
     }
   },
   "devDependencies": {