@twinfinity/printing 5.0.3-ci.28538-beta

package/dist/layout/templateVariables.js

@@ -0,0 +1,295 @@
+/**
+ * Template variable extraction, validation, and resolution.
+ *
+ * This module provides utilities for working with parameterized templates:
+ * - Extract variable definitions for UI generation
+ * - Get default values (fail-safe fallback)
+ * - Resolve user-provided values with validation
+ * - Apply variables to template (substitute {{vars.*}} references)
+ *
+ * @module templateVariables
+ */
+/**
+ * Extract all variable definitions from a template.
+ *
+ * Returns an array of variable info objects suitable for UI generation.
+ * Returns empty array if template has no variables.
+ *
+ * @param template - Layout template (may or may not have variables)
+ * @returns Array of variable definitions with metadata
+ *
+ * @example
+ * ```typescript
+ * const vars = getTemplateVariables(template);
+ * // [
+ * //   { name: 'hyresobjektsnummer', type: 'string', default: '2022-F2008', label: 'Hyresobjekt', ... },
+ * //   { name: 'showLegend', type: 'boolean', default: true, label: 'Show Legend', ... }
+ * // ]
+ *
+ * // Use for UI generation
+ * vars.forEach(v => {
+ *   if (v.type === 'string') {
+ *     renderTextField(v.label, v.default);
+ *   } else if (v.type === 'boolean') {
+ *     renderCheckbox(v.label, v.default);
+ *   }
+ * });
+ * ```
+ */
+export function getTemplateVariables(template) {
+    if (!template.variables)
+        return [];
+    return Object.entries(template.variables).map(([name, def]) => ({
+        name,
+        type: def.type,
+        default: def.default,
+        label: def.label ?? name,
+        description: def.description,
+        format: def.format,
+        min: def.min,
+        max: def.max,
+        step: def.step,
+        minLength: def.minLength,
+        maxLength: def.maxLength,
+        pattern: def.pattern,
+        enum: def.enum,
+        items: def.items
+    }));
+}
+/**
+ * Extract all default values from a template.
+ *
+ * Returns an object with all variable names mapped to their default values.
+ * These defaults are guaranteed to work - template can always render with them.
+ *
+ * Returns empty object if template has no variables.
+ *
+ * @param template - Layout template
+ * @returns Object mapping variable names to default values
+ *
+ * @example
+ * ```typescript
+ * const defaults = getTemplateDefaults(template);
+ * // { hyresobjektsnummer: '2022-F2008', showLegend: true, scaleDenom: 100 }
+ *
+ * // Can always render with defaults (fail-safe)
+ * const { svg } = await renderDrawing({
+ *   template,
+ *   models,
+ *   variables: defaults  // Guaranteed to work
+ * });
+ * ```
+ */
+export function getTemplateDefaults(template) {
+    if (!template.variables)
+        return {};
+    const defaults = {};
+    for (const [name, def] of Object.entries(template.variables)) {
+        defaults[name] = def.default;
+    }
+    return defaults;
+}
+/**
+ * Validate a value against a variable definition.
+ *
+ * Checks type and constraint validation (min/max, pattern, enum, etc.).
+ *
+ * @param value - Value to validate
+ * @param varDef - Variable definition with constraints
+ * @returns Validation result with ok flag and optional error message
+ */
+function validateVariable(value, varDef) {
+    // Type check
+    const actualType = Array.isArray(value) ? 'array' : typeof value;
+    if (varDef.type === 'number' && actualType !== 'number') {
+        return { ok: false, error: `Expected number, got ${actualType}` };
+    }
+    if (varDef.type === 'string' && actualType !== 'string') {
+        return { ok: false, error: `Expected string, got ${actualType}` };
+    }
+    if (varDef.type === 'boolean' && actualType !== 'boolean') {
+        return { ok: false, error: `Expected boolean, got ${actualType}` };
+    }
+    if (varDef.type === 'array' && actualType !== 'array') {
+        return { ok: false, error: `Expected array, got ${actualType}` };
+    }
+    // String validation
+    if (varDef.type === 'string' && typeof value === 'string') {
+        if (varDef.minLength !== undefined && value.length < varDef.minLength) {
+            return { ok: false, error: `String too short (min ${varDef.minLength})` };
+        }
+        if (varDef.maxLength !== undefined && value.length > varDef.maxLength) {
+            return { ok: false, error: `String too long (max ${varDef.maxLength})` };
+        }
+        if (varDef.pattern) {
+            try {
+                const regex = new RegExp(varDef.pattern);
+                if (!regex.test(value)) {
+                    return { ok: false, error: `Does not match pattern ${varDef.pattern}` };
+                }
+            }
+            catch {
+                return { ok: false, error: `Invalid pattern: ${varDef.pattern}` };
+            }
+        }
+        if (varDef.enum && !varDef.enum.includes(value)) {
+            return { ok: false, error: `Not in allowed values: ${varDef.enum.join(', ')}` };
+        }
+    }
+    // Number validation
+    if (varDef.type === 'number' && typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            return { ok: false, error: 'Must be a finite number' };
+        }
+        if (varDef.min !== undefined && value < varDef.min) {
+            return { ok: false, error: `Too small (min ${varDef.min})` };
+        }
+        if (varDef.max !== undefined && value > varDef.max) {
+            return { ok: false, error: `Too large (max ${varDef.max})` };
+        }
+    }
+    return { ok: true };
+}
+/**
+ * Resolve template variables by merging user values with defaults.
+ *
+ * This is a **fail-safe** function:
+ * - Missing values → use default
+ * - Invalid values → use default + warn
+ * - Unknown variables → warn + ignore
+ *
+ * The result is ALWAYS valid and complete (safe to use for rendering).
+ *
+ * @param template - Layout template with variable definitions
+ * @param userValues - Optional user-provided values (can be partial or undefined)
+ * @returns Object with resolved values and any validation warnings
+ *
+ * @example
+ * ```typescript
+ * // User provides partial values
+ * const { values, warnings } = resolveTemplateValues(template, {
+ *   hyresobjektsnummer: '2022-F2009'  // Valid
+ *   // Other vars use defaults
+ * });
+ * // values = { hyresobjektsnummer: '2022-F2009', showLegend: true, scaleDenom: 100 }
+ * // warnings = []
+ *
+ * // User provides invalid value
+ * const { values, warnings } = resolveTemplateValues(template, {
+ *   scaleDenom: 9999  // Out of range (max: 500)
+ * });
+ * // values = { scaleDenom: 100, ... }  ← Fell back to default
+ * // warnings = ["Invalid 'scaleDenom': Too large (max 500) - using default '100'"]
+ *
+ * // Always safe to render
+ * const resolvedTemplate = applyTemplateVariables(template, values);
+ * ```
+ */
+export function resolveTemplateValues(template, userValues) {
+    const defaults = getTemplateDefaults(template);
+    const warnings = [];
+    // Start with all defaults (fail-safe!)
+    const values = { ...defaults };
+    // No user values or no variables → return defaults
+    if (!userValues || !template.variables) {
+        return { values, warnings };
+    }
+    // Merge and validate user values
+    for (const [name, value] of Object.entries(userValues)) {
+        const varDef = template.variables[name];
+        // Unknown variable
+        if (!varDef) {
+            warnings.push(`Unknown variable '${name}' - ignoring`);
+            continue;
+        }
+        // Validate value
+        const validation = validateVariable(value, varDef);
+        if (!validation.ok) {
+            warnings.push(`Invalid '${name}': ${validation.error} - using default '${defaults[name]}'`);
+            continue;
+        }
+        // Valid → use it
+        values[name] = value;
+    }
+    return { values, warnings };
+}
+/**
+ * Apply variables to a template by substituting {{vars.*}} references.
+ *
+ * Recursively scans the template and replaces all {{vars.variableName}} references
+ * with the corresponding values from the provided values object.
+ *
+ * Returns a new template with all variables resolved (does not mutate input).
+ *
+ * @param template - Original template with {{vars.*}} references
+ * @param values - Resolved variable values (from resolveTemplateValues)
+ * @returns New template with all {{vars.*}} replaced by actual values
+ *
+ * @example
+ * ```typescript
+ * const template = {
+ *   elements: [
+ *     { kind: 'text', text: 'Hyresobjekt: {{vars.hyresobjektsnummer}}' },
+ *     { kind: 'viewport', clip: { where: { 'BIP.id': '{{vars.hyresobjektsnummer}}' } } }
+ *   ]
+ * };
+ *
+ * const values = { hyresobjektsnummer: '2022-F2009' };
+ * const resolved = applyTemplateVariables(template, values);
+ * // {
+ * //   elements: [
+ * //     { kind: 'text', text: 'Hyresobjekt: 2022-F2009' },
+ * //     { kind: 'viewport', clip: { where: { 'BIP.id': '2022-F2009' } } }
+ * //   ]
+ * // }
+ * ```
+ */
+export function applyTemplateVariables(template, values) {
+    // Deep clone to avoid mutation
+    const resolved = JSON.parse(JSON.stringify(template));
+    // Recursively replace {{vars.*}} in all string values
+    function replaceInValue(obj) {
+        if (typeof obj === 'string') {
+            return interpolateVariables(obj, values);
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(replaceInValue);
+        }
+        if (obj && typeof obj === 'object') {
+            const result = {};
+            for (const [key, val] of Object.entries(obj)) {
+                result[key] = replaceInValue(val);
+            }
+            return result;
+        }
+        return obj;
+    }
+    // Apply to all template properties that might contain variable references
+    resolved.elements = replaceInValue(resolved.elements);
+    if (resolved.assets) {
+        resolved.assets = replaceInValue(resolved.assets);
+    }
+    return resolved;
+}
+/**
+ * Interpolate {{vars.*}} references in a string.
+ *
+ * Replaces all occurrences of {{vars.variableName}} with the corresponding value.
+ * If variable is not found, keeps the placeholder and logs a warning.
+ *
+ * @param str - String potentially containing {{vars.*}} references
+ * @param values - Variable values
+ * @returns String with all {{vars.*}} replaced
+ */
+function interpolateVariables(str, values) {
+    return str.replace(/\{\{vars\.(\w+)\}\}/g, (match, varName) => {
+        if (varName in values) {
+            const value = values[varName];
+            // Convert to string (handles numbers, booleans, etc.)
+            return String(value);
+        }
+        console.warn(`[templateVariables] Variable '${varName}' not found - keeping placeholder`);
+        return match; // Keep {{vars.varName}} as-is
+    });
+}
+//# sourceMappingURL=templateVariables.js.map

