ai-database 2.1.3 → 2.3.0

package/dist/index.js

@@ -38,7 +38,9 @@ export {
 // Thing conversion utilities
 toExpanded, toFlat, 
 // Configuration
-setProvider, setNLQueryGenerator, 
+setProvider, setNLQueryGenerator, getNLQueryGenerator, 
+// AI Generation configuration
+configureAIGeneration, getAIGenerationConfig, 
 // Schema parsing
 parseSchema, 
 // Schema Definition
@@ -48,13 +50,29 @@ conjugate, pluralize, singularize, inferNoun, Type,
 // URL utilities
 resolveUrl, resolveShortUrl, parseUrl, 
 // Verb derivation
-FORWARD_TO_REVERSE, BIDIRECTIONAL_PAIRS, deriveReverseVerb, fieldNameToVerb, isPassiveVerb, registerVerbPair, registerBidirectionalPair, registerFieldVerb, } from './schema.js';
-export { MemoryProvider, createMemoryProvider, Semaphore, } from './memory-provider.js';
+FORWARD_TO_REVERSE, BIDIRECTIONAL_PAIRS, deriveReverseVerb, fieldNameToVerb, isPassiveVerb, registerVerbPair, registerBidirectionalPair, registerFieldVerb, 
+// Entity operations
+createEntityOperations, createEdgeEntityOperations, 
+// NL Query execution
+buildNLQueryContext, executeNLQuery, createNLQueryFn, 
+// Schema versioning
+computeSchemaHash, getSchemaVersion, setSchemaVersion, 
+// Schema diff
+diffSchemas, 
+// Migrations
+defineMigration, runMigrations, } from './schema.js';
+export { MemoryProvider, MemoryTransaction, createMemoryProvider, Semaphore, } from './memory-provider.js';
+export { DataLoader, createRequestLoader, getRequestLoader, clearRequestLoader, withDataLoader, loadEntity, } from './dataloader.js';
+export { createDigitalObjectsProvider } from './digital-objects-provider.js';
 // =============================================================================
 // Events API - Public event subscription and emission
 // =============================================================================
 // Export event utilities and constants
-export { StandardEventTypes, entityEvent, typePattern, actionPattern, } from './events.js';
+export { StandardEventTypes, entityEvent, typePattern, actionPattern } from './events.js';
+// =============================================================================
+// EventBridge - Cloudflare Queues integration
+// =============================================================================
+export { createEventBridge, createEventBridgeAPI } from './eventbridge.js';
 // =============================================================================
 // Actions API - Durable execution for long-running operations
 // =============================================================================
