code wiki / (root) / nx_catalog_id_lookup.nx
`nx_catalog_id_lookup.nx` source

↩ module page · 290 lines · 15695 B
1// nx_catalog_id_lookup.nx -- string-id <-> sealed-enum bridge.
2//
3// CAPABILITY_COMPLETENESS: FULL  (for shipped catalog enums;
4//   new catalog entries register via the lookup-table extension
5//   pattern documented inline)
6//
7// Phase 1.5 of NISHI_NSFW_LESSONS_AND_ADDITIVE_CATALOG.md:
8// bridges the JSONL catalog files (nxc2/seed/modesty_profiles.jsonl
9// + nxc2/seed/object_specs.jsonl) -- where each row's `id` field
10// is a human-readable string -- with the runtime sealed-enum
11// integers that nx_modesty_profile + nx_object_spec use.
12//
13// Without this bridge, every JSONL-loader would need to embed
14// the same string -> enum mapping.  With it, ONE place owns the
15// canonical mapping; Phase 2 loaders compose against it.
16//
17// The lookup is OPEN-FORM lookup (no fancy hash table) because
18// the catalogs are small (16 modesty + 23 object specs).  When
19// the catalog grows past a few hundred entries, swap to FNV-1a
20// hash table; the API stays.
21//
22// genealogy_id: substrate_additive_catalog_phase_1_5_2026_05_16
23// lineage_id:   nx_catalog_id_lookup_v1
24
25import "nx_syscalls.nx"
26import "nx_runtime.nx"
27import "nx_tier.nx"
28import "nx_modesty_profile.nx"
29import "nx_object_spec.nx"
30
31// ===== string comparison helper ==================================
32//
33// Substrate doesn't have nx_str_eq imported here; build a focused
34// byte-by-byte comparator.  Returns 1 if equal, 0 otherwise.
35
36func _idlk_streq(a: *u8, n: nx_int, lit: *u8) -> nx_int {
  var i: nx_int = 0
  while i < n {
      let ac: nx_int = (a[i] as nx_int) & 255
      let bc: nx_int = (lit[i] as nx_int) & 255
      if ac != bc { return 0 }
      if bc == 0 { return 0 }
      i = i + 1
  }
  // Verify lit ends here (no trailing chars after our length).
  if (lit[n] as nx_int) & 255 != 0 { return 0 }
  return 1
48}
49
50// ===== modesty id -> enum ========================================
51//
52// Returns the NX_MODESTY_* sealed-enum integer for the given
53// canonical id string.  Returns -1 if unknown.
54
55func nx_modesty_id_to_enum(id_buf: *u8, id_len: nx_int) -> nx_int {
  if id_len <= 0 { return -1 }
  if _idlk_streq(id_buf, id_len, "modern_western_casual" as *u8) == 1 {
      return NX_MODESTY_MODERN_WESTERN_CASUAL
  }
  if _idlk_streq(id_buf, id_len, "modern_western_formal" as *u8) == 1 {
      return NX_MODESTY_MODERN_WESTERN_FORMAL
  }
  if _idlk_streq(id_buf, id_len, "modern_western_beach" as *u8) == 1 {
      return NX_MODESTY_MODERN_WESTERN_BEACH
  }
  if _idlk_streq(id_buf, id_len, "modern_lingerie" as *u8) == 1 {
      return NX_MODESTY_MODERN_LINGERIE
  }
  if _idlk_streq(id_buf, id_len, "victorian" as *u8) == 1 {
      return NX_MODESTY_VICTORIAN
  }
  if _idlk_streq(id_buf, id_len, "ancient_greek_athletic_m" as *u8) == 1 {
      return NX_MODESTY_ANCIENT_GREEK_ATHLETIC_M
  }
  if _idlk_streq(id_buf, id_len, "ancient_greek_athletic_f" as *u8) == 1 {
      return NX_MODESTY_ANCIENT_GREEK_ATHLETIC_F
  }
  if _idlk_streq(id_buf, id_len, "ancient_roman_public" as *u8) == 1 {
      return NX_MODESTY_ANCIENT_ROMAN_PUBLIC
  }
  if _idlk_streq(id_buf, id_len, "renaissance_nobility" as *u8) == 1 {
      return NX_MODESTY_RENAISSANCE_NOBILITY
  }
  if _idlk_streq(id_buf, id_len, "heian_court" as *u8) == 1 {
      return NX_MODESTY_HEIAN_COURT
  }
  if _idlk_streq(id_buf, id_len, "islamic_hijab" as *u8) == 1 {
      return NX_MODESTY_ISLAMIC_HIJAB
  }
  if _idlk_streq(id_buf, id_len, "islamic_niqab" as *u8) == 1 {
      return NX_MODESTY_ISLAMIC_NIQAB
  }
  if _idlk_streq(id_buf, id_len, "hindu_sari" as *u8) == 1 {
      return NX_MODESTY_HINDU_SARI
  }
  if _idlk_streq(id_buf, id_len, "medical_professional" as *u8) == 1 {
      return NX_MODESTY_MEDICAL_PROFESSIONAL
  }
  if _idlk_streq(id_buf, id_len, "artistic_nude_renaissance" as *u8) == 1 {
      return NX_MODESTY_ARTISTIC_NUDE_RENAISSANCE
  }
  if _idlk_streq(id_buf, id_len, "athletic_dance" as *u8) == 1 {
      return NX_MODESTY_ATHLETIC_DANCE
  }
  return -1
106}
107
108// ===== modesty enum -> id ========================================
109//
110// Reverse lookup for human-readable phrase rendering.
111
112func nx_modesty_enum_to_id(profile_id: nx_int) -> *u8 {
  if profile_id == NX_MODESTY_MODERN_WESTERN_CASUAL { return "modern_western_casual" as *u8 }
  if profile_id == NX_MODESTY_MODERN_WESTERN_FORMAL { return "modern_western_formal" as *u8 }
  if profile_id == NX_MODESTY_MODERN_WESTERN_BEACH { return "modern_western_beach" as *u8 }
  if profile_id == NX_MODESTY_MODERN_LINGERIE { return "modern_lingerie" as *u8 }
  if profile_id == NX_MODESTY_VICTORIAN { return "victorian" as *u8 }
  if profile_id == NX_MODESTY_ANCIENT_GREEK_ATHLETIC_M { return "ancient_greek_athletic_m" as *u8 }
  if profile_id == NX_MODESTY_ANCIENT_GREEK_ATHLETIC_F { return "ancient_greek_athletic_f" as *u8 }
  if profile_id == NX_MODESTY_ANCIENT_ROMAN_PUBLIC { return "ancient_roman_public" as *u8 }
  if profile_id == NX_MODESTY_RENAISSANCE_NOBILITY { return "renaissance_nobility" as *u8 }
  if profile_id == NX_MODESTY_HEIAN_COURT { return "heian_court" as *u8 }
  if profile_id == NX_MODESTY_ISLAMIC_HIJAB { return "islamic_hijab" as *u8 }
  if profile_id == NX_MODESTY_ISLAMIC_NIQAB { return "islamic_niqab" as *u8 }
  if profile_id == NX_MODESTY_HINDU_SARI { return "hindu_sari" as *u8 }
  if profile_id == NX_MODESTY_MEDICAL_PROFESSIONAL { return "medical_professional" as *u8 }
  if profile_id == NX_MODESTY_ARTISTIC_NUDE_RENAISSANCE { return "artistic_nude_renaissance" as *u8 }
  if profile_id == NX_MODESTY_ATHLETIC_DANCE { return "athletic_dance" as *u8 }
  return "unknown_profile" as *u8
130}
131
132// ===== object spec id -> enum ====================================
133
134func nx_object_spec_id_to_enum(id_buf: *u8, id_len: nx_int) -> nx_int {
  if id_len <= 0 { return -1 }
  if _idlk_streq(id_buf, id_len, "sword_long" as *u8) == 1 { return NX_SPEC_SWORD_LONG }
  if _idlk_streq(id_buf, id_len, "sword_short" as *u8) == 1 { return NX_SPEC_SWORD_SHORT }
  if _idlk_streq(id_buf, id_len, "dagger" as *u8) == 1 { return NX_SPEC_DAGGER }
  if _idlk_streq(id_buf, id_len, "spear" as *u8) == 1 { return NX_SPEC_SPEAR }
  if _idlk_streq(id_buf, id_len, "axe_battle" as *u8) == 1 { return NX_SPEC_AXE_BATTLE }
  if _idlk_streq(id_buf, id_len, "mace" as *u8) == 1 { return NX_SPEC_MACE }
  if _idlk_streq(id_buf, id_len, "hammer_war" as *u8) == 1 { return NX_SPEC_HAMMER_WAR }
  if _idlk_streq(id_buf, id_len, "bow_long" as *u8) == 1 { return NX_SPEC_BOW_LONG }
  if _idlk_streq(id_buf, id_len, "staff_quarter" as *u8) == 1 { return NX_SPEC_STAFF_QUARTER }
  if _idlk_streq(id_buf, id_len, "wand_magic" as *u8) == 1 { return NX_SPEC_WAND_MAGIC }
  if _idlk_streq(id_buf, id_len, "shirt_button" as *u8) == 1 { return NX_SPEC_SHIRT_BUTTON }
  if _idlk_streq(id_buf, id_len, "shirt_t" as *u8) == 1 { return NX_SPEC_SHIRT_T }
  if _idlk_streq(id_buf, id_len, "pants_jeans" as *u8) == 1 { return NX_SPEC_PANTS_JEANS }
  if _idlk_streq(id_buf, id_len, "dress_sundress" as *u8) == 1 { return NX_SPEC_DRESS_SUNDRESS }
  if _idlk_streq(id_buf, id_len, "coat_trench" as *u8) == 1 { return NX_SPEC_COAT_TRENCH }
  if _idlk_streq(id_buf, id_len, "hat_fedora" as *u8) == 1 { return NX_SPEC_HAT_FEDORA }
  if _idlk_streq(id_buf, id_len, "lingerie_bra" as *u8) == 1 { return NX_SPEC_LINGERIE_BRA }
  if _idlk_streq(id_buf, id_len, "orc_standard" as *u8) == 1 { return NX_SPEC_ORC_STANDARD }
  if _idlk_streq(id_buf, id_len, "elf_high" as *u8) == 1 { return NX_SPEC_ELF_HIGH }
  if _idlk_streq(id_buf, id_len, "dragon_western" as *u8) == 1 { return NX_SPEC_DRAGON_WESTERN }
  if _idlk_streq(id_buf, id_len, "werewolf" as *u8) == 1 { return NX_SPEC_WEREWOLF }
  if _idlk_streq(id_buf, id_len, "car_sedan" as *u8) == 1 { return NX_SPEC_CAR_SEDAN }
  if _idlk_streq(id_buf, id_len, "motorcycle" as *u8) == 1 { return NX_SPEC_MOTORCYCLE }
  if _idlk_streq(id_buf, id_len, "castle_medieval" as *u8) == 1 { return NX_SPEC_CASTLE_MEDIEVAL }
  if _idlk_streq(id_buf, id_len, "bubble_wand" as *u8) == 1 { return NX_SPEC_BUBBLE_WAND }
  if _idlk_streq(id_buf, id_len, "pen_ballpoint" as *u8) == 1 { return NX_SPEC_PEN_BALLPOINT }
  if _idlk_streq(id_buf, id_len, "torch" as *u8) == 1 { return NX_SPEC_TORCH }
  if _idlk_streq(id_buf, id_len, "flashlight" as *u8) == 1 { return NX_SPEC_FLASHLIGHT }
  return -1
165}
166
167// ===== part id (used in object_specs JSONL required_parts arrays) ==
168
169func nx_part_id_to_enum(name: *u8, len: nx_int) -> nx_int {
  if len <= 0 { return -1 }
  // Weapon parts
  if _idlk_streq(name, len, "BLADE" as *u8) == 1 { return NX_PT_BLADE }
  if _idlk_streq(name, len, "EDGE" as *u8) == 1 { return NX_PT_EDGE }
  if _idlk_streq(name, len, "POINT" as *u8) == 1 { return NX_PT_POINT }
  if _idlk_streq(name, len, "TANG" as *u8) == 1 { return NX_PT_TANG }
  if _idlk_streq(name, len, "CROSSGUARD" as *u8) == 1 { return NX_PT_CROSSGUARD }
  if _idlk_streq(name, len, "GRIP" as *u8) == 1 { return NX_PT_GRIP }
  if _idlk_streq(name, len, "POMMEL" as *u8) == 1 { return NX_PT_POMMEL }
  if _idlk_streq(name, len, "HAFT" as *u8) == 1 { return NX_PT_HAFT }
  if _idlk_streq(name, len, "HEAD_WEAPON" as *u8) == 1 { return NX_PT_HEAD_WEAPON }
  if _idlk_streq(name, len, "LIMB_BOW" as *u8) == 1 { return NX_PT_LIMB_BOW }
  if _idlk_streq(name, len, "STRING_BOW" as *u8) == 1 { return NX_PT_STRING_BOW }
  if _idlk_streq(name, len, "NOCK" as *u8) == 1 { return NX_PT_NOCK }
  if _idlk_streq(name, len, "FLETCHING" as *u8) == 1 { return NX_PT_FLETCHING }
  // Wand / non-weapon stick parts
  if _idlk_streq(name, len, "HANDLE_STICK" as *u8) == 1 { return NX_PT_HANDLE_STICK }
  if _idlk_streq(name, len, "LOOP" as *u8) == 1 { return NX_PT_LOOP }
  if _idlk_streq(name, len, "FILM" as *u8) == 1 { return NX_PT_FILM }
  if _idlk_streq(name, len, "NIB" as *u8) == 1 { return NX_PT_NIB }
  if _idlk_streq(name, len, "TIP" as *u8) == 1 { return NX_PT_TIP }
  if _idlk_streq(name, len, "FLAME" as *u8) == 1 { return NX_PT_FLAME }
  // Clothing parts
  if _idlk_streq(name, len, "COLLAR" as *u8) == 1 { return NX_PT_COLLAR }
  if _idlk_streq(name, len, "NECKLINE" as *u8) == 1 { return NX_PT_NECKLINE }
  if _idlk_streq(name, len, "SLEEVE_SHORT" as *u8) == 1 { return NX_PT_SLEEVE_SHORT }
  if _idlk_streq(name, len, "SLEEVE_LONG" as *u8) == 1 { return NX_PT_SLEEVE_LONG }
  if _idlk_streq(name, len, "CUFF" as *u8) == 1 { return NX_PT_CUFF }
  if _idlk_streq(name, len, "HEM" as *u8) == 1 { return NX_PT_HEM }
  if _idlk_streq(name, len, "WAISTBAND" as *u8) == 1 { return NX_PT_WAISTBAND }
  if _idlk_streq(name, len, "BUTTON" as *u8) == 1 { return NX_PT_BUTTON }
  if _idlk_streq(name, len, "ZIPPER" as *u8) == 1 { return NX_PT_ZIPPER }
  if _idlk_streq(name, len, "POCKET" as *u8) == 1 { return NX_PT_POCKET }
  if _idlk_streq(name, len, "LAPEL" as *u8) == 1 { return NX_PT_LAPEL }
  if _idlk_streq(name, len, "HOOD" as *u8) == 1 { return NX_PT_HOOD }
  if _idlk_streq(name, len, "BRA_CUP" as *u8) == 1 { return NX_PT_BRA_CUP }
  if _idlk_streq(name, len, "BRA_STRAP" as *u8) == 1 { return NX_PT_BRA_STRAP }
  // Creature parts
  if _idlk_streq(name, len, "HEAD" as *u8) == 1 { return NX_PT_HEAD }
  if _idlk_streq(name, len, "TUSK" as *u8) == 1 { return NX_PT_TUSK }
  if _idlk_streq(name, len, "HORN" as *u8) == 1 { return NX_PT_HORN }
  if _idlk_streq(name, len, "WING" as *u8) == 1 { return NX_PT_WING }
  if _idlk_streq(name, len, "TAIL" as *u8) == 1 { return NX_PT_TAIL }
  if _idlk_streq(name, len, "SCALE" as *u8) == 1 { return NX_PT_SCALE }
  if _idlk_streq(name, len, "FUR" as *u8) == 1 { return NX_PT_FUR }
  if _idlk_streq(name, len, "POINTED_EAR" as *u8) == 1 { return NX_PT_POINTED_EAR }
  if _idlk_streq(name, len, "CLAW" as *u8) == 1 { return NX_PT_CLAW }
  if _idlk_streq(name, len, "FANG" as *u8) == 1 { return NX_PT_FANG }
  // Vehicle parts
  if _idlk_streq(name, len, "WHEEL" as *u8) == 1 { return NX_PT_WHEEL }
  if _idlk_streq(name, len, "WINDSHIELD" as *u8) == 1 { return NX_PT_WINDSHIELD }
  if _idlk_streq(name, len, "HEADLIGHT" as *u8) == 1 { return NX_PT_HEADLIGHT }
  if _idlk_streq(name, len, "LICENSE_PLATE" as *u8) == 1 { return NX_PT_LICENSE_PLATE }
  if _idlk_streq(name, len, "MIRROR" as *u8) == 1 { return NX_PT_MIRROR }
  if _idlk_streq(name, len, "GRILLE" as *u8) == 1 { return NX_PT_GRILLE }
  if _idlk_streq(name, len, "HANDLEBAR" as *u8) == 1 { return NX_PT_HANDLEBAR }
  // Architecture parts
  if _idlk_streq(name, len, "WALL" as *u8) == 1 { return NX_PT_WALL }
  if _idlk_streq(name, len, "WINDOW_PANE" as *u8) == 1 { return NX_PT_WINDOW_PANE }
  if _idlk_streq(name, len, "DOOR" as *u8) == 1 { return NX_PT_DOOR }
  if _idlk_streq(name, len, "ROOF" as *u8) == 1 { return NX_PT_ROOF }
  if _idlk_streq(name, len, "BATTLEMENT" as *u8) == 1 { return NX_PT_BATTLEMENT }
  if _idlk_streq(name, len, "ARROW_SLIT" as *u8) == 1 { return NX_PT_ARROW_SLIT }
  if _idlk_streq(name, len, "TURRET" as *u8) == 1 { return NX_PT_TURRET }
  if _idlk_streq(name, len, "CHIMNEY" as *u8) == 1 { return NX_PT_CHIMNEY }
  return -1
236}
237
238// ===== self-test =================================================
239
240func main() -> nx_int {
  // ---- modesty: forward lookups ----
  let s1: *u8 = "modern_western_casual" as *u8
  if nx_modesty_id_to_enum(s1, 21) != NX_MODESTY_MODERN_WESTERN_CASUAL { return 1 }
  let s2: *u8 = "victorian" as *u8
  if nx_modesty_id_to_enum(s2, 9) != NX_MODESTY_VICTORIAN { return 2 }
  let s3: *u8 = "islamic_niqab" as *u8
  if nx_modesty_id_to_enum(s3, 13) != NX_MODESTY_ISLAMIC_NIQAB { return 3 }
  let s4: *u8 = "heian_court" as *u8
  if nx_modesty_id_to_enum(s4, 11) != NX_MODESTY_HEIAN_COURT { return 4 }
  let s5: *u8 = "hindu_sari" as *u8
  if nx_modesty_id_to_enum(s5, 10) != NX_MODESTY_HINDU_SARI { return 5 }
252
  // ---- modesty: unknown returns -1 ----
  let s_bad: *u8 = "not_a_real_profile" as *u8
  if nx_modesty_id_to_enum(s_bad, 18) != -1 { return 10 }
256
  // ---- modesty: reverse lookup ----
  let p_back: *u8 = nx_modesty_enum_to_id(NX_MODESTY_VICTORIAN)
  if _idlk_streq(p_back, 9, "victorian" as *u8) != 1 { return 20 }
  let p_unk: *u8 = nx_modesty_enum_to_id(NX_MODESTY_N_PROFILES)
  if _idlk_streq(p_unk, 15, "unknown_profile" as *u8) != 1 { return 21 }
262
  // ---- object spec: forward lookups ----
  let o1: *u8 = "sword_long" as *u8
  if nx_object_spec_id_to_enum(o1, 10) != NX_SPEC_SWORD_LONG { return 30 }
  let o2: *u8 = "bubble_wand" as *u8
  if nx_object_spec_id_to_enum(o2, 11) != NX_SPEC_BUBBLE_WAND { return 31 }
  let o3: *u8 = "dragon_western" as *u8
  if nx_object_spec_id_to_enum(o3, 14) != NX_SPEC_DRAGON_WESTERN { return 32 }
  let o4: *u8 = "orc_standard" as *u8
  if nx_object_spec_id_to_enum(o4, 12) != NX_SPEC_ORC_STANDARD { return 33 }
272
  // ---- part id: forward lookups (the JSONL row's required_parts[] entries) ----
  let pt1: *u8 = "BLADE" as *u8
  if nx_part_id_to_enum(pt1, 5) != NX_PT_BLADE { return 40 }
  let pt2: *u8 = "CROSSGUARD" as *u8
  if nx_part_id_to_enum(pt2, 10) != NX_PT_CROSSGUARD { return 41 }
  let pt3: *u8 = "LOOP" as *u8
  if nx_part_id_to_enum(pt3, 4) != NX_PT_LOOP { return 42 }
  let pt4: *u8 = "POINTED_EAR" as *u8
  if nx_part_id_to_enum(pt4, 11) != NX_PT_POINTED_EAR { return 43 }
  let pt5: *u8 = "BATTLEMENT" as *u8
  if nx_part_id_to_enum(pt5, 10) != NX_PT_BATTLEMENT { return 44 }
284
  // ---- part id: unknown ----
  let pt_bad: *u8 = "NOT_A_PART" as *u8
  if nx_part_id_to_enum(pt_bad, 10) != -1 { return 50 }
288
  return 0
290}
nx_catalog_id_lookup.nx source

`nx_catalog_id_lookup.nx` source
