semantic-primitives 0.1.0

package/dist/shared/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/shared/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/shared/types.d.ts

@@ -0,0 +1,335 @@
+/**
+ * Shared types used across semantic primitives
+ */
+/**
+ * Base interface for results that include a confidence score.
+ * Used across all semantic primitives.
+ */
+export interface ConfidenceResult {
+    confidence: number;
+}
+/**
+ * Result of semantic equality comparison.
+ * Used by: SemanticString, SemanticNumber, SemanticBoolean, SemanticBigInt,
+ * SemanticNull, SemanticUndefined, SemanticSymbol, SemanticArray, SemanticObject,
+ * SemanticMap, SemanticSet, SemanticDate, SemanticError, SemanticURL, SemanticRegExp,
+ * SemanticPromise, SemanticFunction, SemanticTuple, SemanticRecord, SemanticCallable,
+ * SemanticConstructable, SemanticObjectLiteral
+ */
+export interface SemanticEqualsResult extends ConfidenceResult {
+    equivalent: boolean;
+}
+/**
+ * Extended semantic equals result with additional context.
+ * Used by: SemanticSymbol, SemanticError, SemanticTuple
+ */
+export interface SemanticEqualsResultWithReason extends SemanticEqualsResult {
+    reason?: string;
+    note?: string;
+}
+/**
+ * Extended semantic equals result with key/value mappings.
+ * Used by: SemanticObject, SemanticMap, SemanticSet, SemanticRecord, SemanticObjectLiteral
+ */
+export interface SemanticEqualsResultWithMappings extends SemanticEqualsResult {
+    mappings?: Record<string, string>;
+}
+/**
+ * Result of semantic classification into categories.
+ * Used by: SemanticString, SemanticSymbol, SemanticURL, SemanticError
+ */
+export interface ClassifyResult extends ConfidenceResult {
+    category: string;
+    subcategory?: string;
+}
+/**
+ * Result of detecting/inferring the type of a value.
+ * Used by: SemanticObject, SemanticArray, SemanticSet, SemanticRegExp, SemanticUnknown
+ */
+export interface InferTypeResult extends ConfidenceResult {
+    type: string;
+}
+/**
+ * Result of inferring purpose or intent.
+ * Used by: SemanticFunction, SemanticMap, SemanticRecord, SemanticCallable
+ */
+export interface InferPurposeResult extends ConfidenceResult {
+    purpose: string;
+    category?: string;
+    subcategory?: string;
+}
+/**
+ * Basic validation result with issues list.
+ * Used by: SemanticString, SemanticFunction, SemanticCallable, SemanticSymbol
+ */
+export interface ValidateResult {
+    valid: boolean;
+    issues: string[];
+}
+/**
+ * Validation result with warnings in addition to issues.
+ * Used by: SemanticRegExp, SemanticSymbol
+ */
+export interface ValidateResultWithWarnings extends ValidateResult {
+    warnings: string[];
+}
+/**
+ * Result of checking if a value is reasonable for a context.
+ * Used by: SemanticNumber, SemanticBigInt, SemanticDate
+ */
+export interface ReasonableResult {
+    reasonable: boolean;
+    explanation?: string;
+    reason?: string;
+}
+/**
+ * Result of checking if something is appropriate for a use case.
+ * Used by: SemanticSymbol, SemanticNull, SemanticVoid
+ */
+export interface AppropriateResult {
+    appropriate: boolean;
+    reason: string;
+}
+/**
+ * A single suggestion with reason.
+ * Used by: SemanticObject, SemanticMap, SemanticSet, SemanticRecord
+ */
+export interface Suggestion {
+    suggestion?: string;
+    reason: string;
+}
+/**
+ * Suggestion for a missing field/key.
+ * Used by: SemanticObject, SemanticMap, SemanticRecord
+ */
+export interface MissingSuggestion {
+    field?: string;
+    key?: string;
+    property?: string;
+    reason: string;
+}
+/**
+ * Suggestion for related items.
+ * Used by: SemanticSet, SemanticURL, SemanticRegExp
+ */
+export interface RelatedSuggestion {
+    value?: string;
+    url?: string;
+    pattern?: string;
+    reason: string;
+}
+/**
+ * Suggestion for improvements with optional code.
+ * Used by: SemanticFunction, SemanticRegExp, SemanticCallable, SemanticConstructable
+ */
+export interface ImprovementSuggestion {
+    suggestion: string;
+    reason: string;
+    code?: string;
+    improved?: string;
+}
+/**
+ * Correction suggestion for text.
+ * Used by: SemanticString
+ */
+export interface Correction {
+    original: string;
+    suggestion: string;
+    reason?: string;
+}
+/**
+ * Result of semantic property/key access.
+ * Used by: SemanticObject, SemanticMap, SemanticRecord
+ */
+export interface SemanticGetResult<K = string, V = unknown> extends ConfidenceResult {
+    value: V | undefined;
+    matchedKey: K | undefined;
+}
+/**
+ * Result of semantic search/find operations.
+ * Used by: SemanticArray, SemanticMap, SemanticRecord, SemanticSet
+ */
+export interface SearchResult<T> {
+    item?: T;
+    key?: string;
+    value?: T;
+    relevance: number;
+}
+/**
+ * Standard severity levels.
+ * Used by: SemanticURL, SemanticError, SemanticAny, SemanticCallable
+ */
+export type SeverityLevel = "low" | "medium" | "high";
+/**
+ * Extended severity levels including info.
+ * Used by: SemanticCallable
+ */
+export type ExtendedSeverityLevel = "info" | "warning" | "error";
+/**
+ * Error severity levels.
+ * Used by: SemanticError
+ */
+export type ErrorSeverityLevel = "critical" | "error" | "warning" | "info";
+/**
+ * Result of safety assessment.
+ * Used by: SemanticURL, SemanticFunction, SemanticCallable, SemanticAny
+ */
+export interface SafetyResult {
+    safe: boolean;
+    reason?: string;
+    severity?: SeverityLevel;
+}
+/**
+ * Result of sensitive data detection.
+ * Used by: SemanticString, SemanticObject, SemanticObjectLiteral
+ */
+export interface SensitiveResult {
+    sensitive?: boolean;
+    hasSensitive?: boolean;
+    types?: string[];
+    type?: string;
+    recommendation?: string;
+}
+/**
+ * Result of intent detection.
+ * Used by: SemanticString
+ */
+export interface DetectIntentResult extends ConfidenceResult {
+    intent: string;
+    subtype?: string;
+    topic?: string;
+}
+/**
+ * Result of language detection.
+ * Used by: SemanticString
+ */
+export interface DetectLanguageResult extends ConfidenceResult {
+    language: string;
+}
+/**
+ * Result of pattern detection.
+ * Used by: SemanticArray, SemanticTuple, SemanticConstructable
+ */
+export interface DetectPatternResult extends ConfidenceResult {
+    pattern?: string;
+    patterns?: string[];
+    suggestedType?: string;
+}
+/**
+ * Result of inferring a unit for a numeric value.
+ * Used by: SemanticNumber
+ */
+export interface InferUnitResult extends ConfidenceResult {
+    unit: string;
+}
+/**
+ * Result of inferring domain/context.
+ * Used by: SemanticBigInt
+ */
+export interface InferDomainResult extends ConfidenceResult {
+    domain: string;
+}
+/**
+ * Result of inferring meaning.
+ * Used by: SemanticDate
+ */
+export interface InferMeaningResult extends ConfidenceResult {
+    meaning: string;
+    type: string;
+}
+/**
+ * Result of inferring a reason (for null/undefined).
+ * Used by: SemanticNull, SemanticUndefined
+ */
+export interface InferReasonResult {
+    reason: string;
+    type: string;
+}
+/**
+ * Result of inferring schema.
+ * Used by: SemanticObject, SemanticObjectLiteral
+ */
+export interface InferSchemaResult extends ConfidenceResult {
+    type?: string;
+    name?: string;
+    properties: Record<string, string | {
+        type: string;
+        purpose?: string;
+        format?: string;
+    }>;
+    required?: string[];
+    optional?: string[];
+    fields?: Record<string, {
+        type: string;
+        purpose: string;
+        format?: string;
+    }>;
+}
+/**
+ * Result with explanation and alternatives.
+ * Used by: SemanticAny
+ */
+export interface ExplanationResult {
+    explanation: string;
+    alternatives?: string[];
+}
+/**
+ * Duration description result.
+ * Used by: SemanticDate
+ */
+export interface DurationResult {
+    description: string;
+    days: number;
+    businessDays?: number;
+}
+/**
+ * A detected issue with severity.
+ * Used by: SemanticFunction, SemanticCallable
+ */
+export interface DetectedIssue {
+    issue: string;
+    severity: ExtendedSeverityLevel;
+}
+/**
+ * Result of root cause analysis.
+ * Used by: SemanticError
+ */
+export interface RootCauseResult extends ConfidenceResult {
+    cause: string;
+}
+/**
+ * Suggested fix for an error.
+ * Used by: SemanticError
+ */
+export interface SuggestedFix extends ConfidenceResult {
+    fix: string;
+    code?: string;
+}
+/**
+ * Recovery strategy for errors.
+ * Used by: SemanticError
+ */
+export interface RecoveryStrategy {
+    strategy: "retry" | "fallback" | "abort" | "ignore";
+    maxAttempts?: number;
+    backoff?: string;
+}
+/**
+ * Generated test case.
+ * Used by: SemanticFunction, SemanticCallable, SemanticRegExp
+ */
+export interface GeneratedTestCase<TInput = unknown[], TOutput = unknown> {
+    input?: TInput;
+    inputs?: TInput;
+    expectedOutput?: TOutput;
+    description: string;
+}
+/**
+ * Test cases for regex validation.
+ * Used by: SemanticRegExp
+ */
+export interface RegExpTestCases {
+    shouldMatch: string[];
+    shouldNotMatch: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/types/array/array.d.ts

@@ -0,0 +1,250 @@
+/**
+ * SemanticArray
+ * An array type with LLM-powered semantic understanding
+ *
+ * Implements shared interfaces:
+ * - Semantic<T[]> - Base semantic wrapper
+ * - Comparable<SemanticArray<T>> - Semantic equality comparison
+ * - Validatable - Validation against semantic rules
+ * - Summarizable - Content summarization
+ * - SemanticFilterable - Natural language filtering
+ * - SemanticSortable - Semantic sorting
+ * - SemanticGroupable - Semantic grouping
+ * - SemanticSearchable - Semantic search
+ * - PatternDetectable - Pattern detection
+ * - TypeInferable - Element type inference
+ */
+import type { LLMClient } from '../../llm/client.ts';
+import type { SemanticEqualsResultWithReason, SearchResult, InferTypeResult } from '../../shared/types.ts';
+import type { Semantic, Comparable } from '../../shared/interfaces.ts';
+export type { SemanticEqualsResultWithReason, SearchResult, InferTypeResult, } from '../../shared/types.ts';
+/** Options for semantic equality comparison */
+export interface ArraySemanticEqualsOptions {
+    orderMatters?: boolean;
+    threshold?: number;
+}
+/** Options for semantic search */
+export interface SemanticSearchOptions {
+    limit?: number;
+}
+/** Options for summarization */
+export interface SummarizeOptions {
+    maxLength?: number;
+    focus?: string;
+}
+/** Options for semantic unique (deduplication) */
+export interface SemanticUniqueOptions {
+    threshold?: number;
+}
+/** Validation result with per-element issues */
+export interface ArrayValidateResult {
+    valid: boolean;
+    issues: {
+        index: number;
+        problems: string[];
+    }[];
+}
+/** Extended element type inference result with optional fields */
+export interface ArrayInferTypeResult extends InferTypeResult {
+    fields?: string[];
+}
+/** Extended pattern detection result with anomalies */
+export interface ArrayDetectPatternResult {
+    patterns: string[];
+    anomalies: {
+        index: number;
+        reason: string;
+    }[];
+    confidence: number;
+}
+/**
+ * SemanticArray - Array with LLM-powered semantic understanding
+ *
+ * Unlike traditional arrays that only support index-based operations,
+ * semantic arrays can filter, group, sort, and search using natural
+ * language criteria.
+ *
+ * @template T - The type of elements in the array
+ */
+export declare class SemanticArray<T> implements Semantic<T[]>, Comparable<SemanticArray<T> | T[], SemanticEqualsResultWithReason> {
+    private readonly elements;
+    private readonly client;
+    private constructor();
+    /**
+     * Create a SemanticArray from an existing array
+     */
+    static from<T>(array: T[], client?: LLMClient): SemanticArray<T>;
+    /**
+     * Create an empty SemanticArray
+     */
+    static empty<T>(client?: LLMClient): SemanticArray<T>;
+    /**
+     * Create a SemanticArray from variadic arguments
+     */
+    static of<T>(...items: T[]): SemanticArray<T>;
+    /**
+     * Get the underlying array value
+     */
+    valueOf(): T[];
+    /**
+     * Get the length of the array
+     */
+    get length(): number;
+    /**
+     * Get element at index
+     */
+    at(index: number): T | undefined;
+    /**
+     * Check if two arrays are semantically equivalent.
+     * Considers element meaning, order significance, and context.
+     *
+     * @param other - Array to compare with
+     * @param options - Comparison options
+     * @returns Equivalence result with confidence and optional note
+     */
+    semanticallyEquals(other: SemanticArray<T> | T[], options?: ArraySemanticEqualsOptions): Promise<SemanticEqualsResultWithReason>;
+    /**
+     * Filter elements using natural language criteria.
+     *
+     * @param criteria - Natural language filter condition
+     * @returns Filtered SemanticArray
+     */
+    semanticFilter(criteria: string): Promise<SemanticArray<T>>;
+    /**
+     * Group elements by semantic similarity or criteria.
+     *
+     * @param criteria - Grouping criteria (natural language or field name)
+     * @returns Map of groups
+     */
+    semanticGroup(criteria: string): Promise<Map<string, SemanticArray<T>>>;
+    /**
+     * Sort elements using semantic understanding.
+     *
+     * @param criteria - Natural language sort criteria
+     * @returns Sorted SemanticArray
+     */
+    semanticSort(criteria: string): Promise<SemanticArray<T>>;
+    /**
+     * Find elements matching semantic criteria.
+     *
+     * @param criteria - Natural language search criteria
+     * @param options - Search options
+     * @returns Matching elements with relevance scores
+     */
+    semanticSearch(criteria: string, options?: SemanticSearchOptions): Promise<SearchResult<T>[]>;
+    /**
+     * Detect patterns in the array data.
+     *
+     * @returns Detected patterns and anomalies
+     */
+    detectPatterns(): Promise<ArrayDetectPatternResult>;
+    /**
+     * Summarize the array contents.
+     *
+     * @param options - Summary options
+     * @returns Human-readable summary
+     */
+    summarize(options?: SummarizeOptions): Promise<string>;
+    /**
+     * Remove semantic duplicates (items with same meaning).
+     *
+     * @param options - Deduplication options
+     * @returns Deduplicated array
+     */
+    semanticUnique(options?: SemanticUniqueOptions): Promise<SemanticArray<T>>;
+    /**
+     * Validate all elements against semantic rules.
+     *
+     * @param rules - Natural language validation rules
+     * @returns Validation result
+     */
+    validate(rules: string[]): Promise<ArrayValidateResult>;
+    /**
+     * Enrich each element with additional semantic information.
+     *
+     * @param enrichments - Fields to add with descriptions
+     * @returns Enriched array
+     */
+    enrich<E extends Record<string, string>>(enrichments: E): Promise<SemanticArray<T & {
+        [K in keyof E]: string;
+    }>>;
+    /**
+     * Detect the semantic type of array elements.
+     *
+     * @returns Inferred element type
+     */
+    inferElementType(): Promise<ArrayInferTypeResult>;
+    /**
+     * Infer type - alias for inferElementType for interface compatibility
+     */
+    inferType(): Promise<InferTypeResult>;
+    /**
+     * Map elements and return a new SemanticArray
+     */
+    map<U>(fn: (element: T, index: number, array: T[]) => U): SemanticArray<U>;
+    /**
+     * Filter elements using a predicate and return a new SemanticArray
+     */
+    filter(predicate: (element: T, index: number, array: T[]) => boolean): SemanticArray<T>;
+    /**
+     * Concatenate with another array or SemanticArray
+     */
+    concat(...items: (T | T[] | SemanticArray<T>)[]): SemanticArray<T>;
+    /**
+     * Get a slice of the array
+     */
+    slice(start?: number, end?: number): SemanticArray<T>;
+    /**
+     * Reverse the array
+     */
+    reverse(): SemanticArray<T>;
+    /**
+     * Reduce the array to a single value
+     */
+    reduce<U>(fn: (acc: U, element: T, index: number, array: T[]) => U, initial: U): U;
+    /**
+     * Check if some element satisfies the predicate
+     */
+    some(predicate: (element: T, index: number, array: T[]) => boolean): boolean;
+    /**
+     * Check if every element satisfies the predicate
+     */
+    every(predicate: (element: T, index: number, array: T[]) => boolean): boolean;
+    /**
+     * Find an element matching the predicate
+     */
+    find(predicate: (element: T, index: number, array: T[]) => boolean): T | undefined;
+    /**
+     * Find the index of an element matching the predicate
+     */
+    findIndex(predicate: (element: T, index: number, array: T[]) => boolean): number;
+    /**
+     * Check if array includes an element
+     */
+    includes(element: T): boolean;
+    /**
+     * Get the index of an element
+     */
+    indexOf(element: T): number;
+    /**
+     * Execute a function for each element
+     */
+    forEach(fn: (element: T, index: number, array: T[]) => void): void;
+    /**
+     * Flat map the array
+     */
+    flatMap<U>(fn: (element: T, index: number, array: T[]) => U | U[]): SemanticArray<U>;
+    /**
+     * Iterator support
+     */
+    [Symbol.iterator](): Iterator<T>;
+    /**
+     * Convert to string
+     */
+    toString(): string;
+    /**
+     * Convert to JSON
+     */
+    toJSON(): T[];
+}
+//# sourceMappingURL=array.d.ts.map

package/dist/types/array/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/types/array/array.ts"],"names":[],"mappings":"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"}

package/dist/types/array/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SemanticArray module
+ * LLM-enhanced array type with semantic understanding
+ */
+export { SemanticArray, type ArraySemanticEqualsOptions, type SemanticSearchOptions, type SummarizeOptions, type SemanticUniqueOptions, type ArrayValidateResult, type ArrayInferTypeResult, type ArrayDetectPatternResult, type SemanticEqualsResultWithReason, type SearchResult, type InferTypeResult, } from './array.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/array/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/array/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACnC,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}