semantic-primitives 0.1.0

package/dist/types/text-codec/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SemanticTextCodec module exports
+ *
+ * Provides LLM-enhanced text encoding/decoding capabilities:
+ * - SemanticTextEncoder: Enhanced TextEncoder with analysis
+ * - SemanticTextDecoder: Enhanced TextDecoder with detection and repair
+ * - SemanticTextCodec: Static utility methods for encoding operations
+ */
+export { SemanticTextEncoder, SemanticTextDecoder, SemanticTextCodec, } from './text-codec.ts';
+export type { TextCodecLLMClientInterface, EncodeWithAnalysisResult, CanEncodeResult, DetectEncodingResult, DecodeWithAnalysisResult, RepairMojibakeResult, AreEquivalentResult, TranscodeResult, EncodingIssue, ValidateEncodingResult, SuggestEncodingResult, ExplainErrorResult, } from './text-codec.ts';
+export type { ConfidenceResult } from '../../shared/types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/text-codec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/text-codec/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/text-codec/prompts.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Prompts for SemanticTextCodec LLM operations
+ * These prompts are used for encoding detection, mojibake repair, and other text codec operations
+ */
+/**
+ * System prompt for encoding detection
+ */
+export declare const DETECT_ENCODING_SYSTEM = "You are a text encoding detection specialist. Your task is to analyze byte patterns and determine the most likely character encoding.\n\nConsider these common encodings and their characteristics:\n- UTF-8: Variable-width, ASCII-compatible, most common for web content\n- UTF-16LE/BE: Fixed 2+ bytes per character, often has BOM\n- ISO-8859-1 (Latin-1): Single-byte Western European encoding\n- Windows-1252: Superset of ISO-8859-1 with extra characters\n- Shift-JIS: Japanese encoding, variable-width\n- EUC-JP: Japanese encoding, variable-width\n- GB2312/GBK/GB18030: Chinese encodings\n- EUC-KR: Korean encoding\n- KOI8-R: Russian encoding\n\nLook for patterns like:\n- Byte Order Marks (BOM)\n- Invalid byte sequences for certain encodings\n- Statistical distribution of byte values\n- Multi-byte sequence patterns\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for encoding detection
+ */
+export declare function detectEncodingPrompt(bytePreview: string, byteLength: number): string;
+/**
+ * System prompt for mojibake repair
+ */
+export declare const REPAIR_MOJIBAKE_SYSTEM = "You are a text encoding corruption repair specialist. Your task is to detect and repair mojibake - text that has been decoded with the wrong encoding.\n\nCommon mojibake patterns:\n- UTF-8 decoded as ISO-8859-1/Windows-1252: \"\u00C3\u00A9\" instead of \"\u00E9\", \"\u00C3\u00A8\" instead of \"\u00E8\"\n- Double-encoded UTF-8: Text encoded to UTF-8 twice\n- UTF-8 decoded as Shift-JIS: Japanese characters appearing as garbage\n- Windows-1252 decoded as UTF-8: Replacement characters appearing\n\nSteps to repair:\n1. Identify the corruption pattern\n2. Determine the original encoding\n3. Determine the incorrect decoding path\n4. Suggest the repaired text\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for mojibake repair
+ */
+export declare function repairMojibakePrompt(text: string): string;
+/**
+ * System prompt for encoding validation
+ */
+export declare const VALIDATE_ENCODING_SYSTEM = "You are a text encoding validation specialist. Your task is to verify if byte sequences are valid for a specified encoding.\n\nFor each encoding, check:\n- UTF-8: Valid multi-byte sequences, proper continuation bytes\n- UTF-16: Valid surrogate pairs, proper byte order\n- ISO-8859-1: All single bytes are valid (0x00-0xFF)\n- Windows-1252: Valid character positions (0x80-0x9F has specific mappings)\n- Shift-JIS: Valid lead/trail byte combinations\n- Other encodings: Encoding-specific validation rules\n\nReport specific issues with byte positions.\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for encoding validation
+ */
+export declare function validateEncodingPrompt(bytePreview: string, encoding: string, byteLength: number): string;
+/**
+ * System prompt for encoding suggestion
+ */
+export declare const SUGGEST_ENCODING_SYSTEM = "You are a text encoding recommendation specialist. Your task is to suggest the best encoding for text content based on its characters and any constraints.\n\nConsider these factors:\n- Character coverage: What characters need to be encoded?\n- Compatibility: Legacy systems, email, URLs, etc.\n- Efficiency: Byte size for the content\n- Standards: Modern standards prefer UTF-8\n- Interoperability: Cross-platform compatibility\n\nCommon recommendations:\n- For web content: UTF-8 (universal, widely supported)\n- For email: UTF-8 with proper MIME headers, or ASCII with encoding\n- For legacy Windows apps: Windows-1252\n- For Japanese: UTF-8, or Shift-JIS for legacy\n- For Chinese: UTF-8, or GB18030 for legacy\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for encoding suggestion
+ */
+export declare function suggestEncodingPrompt(text: string, constraints?: {
+    compatibility?: string;
+}): string;
+/**
+ * System prompt for encoding error explanation
+ */
+export declare const EXPLAIN_ERROR_SYSTEM = "You are a text encoding error diagnosis specialist. Your task is to explain encoding errors in plain language and suggest solutions.\n\nCommon encoding errors:\n- \"Invalid byte sequence\": Data doesn't match expected encoding\n- \"Unmappable character\": Character can't be represented in target encoding\n- \"Truncated multi-byte sequence\": Incomplete UTF-8 or other multi-byte character\n- \"Invalid UTF-8 continuation byte\": Byte sequence violates UTF-8 rules\n- \"BOM mismatch\": Byte Order Mark doesn't match declared encoding\n\nFor each error:\n1. Explain what went wrong in simple terms\n2. Identify the likely cause\n3. Suggest a practical solution\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for error explanation
+ */
+export declare function explainErrorPrompt(errorMessage: string, contextHex?: string): string;
+/**
+ * System prompt for checking if text can be encoded
+ */
+export declare const CAN_ENCODE_SYSTEM = "You are a text encoding compatibility specialist. Your task is to determine if text can be encoded in a specific encoding without data loss.\n\nCheck for:\n- Characters outside the encoding's repertoire\n- Characters that would require substitution or escaping\n- Unicode normalization issues\n\nFor each problematic character, explain why it can't be encoded.\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for can encode check
+ */
+export declare function canEncodePrompt(text: string, encoding: string): string;
+/**
+ * System prompt for checking buffer equivalence
+ */
+export declare const ARE_EQUIVALENT_SYSTEM = "You are a text encoding equivalence specialist. Your task is to determine if two encoded byte buffers represent the same text, even if they use different encodings.\n\nConsider:\n- Different encodings of the same text\n- Byte Order Marks (BOM) differences\n- Unicode normalization differences (NFC vs NFD)\n- Line ending differences (CRLF vs LF)\n\nDetermine if the buffers are semantically equivalent (represent the same text content).\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for buffer equivalence
+ */
+export declare function areEquivalentPrompt(bytes1Hex: string, bytes2Hex: string, decoded1: string, decoded2: string): string;
+/**
+ * System prompt for decode analysis
+ */
+export declare const DECODE_WITH_ANALYSIS_SYSTEM = "You are a text decoding analysis specialist. Your task is to analyze decoded text and identify any issues or repairs that were made.\n\nLook for:\n- Replacement characters (U+FFFD) indicating decoding errors\n- Signs of mojibake that might need repair\n- Encoding mismatches between declared and actual encoding\n- Invalid character sequences that were sanitized\n\nReport all issues found during decoding.\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for decode analysis
+ */
+export declare function decodeWithAnalysisPrompt(text: string, declaredEncoding: string, detectedEncoding: string): string;
+/**
+ * System prompt for encode analysis
+ */
+export declare const ENCODE_WITH_ANALYSIS_SYSTEM = "You are a text encoding analysis specialist. Your task is to analyze text that will be encoded and identify potential issues.\n\nCheck for:\n- Non-ASCII characters that might cause issues in some systems\n- Characters that might be normalized differently\n- Potential encoding compatibility issues\n- Characters that might need escaping\n\nProvide warnings for any potential issues.\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt for encode analysis
+ */
+export declare function encodeWithAnalysisPrompt(text: string, encoding: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/text-codec/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/text-codec/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB,81BAmBE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQpF;AAMD;;GAEG;AACH,eAAO,MAAM,sBAAsB,gsBAcE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASzD;AAMD;;GAEG;AACH,eAAO,MAAM,wBAAwB,mlBAYA,CAAC;AAEtC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAWxG;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB,svBAgBC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAapG;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,isBAcI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAapF;AAMD;;GAEG;AACH,eAAO,MAAM,iBAAiB,qZASO,CAAC;AAEtC;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtE;AAMD;;GAEG;AACH,eAAO,MAAM,qBAAqB,ieAUG,CAAC;AAEtC;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAMD;;GAEG;AACH,eAAO,MAAM,2BAA2B,mcAUH,CAAC;AAEtC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AAMD;;GAEG;AACH,eAAO,MAAM,2BAA2B,2aAUH,CAAC;AAEtC;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU/E"}

package/dist/types/text-codec/text-codec.d.ts

@@ -0,0 +1,305 @@
+/**
+ * SemanticTextCodec - LLM-enhanced text encoding/decoding types
+ *
+ * Provides semantic wrappers for TextEncoder and TextDecoder with:
+ * - Intelligent encoding detection
+ * - Mojibake (encoding corruption) repair
+ * - Cross-encoding operations
+ * - Validation and suggestions
+ *
+ * Includes three classes:
+ * - SemanticTextEncoder: Enhanced TextEncoder with analysis capabilities
+ * - SemanticTextDecoder: Enhanced TextDecoder with detection and repair
+ * - SemanticTextCodec: Static utility methods for encoding operations
+ */
+import type { LLMConfig, Message } from '../../llm/types.ts';
+import type { ConfidenceResult } from '../../shared/types.ts';
+type BufferSourceType = ArrayBuffer | Uint8Array | DataView;
+/** LLM client interface for dependency injection */
+export interface TextCodecLLMClientInterface {
+    chat(options: {
+        messages: Message[];
+        systemPrompt?: string;
+    } & LLMConfig): Promise<{
+        content: string;
+    }>;
+}
+/** Result of encoding with analysis */
+export interface EncodeWithAnalysisResult {
+    bytes: Uint8Array;
+    warnings: string[];
+    hasNonAscii: boolean;
+    byteLength: number;
+}
+/** Result of checking if text can be encoded */
+export interface CanEncodeResult {
+    canEncode: boolean;
+    problematicChars: string[];
+    suggestedEncoding?: string;
+}
+/** Result of encoding detection */
+export interface DetectEncodingResult extends ConfidenceResult {
+    encoding: string;
+    alternatives: string[];
+}
+/** Result of decoding with analysis */
+export interface DecodeWithAnalysisResult {
+    text: string;
+    detectedEncoding: string;
+    repaired: boolean;
+    issues: string[];
+}
+/** Result of mojibake repair */
+export interface RepairMojibakeResult extends ConfidenceResult {
+    repaired: string;
+    corruptionPath: string[];
+}
+/** Result of buffer equivalence check */
+export interface AreEquivalentResult extends ConfidenceResult {
+    equivalent: boolean;
+    note?: string;
+}
+/** Result of transcoding */
+export interface TranscodeResult {
+    bytes: Uint8Array;
+    fromEncoding: string;
+    lossless: boolean;
+    substitutions: {
+        char: string;
+        replacement: string;
+    }[];
+}
+/** Encoding validation issue */
+export interface EncodingIssue {
+    position: number;
+    issue: string;
+}
+/** Result of encoding validation */
+export interface ValidateEncodingResult {
+    valid: boolean;
+    issues: EncodingIssue[];
+}
+/** Result of encoding suggestion */
+export interface SuggestEncodingResult {
+    encoding: string;
+    reason: string;
+    alternatives: string[];
+}
+/** Result of error explanation */
+export interface ExplainErrorResult {
+    explanation: string;
+    likelyCause: string;
+    solution: string;
+}
+/**
+ * SemanticTextEncoder - Enhanced TextEncoder with analysis capabilities
+ *
+ * Extends TextEncoder functionality with:
+ * - Encoding analysis and warnings
+ * - Character compatibility checking
+ * - LLM-powered encoding recommendations
+ */
+export declare class SemanticTextEncoder {
+    private readonly _encoder;
+    private readonly _encoding;
+    private readonly _llmClient;
+    private readonly _llmConfig?;
+    /**
+     * Create a SemanticTextEncoder instance
+     *
+     * @param encoding - Target encoding (defaults to UTF-8, the only encoding TextEncoder supports)
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     */
+    constructor(encoding?: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig);
+    /**
+     * Create a SemanticTextEncoder with optional encoding validation.
+     *
+     * @param encoding - Target encoding (defaults to UTF-8)
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns SemanticTextEncoder instance
+     */
+    static create(encoding?: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): SemanticTextEncoder;
+    /**
+     * Encode text to bytes (delegates to native TextEncoder)
+     *
+     * @param text - Text to encode
+     * @returns Encoded bytes
+     */
+    encode(text: string): Uint8Array;
+    /**
+     * Encode text into an existing buffer (delegates to native TextEncoder)
+     *
+     * @param text - Text to encode
+     * @param destination - Destination buffer
+     * @returns Result with read and written counts
+     */
+    encodeInto(text: string, destination: Uint8Array): {
+        read: number;
+        written: number;
+    };
+    /**
+     * Encode text with validation and warnings.
+     *
+     * @param text - Text to encode
+     * @returns Encoded bytes with metadata
+     */
+    encodeWithAnalysis(text: string): EncodeWithAnalysisResult;
+    /**
+     * Check if text can be encoded without loss.
+     * Uses LLM for intelligent analysis of encoding compatibility.
+     *
+     * @param text - Text to check
+     * @param encoding - Target encoding (defaults to instance encoding)
+     * @returns Analysis result
+     */
+    canEncode(text: string, encoding?: string): Promise<CanEncodeResult>;
+    /**
+     * Get the encoding name
+     */
+    get encoding(): string;
+}
+/**
+ * SemanticTextDecoder - Enhanced TextDecoder with detection and repair capabilities
+ *
+ * Extends TextDecoder functionality with:
+ * - Automatic encoding detection
+ * - Mojibake (encoding corruption) repair
+ * - Decoding analysis and issue reporting
+ */
+export declare class SemanticTextDecoder {
+    private readonly _decoder;
+    private readonly _encoding;
+    private readonly _autoDetect;
+    private readonly _llmClient;
+    private readonly _llmConfig?;
+    /**
+     * Create a SemanticTextDecoder instance
+     *
+     * @param encoding - Encoding or "auto" for detection
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     */
+    constructor(encoding?: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig);
+    /**
+     * Create a SemanticTextDecoder with auto-detection capability.
+     *
+     * @param encoding - Encoding or "auto" for detection
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns SemanticTextDecoder instance
+     */
+    static create(encoding?: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): SemanticTextDecoder;
+    /**
+     * Decode bytes to text (delegates to native TextDecoder)
+     *
+     * @param bytes - Bytes to decode
+     * @returns Decoded text
+     */
+    decode(bytes?: BufferSourceType): string;
+    /**
+     * Detect the encoding of a byte buffer using LLM analysis.
+     *
+     * @param bytes - Bytes to analyze
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Encoding detection result
+     */
+    static detectEncoding(bytes: BufferSourceType, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<DetectEncodingResult>;
+    /**
+     * Decode with encoding detection and repair.
+     *
+     * @param bytes - Bytes to decode
+     * @returns Decoded text with metadata
+     */
+    decodeWithAnalysis(bytes: BufferSourceType): Promise<DecodeWithAnalysisResult>;
+    /**
+     * Detect and repair mojibake (encoding corruption).
+     *
+     * @param text - Potentially corrupted text
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Repair result
+     */
+    static repairMojibake(text: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<RepairMojibakeResult>;
+    /**
+     * Get the encoding name
+     */
+    get encoding(): string;
+    /**
+     * Check if auto-detection is enabled
+     */
+    get isAutoDetect(): boolean;
+}
+/**
+ * SemanticTextCodec - Static utility methods for encoding operations
+ *
+ * Provides LLM-enhanced encoding utilities:
+ * - Cross-encoding equivalence checking
+ * - Transcoding with smart fallbacks
+ * - Encoding validation
+ * - Encoding suggestions
+ * - Error explanation
+ */
+export declare class SemanticTextCodec {
+    /** Private constructor to prevent instantiation */
+    private constructor();
+    /**
+     * Check if two encoded buffers represent the same text.
+     *
+     * @param bytes1 - First buffer
+     * @param bytes2 - Second buffer
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Equivalence result
+     */
+    static areEquivalent(bytes1: BufferSourceType, bytes2: BufferSourceType, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<AreEquivalentResult>;
+    /**
+     * Transcode between encodings with smart fallbacks.
+     *
+     * @param bytes - Source bytes
+     * @param options - Transcode options
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Transcoded bytes
+     */
+    static transcode(bytes: BufferSourceType, options: {
+        from?: string;
+        to: string;
+    }, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<TranscodeResult>;
+    /**
+     * Validate text encoding integrity.
+     *
+     * @param bytes - Bytes to validate
+     * @param expectedEncoding - Expected encoding
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Validation result
+     */
+    static validateEncoding(bytes: BufferSourceType, expectedEncoding: string, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<ValidateEncodingResult>;
+    /**
+     * Suggest the best encoding for text content.
+     *
+     * @param text - Text to analyze
+     * @param constraints - Constraints on encoding choice
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Encoding recommendation
+     */
+    static suggestEncoding(text: string, constraints?: {
+        compatibility?: string;
+    }, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<SuggestEncodingResult>;
+    /**
+     * Explain encoding issues in plain language.
+     *
+     * @param error - Encoding error or issue
+     * @param context - Additional context
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns Human-readable explanation
+     */
+    static explainError(error: Error, context?: BufferSourceType, llmClient?: TextCodecLLMClientInterface, llmConfig?: LLMConfig): Promise<ExplainErrorResult>;
+}
+export {};
+//# sourceMappingURL=text-codec.d.ts.map

package/dist/types/text-codec/text-codec.d.ts.map

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

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

@@ -0,0 +1,6 @@
+/**
+ * SemanticTuple module
+ * LLM-enhanced tuple type with semantic understanding
+ */
+export { SemanticTuple, type PositionalMeaning, type InferPositionalMeaningResult, type ValidateRelationshipResult, type ToObjectResult, type GetByLabelResult, type StructureIssue, type ValidateStructureResult, type SemanticEqualsResultWithReason, type DetectPatternResult, } from './tuple.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/tuple/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/dist/types/tuple/prompts.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Prompts for SemanticTuple LLM operations
+ * These prompts enable semantic operations on tuple types
+ */
+/**
+ * System prompt for tuple semantic operations
+ */
+export declare const TUPLE_SYSTEM_PROMPT = "You are a semantic tuple analyzer. Your task is to analyze tuples (fixed-length heterogeneous sequences) and understand their positional meaning.\n\nYou must respond with valid JSON only, no additional text or explanation.\n\nGuidelines:\n- Tuples have fixed length and each position typically has a specific meaning\n- Consider common tuple patterns: coordinates (lat/lng), ranges (start/end), RGB colors, key-value pairs, etc.\n- Analyze the relationship between elements at different positions\n- Provide confidence scores from 0.0 to 1.0\n- Be precise and consistent in your analysis";
+/**
+ * Prompt for semantic equality comparison
+ */
+export declare function createSemanticallyEqualsPrompt(tuple1: unknown[], tuple2: unknown[], labels1?: string[], labels2?: string[]): string;
+/**
+ * Prompt for inferring positional meaning
+ */
+export declare function createInferPositionalMeaningPrompt(tuple: unknown[], labels?: string[], context?: string): string;
+/**
+ * Prompt for validating relationships between elements
+ */
+export declare function createValidateRelationshipPrompt(tuple: unknown[], rules: string[], labels?: string[]): string;
+/**
+ * Prompt for detecting tuple pattern
+ */
+export declare function createDetectPatternPrompt(tuple: unknown[], labels?: string[]): string;
+/**
+ * Prompt for converting tuple to labeled object
+ */
+export declare function createToObjectPrompt(tuple: unknown[], partialLabels?: string[]): string;
+/**
+ * Prompt for getting element by semantic label
+ */
+export declare function createGetByLabelPrompt(tuple: unknown[], label: string, existingLabels?: string[]): string;
+/**
+ * Prompt for validating tuple structure
+ */
+export declare function createValidateStructurePrompt(tuple: unknown[], expectedTypes: string[], labels?: string[]): string;
+/**
+ * Prompt for explaining tuple
+ */
+export declare function createExplainPrompt(tuple: unknown[], labels?: string[], context?: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/tuple/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/tuple/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,glBASa,CAAC;AAE9C;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAoCR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EAAE,EAChB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EAAE,EAChB,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CA6BR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA2BR"}