package/dist/layout/templateVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateVariables.js","sourceRoot":"/","sources":["layout/templateVariables.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Template variable extraction, validation, and resolution.\r\n *\r\n * This module provides utilities for working with parameterized templates:\r\n * - Extract variable definitions for UI generation\r\n * - Get default values (fail-safe fallback)\r\n * - Resolve user-provided values with validation\r\n * - Apply variables to template (substitute {{vars.*}} references)\r\n *\r\n * @module templateVariables\r\n */\r\n\r\nimport type { LayoutTemplate, TemplateVariableDef, TemplateVariableInfo } from './types';\r\n\r\n/**\r\n * Extract all variable definitions from a template.\r\n *\r\n * Returns an array of variable info objects suitable for UI generation.\r\n * Returns empty array if template has no variables.\r\n *\r\n * @param template - Layout template (may or may not have variables)\r\n * @returns Array of variable definitions with metadata\r\n *\r\n * @example\r\n * ```typescript\r\n * const vars = getTemplateVariables(template);\r\n * // [\r\n * //   { name: 'hyresobjektsnummer', type: 'string', default: '2022-F2008', label: 'Hyresobjekt', ... },\r\n * //   { name: 'showLegend', type: 'boolean', default: true, label: 'Show Legend', ... }\r\n * // ]\r\n *\r\n * // Use for UI generation\r\n * vars.forEach(v => {\r\n *   if (v.type === 'string') {\r\n *     renderTextField(v.label, v.default);\r\n *   } else if (v.type === 'boolean') {\r\n *     renderCheckbox(v.label, v.default);\r\n *   }\r\n * });\r\n * ```\r\n */\r\nexport function getTemplateVariables(template: LayoutTemplate): TemplateVariableInfo[] {\r\n    if (!template.variables) return [];\r\n\r\n    return Object.entries(template.variables).map(([name, def]) => ({\r\n        name,\r\n        type: def.type,\r\n        default: def.default,\r\n        label: def.label ?? name,\r\n        description: def.description,\r\n        format: def.format,\r\n        min: def.min,\r\n        max: def.max,\r\n        step: def.step,\r\n        minLength: def.minLength,\r\n        maxLength: def.maxLength,\r\n        pattern: def.pattern,\r\n        enum: def.enum,\r\n        items: def.items\r\n    }));\r\n}\r\n\r\n/**\r\n * Extract all default values from a template.\r\n *\r\n * Returns an object with all variable names mapped to their default values.\r\n * These defaults are guaranteed to work - template can always render with them.\r\n *\r\n * Returns empty object if template has no variables.\r\n *\r\n * @param template - Layout template\r\n * @returns Object mapping variable names to default values\r\n *\r\n * @example\r\n * ```typescript\r\n * const defaults = getTemplateDefaults(template);\r\n * // { hyresobjektsnummer: '2022-F2008', showLegend: true, scaleDenom: 100 }\r\n *\r\n * // Can always render with defaults (fail-safe)\r\n * const { svg } = await renderDrawing({\r\n *   template,\r\n *   models,\r\n *   variables: defaults  // Guaranteed to work\r\n * });\r\n * ```\r\n */\r\nexport function getTemplateDefaults(template: LayoutTemplate): Record<string, any> {\r\n    if (!template.variables) return {};\r\n\r\n    const defaults: Record<string, any> = {};\r\n    for (const [name, def] of Object.entries(template.variables)) {\r\n        defaults[name] = def.default;\r\n    }\r\n    return defaults;\r\n}\r\n\r\n/**\r\n * Validate a value against a variable definition.\r\n *\r\n * Checks type and constraint validation (min/max, pattern, enum, etc.).\r\n *\r\n * @param value - Value to validate\r\n * @param varDef - Variable definition with constraints\r\n * @returns Validation result with ok flag and optional error message\r\n */\r\nfunction validateVariable(value: any, varDef: TemplateVariableDef): { ok: boolean; error?: string } {\r\n    // Type check\r\n    const actualType = Array.isArray(value) ? 'array' : typeof value;\r\n    if (varDef.type === 'number' && actualType !== 'number') {\r\n        return { ok: false, error: `Expected number, got ${actualType}` };\r\n    }\r\n    if (varDef.type === 'string' && actualType !== 'string') {\r\n        return { ok: false, error: `Expected string, got ${actualType}` };\r\n    }\r\n    if (varDef.type === 'boolean' && actualType !== 'boolean') {\r\n        return { ok: false, error: `Expected boolean, got ${actualType}` };\r\n    }\r\n    if (varDef.type === 'array' && actualType !== 'array') {\r\n        return { ok: false, error: `Expected array, got ${actualType}` };\r\n    }\r\n\r\n    // String validation\r\n    if (varDef.type === 'string' && typeof value === 'string') {\r\n        if (varDef.minLength !== undefined && value.length < varDef.minLength) {\r\n            return { ok: false, error: `String too short (min ${varDef.minLength})` };\r\n        }\r\n        if (varDef.maxLength !== undefined && value.length > varDef.maxLength) {\r\n            return { ok: false, error: `String too long (max ${varDef.maxLength})` };\r\n        }\r\n        if (varDef.pattern) {\r\n            try {\r\n                const regex = new RegExp(varDef.pattern);\r\n                if (!regex.test(value)) {\r\n                    return { ok: false, error: `Does not match pattern ${varDef.pattern}` };\r\n                }\r\n            } catch {\r\n                return { ok: false, error: `Invalid pattern: ${varDef.pattern}` };\r\n            }\r\n        }\r\n        if (varDef.enum && !varDef.enum.includes(value)) {\r\n            return { ok: false, error: `Not in allowed values: ${varDef.enum.join(', ')}` };\r\n        }\r\n    }\r\n\r\n    // Number validation\r\n    if (varDef.type === 'number' && typeof value === 'number') {\r\n        if (!Number.isFinite(value)) {\r\n            return { ok: false, error: 'Must be a finite number' };\r\n        }\r\n        if (varDef.min !== undefined && value < varDef.min) {\r\n            return { ok: false, error: `Too small (min ${varDef.min})` };\r\n        }\r\n        if (varDef.max !== undefined && value > varDef.max) {\r\n            return { ok: false, error: `Too large (max ${varDef.max})` };\r\n        }\r\n    }\r\n\r\n    return { ok: true };\r\n}\r\n\r\n/**\r\n * Resolve template variables by merging user values with defaults.\r\n *\r\n * This is a **fail-safe** function:\r\n * - Missing values → use default\r\n * - Invalid values → use default + warn\r\n * - Unknown variables → warn + ignore\r\n *\r\n * The result is ALWAYS valid and complete (safe to use for rendering).\r\n *\r\n * @param template - Layout template with variable definitions\r\n * @param userValues - Optional user-provided values (can be partial or undefined)\r\n * @returns Object with resolved values and any validation warnings\r\n *\r\n * @example\r\n * ```typescript\r\n * // User provides partial values\r\n * const { values, warnings } = resolveTemplateValues(template, {\r\n *   hyresobjektsnummer: '2022-F2009'  // Valid\r\n *   // Other vars use defaults\r\n * });\r\n * // values = { hyresobjektsnummer: '2022-F2009', showLegend: true, scaleDenom: 100 }\r\n * // warnings = []\r\n *\r\n * // User provides invalid value\r\n * const { values, warnings } = resolveTemplateValues(template, {\r\n *   scaleDenom: 9999  // Out of range (max: 500)\r\n * });\r\n * // values = { scaleDenom: 100, ... }  ← Fell back to default\r\n * // warnings = [\"Invalid 'scaleDenom': Too large (max 500) - using default '100'\"]\r\n *\r\n * // Always safe to render\r\n * const resolvedTemplate = applyTemplateVariables(template, values);\r\n * ```\r\n */\r\nexport function resolveTemplateValues(\r\n    template: LayoutTemplate,\r\n    userValues?: Record<string, any>\r\n): { values: Record<string, any>; warnings: string[] } {\r\n    const defaults = getTemplateDefaults(template);\r\n    const warnings: string[] = [];\r\n\r\n    // Start with all defaults (fail-safe!)\r\n    const values = { ...defaults };\r\n\r\n    // No user values or no variables → return defaults\r\n    if (!userValues || !template.variables) {\r\n        return { values, warnings };\r\n    }\r\n\r\n    // Merge and validate user values\r\n    for (const [name, value] of Object.entries(userValues)) {\r\n        const varDef = template.variables[name];\r\n\r\n        // Unknown variable\r\n        if (!varDef) {\r\n            warnings.push(`Unknown variable '${name}' - ignoring`);\r\n            continue;\r\n        }\r\n\r\n        // Validate value\r\n        const validation = validateVariable(value, varDef);\r\n        if (!validation.ok) {\r\n            warnings.push(`Invalid '${name}': ${validation.error} - using default '${defaults[name]}'`);\r\n            continue;\r\n        }\r\n\r\n        // Valid → use it\r\n        values[name] = value;\r\n    }\r\n\r\n    return { values, warnings };\r\n}\r\n\r\n/**\r\n * Apply variables to a template by substituting {{vars.*}} references.\r\n *\r\n * Recursively scans the template and replaces all {{vars.variableName}} references\r\n * with the corresponding values from the provided values object.\r\n *\r\n * Returns a new template with all variables resolved (does not mutate input).\r\n *\r\n * @param template - Original template with {{vars.*}} references\r\n * @param values - Resolved variable values (from resolveTemplateValues)\r\n * @returns New template with all {{vars.*}} replaced by actual values\r\n *\r\n * @example\r\n * ```typescript\r\n * const template = {\r\n *   elements: [\r\n *     { kind: 'text', text: 'Hyresobjekt: {{vars.hyresobjektsnummer}}' },\r\n *     { kind: 'viewport', clip: { where: { 'BIP.id': '{{vars.hyresobjektsnummer}}' } } }\r\n *   ]\r\n * };\r\n *\r\n * const values = { hyresobjektsnummer: '2022-F2009' };\r\n * const resolved = applyTemplateVariables(template, values);\r\n * // {\r\n * //   elements: [\r\n * //     { kind: 'text', text: 'Hyresobjekt: 2022-F2009' },\r\n * //     { kind: 'viewport', clip: { where: { 'BIP.id': '2022-F2009' } } }\r\n * //   ]\r\n * // }\r\n * ```\r\n */\r\nexport function applyTemplateVariables(template: LayoutTemplate, values: Record<string, any>): LayoutTemplate {\r\n    // Deep clone to avoid mutation\r\n    const resolved: LayoutTemplate = JSON.parse(JSON.stringify(template));\r\n\r\n    // Recursively replace {{vars.*}} in all string values\r\n    function replaceInValue(obj: any): any {\r\n        if (typeof obj === 'string') {\r\n            return interpolateVariables(obj, values);\r\n        }\r\n        if (Array.isArray(obj)) {\r\n            return obj.map(replaceInValue);\r\n        }\r\n        if (obj && typeof obj === 'object') {\r\n            const result: any = {};\r\n            for (const [key, val] of Object.entries(obj)) {\r\n                result[key] = replaceInValue(val);\r\n            }\r\n            return result;\r\n        }\r\n        return obj;\r\n    }\r\n\r\n    // Apply to all template properties that might contain variable references\r\n    resolved.elements = replaceInValue(resolved.elements);\r\n    if (resolved.assets) {\r\n        resolved.assets = replaceInValue(resolved.assets);\r\n    }\r\n\r\n    return resolved;\r\n}\r\n\r\n/**\r\n * Interpolate {{vars.*}} references in a string.\r\n *\r\n * Replaces all occurrences of {{vars.variableName}} with the corresponding value.\r\n * If variable is not found, keeps the placeholder and logs a warning.\r\n *\r\n * @param str - String potentially containing {{vars.*}} references\r\n * @param values - Variable values\r\n * @returns String with all {{vars.*}} replaced\r\n */\r\nfunction interpolateVariables(str: string, values: Record<string, any>): string {\r\n    return str.replace(/\\{\\{vars\\.(\\w+)\\}\\}/g, (match, varName) => {\r\n        if (varName in values) {\r\n            const value = values[varName];\r\n            // Convert to string (handles numbers, booleans, etc.)\r\n            return String(value);\r\n        }\r\n        console.warn(`[templateVariables] Variable '${varName}' not found - keeping placeholder`);\r\n        return match; // Keep {{vars.varName}} as-is\r\n    });\r\n}\r\n"]}

package/dist/layout/typeGuards.d.ts

@@ -0,0 +1,5 @@
+/** Type guard: true for plain objects, false for arrays, null, and primitives. */
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+/** Safely read a property from an unknown value. Returns undefined for non-objects. */
+export declare const getProp: (obj: unknown, key: string) => unknown;
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/layout/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"/","sources":["layout/typeGuards.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAExE,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,OAAO,GAAI,KAAK,OAAO,EAAE,KAAK,MAAM,KAAG,OAEnD,CAAC"}

package/dist/layout/typeGuards.js

@@ -0,0 +1,9 @@
+/** Type guard: true for plain objects, false for arrays, null, and primitives. */
+export const isRecord = (value) => {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+};
+/** Safely read a property from an unknown value. Returns undefined for non-objects. */
+export const getProp = (obj, key) => {
+    return isRecord(obj) ? obj[key] : undefined;
+};
+//# sourceMappingURL=typeGuards.js.map

package/dist/layout/typeGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.js","sourceRoot":"/","sources":["layout/typeGuards.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE;IACzE,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAY,EAAE,GAAW,EAAW,EAAE;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC,CAAC","sourcesContent":["/** Type guard: true for plain objects, false for arrays, null, and primitives. */\r\nexport const isRecord = (value: unknown): value is Record<string, unknown> => {\r\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\r\n};\r\n\r\n/** Safely read a property from an unknown value. Returns undefined for non-objects. */\r\nexport const getProp = (obj: unknown, key: string): unknown => {\r\n    return isRecord(obj) ? obj[key] : undefined;\r\n};\r\n"]}