@@ -63,7 +81,11 @@ export { ActionStatuses, isTerminal, isInProgress, canRetry, canCancel, getProgr
 // Promise pipelining exports
 export { DBPromise, isDBPromise, getRawDBPromise, createListPromise, createEntityPromise, createSearchPromise, wrapEntityOperations, setProviderResolver, setSchemaRelationInfo, DB_PROMISE_SYMBOL, RAW_DB_PROMISE_SYMBOL, } from './ai-promise-db.js';
 // Semantic Search exports
-export { cosineSimilarity, computeRRF, extractEmbeddableText, generateContentHash, createMockSemanticProvider, } from './semantic.js';
+export { cosineSimilarity, computeRRF, extractEmbeddableText, generateContentHash, 
+// NOTE: createMockSemanticProvider has been moved to test utilities.
+// Import from '../test/utils/mock-semantic.js' for testing.
+// The export is kept here temporarily for backward compatibility but is deprecated.
+createMockSemanticProvider, } from './semantic.js';
 export { 
 // Standard definitions
 StandardHierarchies, StandardPermissions, CRUDPermissions, createStandardRoles, 
@@ -89,9 +111,87 @@ getBatchScheduler, setBatchScheduler, } from './durable-promise.js';
 // Execution queue for priority-based scheduling
 export { ExecutionQueue, createExecutionQueue, getDefaultQueue, setDefaultQueue, } from './execution-queue.js';
 // ClickHouse-backed durable provider
-export { ClickHouseDurableProvider, createClickHouseDurableProvider, } from './durable-clickhouse.js';
+export { ClickHouseDurableProvider, createClickHouseDurableProvider } from './durable-clickhouse.js';
 // =============================================================================
 // Generation Context - Context accumulation across cascading generations
 // =============================================================================
 export { GenerationContext, createGenerationContext, ContextOverflowError, } from './schema/generation-context.js';
+// =============================================================================
+// Error Handling - Custom error classes with context
+// =============================================================================
+export { 
+// Utility functions
+isNotFoundError, isEntityExistsError, isExpectedError, wrapDatabaseError, 
+// Base error class
+DatabaseError, 
+// Custom error classes
+EntityNotFoundError, EntityAlreadyExistsError, ValidationError, AIGenerationError, SemanticSearchError, VectorSearchUnavailableError, 
+// Capability errors (re-exported from provider-capabilities)
+CapabilityNotSupportedError, isCapabilityNotSupportedError, } from './errors.js';
+// =============================================================================
+// Provider Capabilities - Runtime feature detection
+// =============================================================================
+export { detectCapabilities, requireCapability, warnIfUnavailable, clearCapabilityCache, clearWarningHistory, PROVIDER_CAPABILITY_MATRIX, } from './provider-capabilities.js';
+export { createMemoryProvider as createDigitalObjectsMemoryProvider } from 'digital-objects';
+// =============================================================================
+// Shared Constants
+// =============================================================================
+export { RelationOperator, DEFAULT_EMBEDDING_DIMENSIONS, EMBEDDING_DIMENSIONS, } from './constants.js';
+// =============================================================================
+// RDB Provider Adapter - Bridges RDB and ai-database DBProvider interfaces
+// =============================================================================
+export { RDBProviderAdapter, createRDBAdapter } from './rdb-provider-adapter.js';
+// =============================================================================
+// DO SQLite Adapter — Stack B transactional DBProvider
+// =============================================================================
+// Per ADR-0003: per-cascade DO isolation gives parallel write paths each at
+// full single-DO throughput, the enabling pattern for cascade-heavy workloads.
+export { DOSqliteAdapter, createDOSqliteAdapter, ShardingStrategies } from './do-sqlite-adapter.js';
+// =============================================================================
+// Postgres + pgvector Adapter — Stack A transactional DBProvider
+// =============================================================================
+// Per ADR-0003: Stack A's transactional layer. Bulk-VALUES CTE write path
+// (91ms p50 for 500 docs+499 rels via Neon HTTP per substrate-write-probes).
+export { PostgresProvider, createPostgresProvider, createNeonHttpExecutor, createPgClientExecutor, bootstrapSchema as bootstrapPostgresSchema, } from './pg-adapter.js';
+// =============================================================================
+// ClickHouse Adapter — Stack A analytics DBProvider
+// =============================================================================
+// Per ADR-0003: Tier 3 first-class on ClickHouse. Native vector functions for
+// Tier 4 (up to 64,000 dims; cosine/L2/dot). Bulk JSONEachRow write path.
+export { ClickHouseProvider, createClickHouseProvider, createClickHouseHttpFetcher, bootstrapClickHouseSchema, } from './ch-adapter.js';
+// =============================================================================
+// Cascade Write Strategy — sharded parallel writes (Phase 2 entry; aip-g1i9)
+// =============================================================================
+// Per ADR-0003: cascade orchestrator must write through a partition-aware
+// adapter. This module is the *primitive* the orchestrator (`aip-8yal`) calls.
+// PG path uses the CTE jsonb-bulk shape proven by the substrate-write-probes
+// (91ms p50 / 500 docs+499 rels on Neon HTTP); DO SQLite path routes through
+// the per-cascade DO via the adapter's `withContext` binding.
+export { CascadeWriteStrategy, CascadeShardingStrategies, createCascadeWriteStrategy, buildPgCommitBatchSql, resolveDOIdName, chunkBatch, } from './cascade-write-strategy.js';
+// =============================================================================
+// Pipelines → Iceberg analytical fan-out emitter (aip-0ypt)
+// =============================================================================
+// Per ADR-0003: Stack B's dual-write pattern. DO SQLite is the transactional
+// source of truth; Cloudflare Pipelines fans out into R2 Iceberg as the
+// analytical SOR. The emitter is fire-and-forget on the cascade hot path —
+// failures are logged and swallowed so analytical fan-out can never break
+// cascade correctness.
+export { createPipelinesIcebergEmitter, createHttpPipelinesIcebergEmitter, } from './pipelines-iceberg-emitter.js';
+// =============================================================================
+// Cascade Orchestrator — the moat work (aip-8yal)
+// =============================================================================
+// Real LLM-driven cascade generation built on the canonical SVO foundation:
+// AIPromise-style generate() from ai-functions, ModelPolicy from
+// language-models for retry/fallback, BatchProvider-shaped sibling-parallel
+// fan-out, CascadeWriteStrategy for sharded writes, embed-on-write, and
+// rubric-style $validate with four verdict policies. Replaces the
+// PlaceholderValueGenerator path for the SVO surface.
+export { generateCascade, buildEmbedText, CascadeValidationEscalation, } from './cascade-orchestrator.js';
+// =============================================================================
+// DBProvider Port — SVO-shaped contract with declared capability tiers
+// =============================================================================
+// Per ADR-0003: Tier 1+2 are universal (shape unchanged from `schema/provider`);
+// Tier 3 (analytics) and Tier 4 (vector search) are declared per-adapter.
+// Sharding model is declared so cascade write strategy can pick the right adapter.
+export { DEFAULT_TIER_CAPABILITIES, getProviderCapabilities, hasActionRecording, hasVerbRegistry, hasVectorSearch, hasAnalytics, } from './db-provider-port.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AA8EhC,OAAO;AACL,6BAA6B;AAC7B,UAAU,EACV,MAAM;AACN,gBAAgB;AAChB,WAAW,EACX,mBAAmB;AACnB,iBAAiB;AACjB,WAAW;AACX,oBAAoB;AACpB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,KAAK;AACL,eAAe;AACf,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,IAAI;AACJ,gBAAgB;AAChB,UAAU,EACV,eAAe,EACf,QAAQ;AACR,kBAAkB;AAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,SAAS,GACV,MAAM,sBAAsB,CAAA;AAc7B,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF,uCAAuC;AACvC,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAA;AAIpB,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF,wCAAwC;AACxC,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAIrB,6BAA6B;AAC7B,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAU3B,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,eAAe,CAAA;AA4DtB,OAAO;AACL,uBAAuB;AACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB;AAEnB,0BAA0B;AAC1B,cAAc,EACd,eAAe,EACf,iBAAiB;AAEjB,mBAAmB;AACnB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe;AAEf,qBAAqB;AACrB,aAAa,EACb,gBAAgB;AAEhB,mBAAmB;AACnB,2BAA2B;AAE3B,QAAQ;AACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAmC3B,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF,+BAA+B;AAC/B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,sBAAsB;AACtB,qBAAqB;AACrB,iBAAiB,EACjB,WAAW,EACX,iBAAiB;AACjB,kBAAkB;AAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAS7B,gDAAgD;AAChD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAY7B,qCAAqC;AACrC,OAAO,EACL,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,yBAAyB,CAAA;AAOhC,gFAAgF;AAChF,yEAAyE;AACzE,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/linguistic.d.ts

@@ -1,115 +1,10 @@
 /**
- * Linguistic Helpers
+ * Linguistic utilities - re-exported from @graphdl/core
  *
- * Utilities for verb conjugation, noun pluralization, and linguistic inference.
+ * Provides verb conjugation, noun pluralization, and linguistic inference.
  * Used for auto-generating forms, events, and semantic metadata.
  *
  * @packageDocumentation
  */
-import { Verbs, type Noun, type Verb, type TypeMeta } from './types.js';
-/**
- * Auto-conjugate a verb from just the base form
- *
- * Given just "publish", generates all forms:
- * - actor: publisher
- * - act: publishes
- * - activity: publishing
- * - result: publication
- * - reverse: { at: publishedAt, by: publishedBy, ... }
- *
- * @example
- * ```ts
- * conjugate('publish')
- * // => { action: 'publish', actor: 'publisher', act: 'publishes', activity: 'publishing', ... }
- *
- * conjugate('create')
- * // => { action: 'create', actor: 'creator', act: 'creates', activity: 'creating', ... }
- * ```
- */
-export declare function conjugate(action: string): Verb;
-/**
- * Auto-pluralize a noun
- *
- * @example
- * ```ts
- * pluralize('post')     // => 'posts'
- * pluralize('category') // => 'categories'
- * pluralize('person')   // => 'people'
- * pluralize('child')    // => 'children'
- * ```
- */
-export declare function pluralize(singular: string): string;
-/**
- * Auto-singularize a noun (reverse of pluralize)
- *
- * @example
- * ```ts
- * singularize('posts')      // => 'post'
- * singularize('categories') // => 'category'
- * singularize('people')     // => 'person'
- * ```
- */
-export declare function singularize(plural: string): string;
-/**
- * Infer a complete Noun from just a type name
- *
- * @example
- * ```ts
- * inferNoun('BlogPost')
- * // => { singular: 'blog post', plural: 'blog posts', ... }
- *
- * inferNoun('Category')
- * // => { singular: 'category', plural: 'categories', ... }
- * ```
- */
-export declare function inferNoun(typeName: string): Noun;
-/**
- * Create TypeMeta from a type name - all linguistic forms auto-inferred
- *
- * @example
- * ```ts
- * const meta = createTypeMeta('BlogPost')
- * meta.singular  // 'blog post'
- * meta.plural    // 'blog posts'
- * meta.slug      // 'blog-post'
- * meta.created   // 'BlogPost.created'
- * meta.createdAt // 'createdAt'
- * meta.creator   // 'creator'
- * ```
- */
-export declare function createTypeMeta(typeName: string): TypeMeta;
-/**
- * Get or create TypeMeta for a type name (cached)
- */
-export declare function getTypeMeta(typeName: string): TypeMeta;
-/**
- * Type proxy - provides dynamic access to type metadata
- *
- * @example
- * ```ts
- * const Post = Type('Post')
- * Post.singular  // 'post'
- * Post.plural    // 'posts'
- * Post.created   // 'Post.created'
- *
- * // In event handlers:
- * on.create(thing => {
- *   console.log(thing.$type.plural)  // 'posts'
- * })
- * ```
- */
-export declare function Type(name: string): TypeMeta;
-/**
- * Get reverse property names for a verb action
- *
- * @example
- * ```ts
- * getVerbFields('create')
- * // => { at: 'createdAt', by: 'createdBy', in: 'createdIn', for: 'createdFor' }
- *
- * getVerbFields('publish')
- * // => { at: 'publishedAt', by: 'publishedBy' }
- * ```
- */
-export declare function getVerbFields(action: keyof typeof Verbs): Record<string, string>;
+export { conjugate, pluralize, singularize, inferNoun, createTypeMeta, getTypeMeta, Type, getVerbFields, capitalize, preserveCase, isVowel, splitCamelCase, toKebabCase, toPastParticiple, toActor, toPresent, toGerund, toResult, clearTypeMetaCache, } from '@graphdl/core';
 //# sourceMappingURL=linguistic.d.ts.map

package/dist/linguistic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linguistic.d.ts","sourceRoot":"","sources":["../src/linguistic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AA0GvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsB9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsDlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoDlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAwBzD;AAKD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAOtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhF"}
+{"version":3,"file":"linguistic.d.ts","sourceRoot":"","sources":["../src/linguistic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,WAAW,EACX,IAAI,EACJ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,OAAO,EACP,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,kBAAkB,GACnB,MAAM,eAAe,CAAA"}

package/dist/linguistic.js

@@ -1,379 +1,10 @@
 /**
- * Linguistic Helpers
+ * Linguistic utilities - re-exported from @graphdl/core
  *
- * Utilities for verb conjugation, noun pluralization, and linguistic inference.
+ * Provides verb conjugation, noun pluralization, and linguistic inference.
  * Used for auto-generating forms, events, and semantic metadata.
  *
  * @packageDocumentation
  */
-import { Verbs } from './types.js';
-// =============================================================================
-// Internal Helpers
-// =============================================================================
-function capitalize(s) {
-    return s.charAt(0).toUpperCase() + s.slice(1);
-}
-function preserveCase(original, replacement) {
-    if (original[0] === original[0]?.toUpperCase()) {
-        return capitalize(replacement);
-    }
-    return replacement;
-}
-function isVowel(char) {
-    return char ? 'aeiou'.includes(char.toLowerCase()) : false;
-}
-function splitCamelCase(s) {
-    return s.replace(/([a-z])([A-Z])/g, '$1 $2').split(' ');
-}
-/** Check if we should double the final consonant (CVC pattern) */
-function shouldDoubleConsonant(verb) {
-    if (verb.length < 2)
-        return false;
-    const last = verb[verb.length - 1];
-    const secondLast = verb[verb.length - 2];
-    // Don't double w, x, y
-    if ('wxy'.includes(last))
-        return false;
-    // Must end in consonant preceded by vowel
-    if (isVowel(last) || !isVowel(secondLast))
-        return false;
-    // Common verbs that double the final consonant
-    const doublingVerbs = ['submit', 'commit', 'permit', 'omit', 'admit', 'emit', 'transmit', 'refer', 'prefer', 'defer', 'occur', 'recur', 'begin', 'stop', 'drop', 'shop', 'plan', 'scan', 'ban', 'run', 'gun', 'stun', 'cut', 'shut', 'hit', 'sit', 'fit', 'spit', 'quit', 'knit', 'get', 'set', 'pet', 'wet', 'bet', 'let', 'put', 'drag', 'brag', 'flag', 'tag', 'bag', 'nag', 'wag', 'hug', 'bug', 'mug', 'tug', 'rub', 'scrub', 'grab', 'stab', 'rob', 'sob', 'throb', 'nod', 'prod', 'plod', 'plot', 'rot', 'blot', 'spot', 'knot', 'trot', 'chat', 'pat', 'bat', 'mat', 'rat', 'slap', 'clap', 'flap', 'tap', 'wrap', 'snap', 'trap', 'cap', 'map', 'nap', 'zap', 'tip', 'sip', 'dip', 'rip', 'zip', 'slip', 'trip', 'drip', 'chip', 'clip', 'flip', 'grip', 'ship', 'skip', 'whip', 'strip', 'equip', 'hop', 'pop', 'mop', 'cop', 'chop', 'crop', 'prop', 'flop', 'swim', 'trim', 'slim', 'skim', 'dim', 'rim', 'brim', 'grim', 'hem', 'stem', 'jam', 'cram', 'ram', 'slam', 'dam', 'ham', 'scam', 'spam', 'tram', 'hum', 'drum', 'strum', 'sum', 'gum', 'chum', 'plum'];
-    // Short words (3 letters) almost always double
-    if (verb.length <= 3)
-        return true;
-    // Check if verb matches any known doubling pattern
-    return doublingVerbs.some(v => verb === v || verb.endsWith(v));
-}
-/** Convert verb to past participle (create → created, publish → published) */
-function toPastParticiple(verb) {
-    if (verb.endsWith('e'))
-        return verb + 'd';
-    if (verb.endsWith('y') && !isVowel(verb[verb.length - 2])) {
-        return verb.slice(0, -1) + 'ied';
-    }
-    if (shouldDoubleConsonant(verb)) {
-        return verb + verb[verb.length - 1] + 'ed';
-    }
-    return verb + 'ed';
-}
-/** Convert verb to actor noun (create → creator, publish → publisher) */
-function toActor(verb) {
-    if (verb.endsWith('e'))
-        return verb + 'r';
-    if (verb.endsWith('y') && !isVowel(verb[verb.length - 2])) {
-        return verb.slice(0, -1) + 'ier';
-    }
-    if (shouldDoubleConsonant(verb)) {
-        return verb + verb[verb.length - 1] + 'er';
-    }
-    return verb + 'er';
-}
-/** Convert verb to present 3rd person (create → creates, publish → publishes) */
-function toPresent(verb) {
-    if (verb.endsWith('y') && !isVowel(verb[verb.length - 2])) {
-        return verb.slice(0, -1) + 'ies';
-    }
-    if (verb.endsWith('s') || verb.endsWith('x') || verb.endsWith('z') ||
-        verb.endsWith('ch') || verb.endsWith('sh')) {
-        return verb + 'es';
-    }
-    return verb + 's';
-}
-/** Convert verb to gerund (create → creating, publish → publishing) */
-function toGerund(verb) {
-    if (verb.endsWith('ie'))
-        return verb.slice(0, -2) + 'ying';
-    if (verb.endsWith('e') && !verb.endsWith('ee'))
-        return verb.slice(0, -1) + 'ing';
-    if (shouldDoubleConsonant(verb)) {
-        return verb + verb[verb.length - 1] + 'ing';
-    }
-    return verb + 'ing';
-}
-/** Convert verb to result noun (create → creation, publish → publication) */
-function toResult(verb) {
-    // Common -ate → -ation
-    if (verb.endsWith('ate'))
-        return verb.slice(0, -1) + 'ion';
-    // Common -ify → -ification
-    if (verb.endsWith('ify'))
-        return verb.slice(0, -1) + 'ication';
-    // Common -ize → -ization
-    if (verb.endsWith('ize'))
-        return verb.slice(0, -1) + 'ation';
-    // Common -e → -ion (but not always correct)
-    if (verb.endsWith('e'))
-        return verb.slice(0, -1) + 'ion';
-    // Default: just add -ion
-    return verb + 'ion';
-}
-// =============================================================================
-// Public API
-// =============================================================================
-/**
- * Auto-conjugate a verb from just the base form
- *
- * Given just "publish", generates all forms:
- * - actor: publisher
- * - act: publishes
- * - activity: publishing
- * - result: publication
- * - reverse: { at: publishedAt, by: publishedBy, ... }
- *
- * @example
- * ```ts
- * conjugate('publish')
- * // => { action: 'publish', actor: 'publisher', act: 'publishes', activity: 'publishing', ... }
- *
- * conjugate('create')
- * // => { action: 'create', actor: 'creator', act: 'creates', activity: 'creating', ... }
- * ```
- */
-export function conjugate(action) {
-    // Check if it's a known verb first
-    if (action in Verbs) {
-        return Verbs[action];
-    }
-    const base = action.toLowerCase();
-    const pastParticiple = toPastParticiple(base);
-    return {
-        action: base,
-        actor: toActor(base),
-        act: toPresent(base),
-        activity: toGerund(base),
-        result: toResult(base),
-        reverse: {
-            at: `${pastParticiple}At`,
-            by: `${pastParticiple}By`,
-            in: `${pastParticiple}In`,
-            for: `${pastParticiple}For`,
-        },
-    };
-}
-/**
- * Auto-pluralize a noun
- *
- * @example
- * ```ts
- * pluralize('post')     // => 'posts'
- * pluralize('category') // => 'categories'
- * pluralize('person')   // => 'people'
- * pluralize('child')    // => 'children'
- * ```
- */
-export function pluralize(singular) {
-    const lower = singular.toLowerCase();
-    // Irregular plurals
-    const irregulars = {
-        person: 'people',
-        child: 'children',
-        man: 'men',
-        woman: 'women',
-        foot: 'feet',
-        tooth: 'teeth',
-        goose: 'geese',
-        mouse: 'mice',
-        ox: 'oxen',
-        leaf: 'leaves',
-        life: 'lives',
-        knife: 'knives',
-        wife: 'wives',
-        half: 'halves',
-        self: 'selves',
-        calf: 'calves',
-        analysis: 'analyses',
-        crisis: 'crises',
-        thesis: 'theses',
-        datum: 'data',
-        medium: 'media',
-        criterion: 'criteria',
-        phenomenon: 'phenomena',
-    };
-    if (irregulars[lower]) {
-        return preserveCase(singular, irregulars[lower]);
-    }
-    // Rules for regular plurals
-    if (lower.endsWith('y') && !isVowel(lower[lower.length - 2])) {
-        return singular.slice(0, -1) + 'ies';
-    }
-    // Words ending in z that double: quiz → quizzes, fez → fezzes
-    if (lower.endsWith('z') && !lower.endsWith('zz')) {
-        return singular + 'zes';
-    }
-    if (lower.endsWith('s') || lower.endsWith('x') || lower.endsWith('zz') ||
-        lower.endsWith('ch') || lower.endsWith('sh')) {
-        return singular + 'es';
-    }
-    if (lower.endsWith('f')) {
-        return singular.slice(0, -1) + 'ves';
-    }
-    if (lower.endsWith('fe')) {
-        return singular.slice(0, -2) + 'ves';
-    }
-    return singular + 's';
-}
-/**
- * Auto-singularize a noun (reverse of pluralize)
- *
- * @example
- * ```ts
- * singularize('posts')      // => 'post'
- * singularize('categories') // => 'category'
- * singularize('people')     // => 'person'
- * ```
- */
-export function singularize(plural) {
-    const lower = plural.toLowerCase();
-    // Irregular singulars
-    const irregulars = {
-        people: 'person',
-        children: 'child',
-        men: 'man',
-        women: 'woman',
-        feet: 'foot',
-        teeth: 'tooth',
-        geese: 'goose',
-        mice: 'mouse',
-        oxen: 'ox',
-        leaves: 'leaf',
-        lives: 'life',
-        knives: 'knife',
-        wives: 'wife',
-        halves: 'half',
-        selves: 'self',
-        calves: 'calf',
-        analyses: 'analysis',
-        crises: 'crisis',
-        theses: 'thesis',
-        data: 'datum',
-        media: 'medium',
-        criteria: 'criterion',
-        phenomena: 'phenomenon',
-    };
-    if (irregulars[lower]) {
-        return preserveCase(plural, irregulars[lower]);
-    }
-    // Rules for regular singulars
-    if (lower.endsWith('ies')) {
-        return plural.slice(0, -3) + 'y';
-    }
-    if (lower.endsWith('ves')) {
-        return plural.slice(0, -3) + 'f';
-    }
-    if (lower.endsWith('es') && (lower.endsWith('sses') || lower.endsWith('xes') || lower.endsWith('zes') ||
-        lower.endsWith('ches') || lower.endsWith('shes'))) {
-        return plural.slice(0, -2);
-    }
-    if (lower.endsWith('s') && !lower.endsWith('ss')) {
-        return plural.slice(0, -1);
-    }
-    return plural;
-}
-/**
- * Infer a complete Noun from just a type name
- *
- * @example
- * ```ts
- * inferNoun('BlogPost')
- * // => { singular: 'blog post', plural: 'blog posts', ... }
- *
- * inferNoun('Category')
- * // => { singular: 'category', plural: 'categories', ... }
- * ```
- */
-export function inferNoun(typeName) {
-    const words = splitCamelCase(typeName);
-    const singular = words.join(' ').toLowerCase();
-    const plural = words.slice(0, -1).concat(pluralize(words[words.length - 1])).join(' ').toLowerCase();
-    return {
-        singular,
-        plural,
-        actions: ['create', 'update', 'delete'],
-        events: ['created', 'updated', 'deleted'],
-    };
-}
-/**
- * Create TypeMeta from a type name - all linguistic forms auto-inferred
- *
- * @example
- * ```ts
- * const meta = createTypeMeta('BlogPost')
- * meta.singular  // 'blog post'
- * meta.plural    // 'blog posts'
- * meta.slug      // 'blog-post'
- * meta.created   // 'BlogPost.created'
- * meta.createdAt // 'createdAt'
- * meta.creator   // 'creator'
- * ```
- */
-export function createTypeMeta(typeName) {
-    const noun = inferNoun(typeName);
-    const slug = noun.singular.replace(/\s+/g, '-');
-    const slugPlural = noun.plural.replace(/\s+/g, '-');
-    return {
-        name: typeName,
-        singular: noun.singular,
-        plural: noun.plural,
-        slug,
-        slugPlural,
-        // From Verbs.create
-        creator: 'creator',
-        createdAt: 'createdAt',
-        createdBy: 'createdBy',
-        updatedAt: 'updatedAt',
-        updatedBy: 'updatedBy',
-        // Event types
-        created: `${typeName}.created`,
-        updated: `${typeName}.updated`,
-        deleted: `${typeName}.deleted`,
-    };
-}
-/** Cache of TypeMeta by type name */
-const typeMetaCache = new Map();
-/**
- * Get or create TypeMeta for a type name (cached)
- */
-export function getTypeMeta(typeName) {
-    let meta = typeMetaCache.get(typeName);
-    if (!meta) {
-        meta = createTypeMeta(typeName);
-        typeMetaCache.set(typeName, meta);
-    }
-    return meta;
-}
-/**
- * Type proxy - provides dynamic access to type metadata
- *
- * @example
- * ```ts
- * const Post = Type('Post')
- * Post.singular  // 'post'
- * Post.plural    // 'posts'
- * Post.created   // 'Post.created'
- *
- * // In event handlers:
- * on.create(thing => {
- *   console.log(thing.$type.plural)  // 'posts'
- * })
- * ```
- */
-export function Type(name) {
-    return getTypeMeta(name);
-}
-/**
- * Get reverse property names for a verb action
- *
- * @example
- * ```ts
- * getVerbFields('create')
- * // => { at: 'createdAt', by: 'createdBy', in: 'createdIn', for: 'createdFor' }
- *
- * getVerbFields('publish')
- * // => { at: 'publishedAt', by: 'publishedBy' }
- * ```
- */
-export function getVerbFields(action) {
-    return Verbs[action]?.reverse ?? {};
-}
+export { conjugate, pluralize, singularize, inferNoun, createTypeMeta, getTypeMeta, Type, getVerbFields, capitalize, preserveCase, isVowel, splitCamelCase, toKebabCase, toPastParticiple, toActor, toPresent, toGerund, toResult, clearTypeMetaCache, } from '@graphdl/core';
 //# sourceMappingURL=linguistic.js.map