brainy/examples/type-utils-example.js
David Snelling 17bd7ab42d **feat(utils): add type utility functions and examples for runtime type management**
- Introduced `getNounTypes`, `getVerbTypes`, `getNounTypeMap`, and `getVerbTypeMap` utilities for managing noun and verb types at runtime.
- Added comprehensive unit tests (`type-utils.test.ts`) to ensure correctness of type utility functions.
- Created new example files (`type-utils-example.js`, `type-utils-example.ts`) to demonstrate the use of type utilities in JavaScript and TypeScript environments.
- Updated `README.md` with detailed documentation and usage examples for the new type utilities.
- Enhanced `index.ts` to export the new utility functions, making them accessible throughout the library.

**Purpose**: Facilitate easy access, validation, and manipulation of noun and verb types in client applications, providing better runtime type management.
2025-07-31 14:24:16 -07:00

95 lines
3.1 KiB
JavaScript

/**
* Type Utilities Example
*
* This example demonstrates how to use the Brainy library's type utility functions
* to access lists of noun and verb types at runtime.
*/
/* eslint-disable no-console */
// Import the Brainy library
import {
NounType,
VerbType,
getNounTypes,
getVerbTypes,
getNounTypeMap,
getVerbTypeMap
} from '@soulcraft/brainy'
// Example 1: Get a list of all noun types
console.log('=== All Noun Types ===')
const nounTypes = getNounTypes()
console.log(nounTypes)
console.log(`Total noun types: ${nounTypes.length}`)
console.log('\n')
// Example 2: Get a list of all verb types
console.log('=== All Verb Types ===')
const verbTypes = getVerbTypes()
console.log(verbTypes)
console.log(`Total verb types: ${verbTypes.length}`)
console.log('\n')
// Example 3: Get a map of noun type keys to values
console.log('=== Noun Type Map ===')
const nounTypeMap = getNounTypeMap()
console.log(nounTypeMap)
console.log('\n')
// Example 4: Get a map of verb type keys to values
console.log('=== Verb Type Map ===')
const verbTypeMap = getVerbTypeMap()
console.log(verbTypeMap)
console.log('\n')
// Example 5: Using specific noun types
console.log('=== Using Specific Noun Types ===')
console.log(`Person noun type: ${NounType.Person}`)
console.log(`Organization noun type: ${NounType.Organization}`)
console.log(`Location noun type: ${NounType.Location}`)
console.log('\n')
// Example 6: Using specific verb types
console.log('=== Using Specific Verb Types ===')
console.log(`RelatedTo verb type: ${VerbType.RelatedTo}`)
console.log(`Contains verb type: ${VerbType.Contains}`)
console.log(`PartOf verb type: ${VerbType.PartOf}`)
console.log('\n')
// Example 7: Checking if a value is a valid noun type
console.log('=== Checking Valid Noun Types ===')
const isValidNounType = (value) => nounTypes.includes(value)
console.log(`Is 'person' a valid noun type? ${isValidNounType('person')}`)
console.log(`Is 'invalid' a valid noun type? ${isValidNounType('invalid')}`)
console.log('\n')
// Example 8: Checking if a value is a valid verb type
console.log('=== Checking Valid Verb Types ===')
const isValidVerbType = (value) => verbTypes.includes(value)
console.log(`Is 'contains' a valid verb type? ${isValidVerbType('contains')}`)
console.log(`Is 'invalid' a valid verb type? ${isValidVerbType('invalid')}`)
console.log('\n')
// Example 9: Getting the key for a noun type value
console.log('=== Getting Noun Type Keys ===')
const getNounTypeKey = (value) => {
for (const [key, val] of Object.entries(nounTypeMap)) {
if (val === value) return key
}
return null
}
console.log(`Key for 'person' noun type: ${getNounTypeKey('person')}`)
console.log(`Key for 'organization' noun type: ${getNounTypeKey('organization')}`)
console.log('\n')
// Example 10: Getting the key for a verb type value
console.log('=== Getting Verb Type Keys ===')
const getVerbTypeKey = (value) => {
for (const [key, val] of Object.entries(verbTypeMap)) {
if (val === value) return key
}
return null
}
console.log(`Key for 'contains' verb type: ${getVerbTypeKey('contains')}`)
console.log(`Key for 'partOf' verb type: ${getVerbTypeKey('partOf')}`)