@glossarist/concept-browser 0.7.87 → 0.7.89

package/src/adapters/non-verbal/glossarist-augment.d.ts

@@ -224,6 +224,12 @@ declare module 'glossarist' {
 // Re-declare the same exports under the 'glossarist/models' subpath so
 // deep-import callers can use them. Upstream's d.ts is stale on this
 // subpath too.
+//
+// The duplication between the 'glossarist' block above and this block
+// is forced by upstream's broken d.ts (PR glossarist/glossarist-js#31).
+// We cannot `export import` from a local namespace because TypeScript
+// requires `declare module` blocks to be self-contained. When upstream
+// ships proper d.ts, DELETE this entire file.
 declare module 'glossarist/models' {
   export type Completeness = 'complete' | 'partial';
   export const COMPLETENESS: { readonly COMPLETE: 'complete'; readonly PARTIAL: 'partial' };
@@ -252,23 +258,8 @@ declare module 'glossarist/models' {
   export function isValidMultiplicity(value: unknown): value is Multiplicity;
   export function multiplicityFromPair(presence: PartitivePresence, count: PartitiveCount): Multiplicity;
   export function pairFromMultiplicity(name: Multiplicity): { presence: PartitivePresence; count: PartitiveCount };
-
-  export class TypeSharedPlurality extends GlossaristModel {
-    constructor(data?: {
-      isShared?: boolean;
-      is_shared?: boolean;
-      isUncertain?: boolean;
-      is_uncertain?: boolean;
-      sharedType?: ConceptRef;
-      shared_type?: ConceptRef;
-    });
-    readonly isShared: boolean;
-    readonly isUncertain: boolean;
-    readonly sharedType: ConceptRef | null;
-    hasSharedType(): boolean;
-    toJSON(): { is_shared: boolean; is_uncertain?: boolean; shared_type?: ReturnType<ConceptRef['toJSON']> };
-    static fromJSON(data: Record<string, unknown>): TypeSharedPlurality;
-  }
+  // (TypeSharedPlurality removed — superseded by presence/count on
+  // PartitiveMember per MECE refactor. Was dead code.)
 
   // ── PartitiveRelation (glossarist 0.4.26 — MECE presence × count) ─
 

package/src/adapters/wire-keys.ts

@@ -0,0 +1,154 @@
+/**
+ * Wire-format keys for the JSON-LD bridge.
+ *
+ * Single source of truth for the `'gl:*'` and `'@*'` string keys used
+ * across `src/adapters/model-bridge*.ts` to read the JSON-LD wire
+ * format produced by `scripts/generate-data.mjs`.
+ *
+ * Why this exists:
+ *   - Replaces ~230 inline string literals that were spread across
+ *     adapter files. Typos like `'gl:presnce'` were undetectable at
+ *     compile time.
+ *   - When glossarist-js's JSON-LD context adds/renames a field, the
+ *     change is one entry here, not a grep-and-replace exercise.
+ *
+ * The interface declarations in `model-bridge/jsonld-types.ts` still
+ * use string literals — TypeScript interface keys cannot reference
+ * a `const`. The literals there MUST agree with the constants here;
+ * the `WireKeys` type at the bottom of this file constrains them to
+ * the same set.
+ *
+ * Adding a new wire field:
+ *   1. Add the key constant here.
+ *   2. Add the interface field in `jsonld-types.ts`.
+ *   3. Add the mapper logic in `model-bridge.ts`.
+ *
+ * (3 steps for new fields instead of touching 5+ files.)
+ */
+
+export const GL = {
+  // JSON-LD core
+  ID: '@id',
+  TYPE: '@type',
+
+  // Concept-level
+  IDENTIFIER: 'gl:identifier',
+  TERM: 'gl:term',
+  LOCALIZED_CONCEPT: 'gl:localizedConcept',
+  RELATED: 'gl:related',
+  PARTITIVE_RELATIONS: 'gl:partitiveRelations',
+  TAGS: 'gl:tags',
+
+  // LocalizedConcept
+  LANGUAGE_CODE: 'gl:languageCode',
+  ENTRY_STATUS: 'gl:entryStatus',
+  CLASSIFICATION: 'gl:classification',
+  REVIEW_TYPE: 'gl:reviewType',
+  DOMAIN: 'gl:domain',
+  RELEASE: 'gl:release',
+  LINEAGE_SOURCE_SIMILARITY: 'gl:lineageSourceSimilarity',
+  SCRIPT: 'gl:script',
+  SYSTEM: 'gl:system',
+  DESIGNATION: 'gl:designation',
+  DEFINITION: 'gl:definition',
+  NOTES: 'gl:notes',
+  ANNOTATIONS: 'gl:annotations',
+  EXAMPLES: 'gl:examples',
+  SOURCE: 'gl:source',
+  DATES: 'gl:dates',
+  REFERENCES: 'gl:references',
+
+  // Review fields
+  REVIEW_DATE: 'gl:reviewDate',
+  REVIEW_DECISION_DATE: 'gl:reviewDecisionDate',
+  REVIEW_DECISION_EVENT: 'gl:reviewDecisionEvent',
+  REVIEW_STATUS: 'gl:reviewStatus',
+  REVIEW_DECISION: 'gl:reviewDecision',
+  REVIEW_DECISION_NOTES: 'gl:reviewDecisionNotes',
+
+  // Designation
+  NORMATIVE_STATUS: 'gl:normativeStatus',
+  ABSENT: 'gl:absent',
+  FIELD_OF_APPLICATION: 'gl:fieldOfApplication',
+  USAGE_INFO: 'gl:usageInfo',
+  GEOGRAPHICAL_AREA: 'gl:geographicalArea',
+  LANGUAGE: 'gl:language',
+  INTERNATIONAL: 'gl:international',
+  TERM_TYPE: 'gl:termType',
+  PRONUNCIATION: 'gl:pronunciation',
+  PREFIX: 'gl:prefix',
+  GENDER: 'gl:gender',
+  GRAMMAR_INFO: 'gl:grammarInfo',
+
+  // GrammarInfo
+  NUMBER: 'gl:number',
+  PART_OF_SPEECH: 'gl:partOfSpeech',
+  NOUN: 'gl:noun',
+  VERB: 'gl:verb',
+  ADJ: 'gl:adj',
+  ADVERB: 'gl:adverb',
+  PREPOSITION: 'gl:preposition',
+  PARTICIPLE: 'gl:participle',
+
+  // Pronunciation
+  COUNTRY: 'gl:country',
+
+  // Content (definition, notes, examples, annotations)
+  CONTENT: 'gl:content',
+
+  // Date
+  DATE: 'gl:date',
+  DATE_TYPE: 'gl:dateType',
+
+  // ConceptRef / Citation.Origin
+  REF: 'gl:ref',
+  LOCALITY: 'gl:locality',
+  LINK: 'gl:link',
+  VERSION: 'gl:version',
+  TEXT: 'gl:text',
+
+  // Locally-scoped id within source/origin/ref (NOT JSON-LD's @id)
+  LOCAL_ID: 'gl:id',
+
+  // Locality
+  LOCALITY_TYPE: 'gl:localityType',
+  REFERENCE_FROM: 'gl:referenceFrom',
+  REFERENCE_TO: 'gl:referenceTo',
+
+  // ConceptSource
+  SOURCE_TYPE: 'gl:sourceType',
+  SOURCE_STATUS: 'gl:sourceStatus',
+  MODIFICATION: 'gl:modification',
+  ORIGIN: 'gl:origin',
+  SOURCED_FROM: 'gl:sourcedFrom',
+  SOURCED_FROM_ALT: 'gl:sourced_from',
+
+  // RelatedConcept
+  RELATIONSHIP_TYPE: 'gl:relationshipType',
+  TARGET: 'gl:target',
+  SOURCE_ID: 'gl:sourceId',
+  CITATION: 'gl:citation',
+
+  // PartitiveMember (MECE)
+  PRESENCE: 'gl:presence',
+  COUNT: 'gl:count',
+  IS_DELIMITING: 'gl:isDelimiting',
+  MULTIPLICITY: 'gl:multiplicity',
+  CERTAINTY: 'gl:certainty',
+
+  // PartitiveRelation
+  COMPREHENSIVE: 'gl:comprehensive',
+  HAS_PARTITIVE: 'gl:hasPartitive',
+  COMPLETENESS: 'gl:completeness',
+  CRITERION: 'gl:criterion',
+
+  // Non-verbal entity references at concept level
+  FIGURE_REF: 'gl:figureRef',
+  TABLE_REF: 'gl:tableRef',
+  FORMULA_REF: 'gl:formulaRef',
+
+  // NonVerbalReference display string
+  DISPLAY: 'gl:display',
+} as const;
+
+export type WireKey = typeof GL[keyof typeof GL];

package/vite.config.ts

@@ -181,6 +181,9 @@ export default defineConfig({
   test: {
     environment: 'happy-dom',
     globals: true,
-    include: ['src/__tests__/**/*.test.ts'],
+    include: [
+      'src/__tests__/**/*.test.ts',
+      'scripts/__tests__/**/*.test.mjs',
+    ],
   },
 })