@jini-ai/chat 0.6.5 → 0.6.7

package/dist/core/question-form/normalize.d.ts

@@ -10,6 +10,23 @@
  * question objects.
  */
 import type { FormQuestion } from './types.js';
+/** `raw` viewed as a record of fields, or `null` when it isn't an object at all. */
+export declare function asRecord(raw: unknown): Record<string, unknown> | null;
+/** `raw` when it is a string, else `undefined`. */
+export declare function stringOrUndefined(raw: unknown): string | undefined;
+/** `raw` when it is a non-empty string, else `undefined`. */
+export declare function nonEmptyString(raw: unknown): string | undefined;
+type OmitUndefined<T> = {
+    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+} & {
+    [K in keyof T as undefined extends T[K] ? K : never]?: Exclude<T[K], undefined>;
+};
+/**
+ * `obj` without its `undefined`-valued keys, in the original key order — so
+ * an optional field is absent rather than present-but-undefined, which
+ * `exactOptionalPropertyTypes` (and a consumer's `'key' in obj`) can tell apart.
+ */
+export declare function omitUndefined<T extends Record<string, unknown>>(obj: T): OmitUndefined<T>;
 export declare function mapRawQuestion({ q, index }: {
     q: unknown;
     index: number;
@@ -32,4 +49,5 @@ export declare function mapRawQuestion({ q, index }: {
 export declare function isRenderableColor({ value }: {
     value: string;
 }): boolean;
+export {};
 //# sourceMappingURL=normalize.d.ts.map

package/dist/core/question-form/normalize.js

@@ -1,89 +1,93 @@
 import { formOptionValueForLabel } from './format.js';
+/** `raw` viewed as a record of fields, or `null` when it isn't an object at all. */
+export function asRecord(raw) {
+    return raw && typeof raw === 'object' ? raw : null;
+}
+/** `raw` when it is a string, else `undefined`. */
+export function stringOrUndefined(raw) {
+    return typeof raw === 'string' ? raw : undefined;
+}
+/** `raw` when it is a non-empty string, else `undefined`. */
+export function nonEmptyString(raw) {
+    return stringOrUndefined(raw) || undefined;
+}
+/** `raw` trimmed when it is a string with visible content, else `undefined`. */
+function trimmedNonBlank(raw) {
+    return nonEmptyString(stringOrUndefined(raw)?.trim());
+}
+/** The string entries of `raw` when it is an array, else an empty list. */
+function stringsOnly(raw) {
+    return Array.isArray(raw) ? raw.filter((entry) => typeof entry === 'string') : [];
+}
+/**
+ * `obj` without its `undefined`-valued keys, in the original key order — so
+ * an optional field is absent rather than present-but-undefined, which
+ * `exactOptionalPropertyTypes` (and a consumer's `'key' in obj`) can tell apart.
+ */
+export function omitUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+}
 export function mapRawQuestion({ q, index }) {
-    if (!q || typeof q !== 'object')
+    const qo = asRecord(q);
+    if (!qo)
         return null;
-    const qo = q;
-    const id = typeof qo.id === 'string' && qo.id.trim().length > 0 ? qo.id.trim() : `q${index + 1}`;
-    const label = typeof qo.label === 'string' ? qo.label : id;
+    const id = trimmedNonBlank(qo.id) ?? `q${index + 1}`;
     const type = normalizeType(qo.type);
     const options = parseOptions(qo.options);
-    const placeholder = typeof qo.placeholder === 'string' ? qo.placeholder : undefined;
-    const help = typeof qo.help === 'string' ? qo.help : undefined;
-    const required = qo.required === true;
-    const maxSelections = typeof qo.maxSelections === 'number' && Number.isInteger(qo.maxSelections) && qo.maxSelections > 0
-        ? qo.maxSelections
-        : undefined;
-    const cards = parseDirectionCards(qo.cards);
-    const defaultValue = parseDefaultValue(qo, options);
-    const allowCustom = qo.allowCustom === false ? false : qo.allowCustom === true || qo.custom === true ? true : undefined;
-    const customLabel = typeof qo.customLabel === 'string' ? qo.customLabel : undefined;
-    const customPlaceholder = typeof qo.customPlaceholder === 'string' ? qo.customPlaceholder : undefined;
-    const min = parseNumberAttr(qo.min);
-    const max = parseNumberAttr(qo.max);
-    const step = parseNumberAttr(qo.step);
-    const multiple = qo.multiple === true;
-    const accept = typeof qo.accept === 'string' ? qo.accept : undefined;
-    return {
+    const isFile = type === 'file';
+    return omitUndefined({
         id,
-        ...(typeof qo.name === 'string' ? { name: qo.name } : {}),
-        label,
+        name: stringOrUndefined(qo.name),
+        label: stringOrUndefined(qo.label) ?? id,
         type,
-        ...(options ? { options } : {}),
-        ...(placeholder ? { placeholder } : {}),
-        ...(help ? { help } : {}),
-        ...(required ? { required } : {}),
-        ...(defaultValue !== undefined ? { defaultValue } : {}),
-        ...(maxSelections !== undefined && type === 'checkbox' ? { maxSelections } : {}),
-        ...(allowCustom !== undefined ? { allowCustom } : {}),
-        ...(customLabel ? { customLabel } : {}),
-        ...(customPlaceholder ? { customPlaceholder } : {}),
-        ...(min !== undefined ? { min } : {}),
-        ...(max !== undefined ? { max } : {}),
-        ...(step !== undefined ? { step } : {}),
-        ...(multiple && type === 'file' ? { multiple } : {}),
-        ...(accept && type === 'file' ? { accept } : {}),
-        ...(cards ? { cards } : {}),
-    };
+        options,
+        placeholder: nonEmptyString(qo.placeholder),
+        help: nonEmptyString(qo.help),
+        required: qo.required === true || undefined,
+        defaultValue: parseDefaultValue(qo, options),
+        maxSelections: type === 'checkbox' ? positiveInteger(qo.maxSelections) : undefined,
+        allowCustom: parseAllowCustom(qo),
+        customLabel: nonEmptyString(qo.customLabel),
+        customPlaceholder: nonEmptyString(qo.customPlaceholder),
+        min: parseNumberAttr(qo.min),
+        max: parseNumberAttr(qo.max),
+        step: parseNumberAttr(qo.step),
+        multiple: (isFile && qo.multiple === true) || undefined,
+        accept: isFile ? nonEmptyString(qo.accept) : undefined,
+        cards: parseDirectionCards(qo.cards),
+    });
+}
+function positiveInteger(raw) {
+    return typeof raw === 'number' && Number.isInteger(raw) && raw > 0 ? raw : undefined;
 }
+// An explicit `allowCustom: false` wins over the legacy `custom: true` key.
+function parseAllowCustom(question) {
+    if (question.allowCustom === false)
+        return false;
+    return question.allowCustom === true || question.custom === true || undefined;
+}
+const TYPE_ALIASES = new Map([
+    ['radio', ['radio', 'single', 'choice']],
+    ['checkbox', ['checkbox', 'multi', 'multiple']],
+    ['select', ['select', 'dropdown']],
+    ['textarea', ['textarea', 'long', 'paragraph']],
+    ['number', ['number', 'numeric']],
+    ['range', ['range', 'slider']],
+    ['date', ['date']],
+    ['time', ['time']],
+    ['datetime-local', ['datetime-local', 'datetime', 'date-time', 'datetime_local']],
+    ['color', ['color', 'colour', 'color-picker']],
+    ['url', ['url', 'link']],
+    ['email', ['email']],
+    ['tel', ['tel', 'phone']],
+    ['file', ['file', 'upload', 'attachment']],
+    ['switch', ['switch', 'toggle', 'boolean']],
+    ['direction-cards', ['direction-cards', 'directions', 'cards', 'direction']],
+].flatMap(([type, aliases]) => aliases.map((alias) => [alias, type])));
 function normalizeType(raw) {
     if (typeof raw !== 'string')
         return 'text';
-    const lower = raw.toLowerCase().trim();
-    if (lower === 'radio' || lower === 'single' || lower === 'choice')
-        return 'radio';
-    if (lower === 'checkbox' || lower === 'multi' || lower === 'multiple')
-        return 'checkbox';
-    if (lower === 'select' || lower === 'dropdown')
-        return 'select';
-    if (lower === 'textarea' || lower === 'long' || lower === 'paragraph')
-        return 'textarea';
-    if (lower === 'number' || lower === 'numeric')
-        return 'number';
-    if (lower === 'range' || lower === 'slider')
-        return 'range';
-    if (lower === 'date')
-        return 'date';
-    if (lower === 'time')
-        return 'time';
-    if (lower === 'datetime-local' || lower === 'datetime' || lower === 'date-time' || lower === 'datetime_local') {
-        return 'datetime-local';
-    }
-    if (lower === 'color' || lower === 'colour' || lower === 'color-picker')
-        return 'color';
-    if (lower === 'url' || lower === 'link')
-        return 'url';
-    if (lower === 'email')
-        return 'email';
-    if (lower === 'tel' || lower === 'phone')
-        return 'tel';
-    if (lower === 'file' || lower === 'upload' || lower === 'attachment')
-        return 'file';
-    if (lower === 'switch' || lower === 'toggle' || lower === 'boolean')
-        return 'switch';
-    if (lower === 'direction-cards' || lower === 'directions' || lower === 'cards' || lower === 'direction') {
-        return 'direction-cards';
-    }
-    return 'text';
+    return TYPE_ALIASES.get(raw.toLowerCase().trim()) ?? 'text';
 }
 function parseNumberAttr(raw) {
     if (typeof raw === 'number' && Number.isFinite(raw))
@@ -101,39 +105,27 @@ function parseOptions(raw) {
 }
 function parseOption(raw) {
     if (typeof raw === 'string') {
-        const label = raw.trim();
-        return label.length > 0 ? { label, value: label } : null;
+        const label = trimmedNonBlank(raw);
+        return label ? { label, value: label } : null;
     }
-    if (!raw || typeof raw !== 'object')
-        return null;
-    const obj = raw;
-    const label = typeof obj.label === 'string' ? obj.label.trim() : '';
-    if (label.length === 0)
+    const obj = asRecord(raw) ?? {};
+    const label = trimmedNonBlank(obj.label);
+    if (!label)
         return null;
-    const value = typeof obj.value === 'string' && obj.value.trim().length > 0 ? obj.value.trim() : label;
-    const description = typeof obj.description === 'string' && obj.description.trim().length > 0 ? obj.description.trim() : undefined;
-    return {
-        label,
-        value,
-        ...(description ? { description } : {}),
-    };
+    return omitUndefined({ label, value: trimmedNonBlank(obj.value) ?? label, description: trimmedNonBlank(obj.description) });
 }
+// Only `defaultValue` may hold a list; the legacy `default` key is read as a scalar only.
 function parseDefaultValue(question, options) {
-    const raw = typeof question.defaultValue === 'string' || Array.isArray(question.defaultValue)
-        ? question.defaultValue
-        : typeof question.defaultValue === 'number' || typeof question.defaultValue === 'boolean'
-            ? String(question.defaultValue)
-            : typeof question.default === 'string'
-                ? question.default
-                : typeof question.default === 'number' || typeof question.default === 'boolean'
-                    ? String(question.default)
-                    : undefined;
-    if (typeof raw === 'string')
-        return formOptionValueForLabel({ question: { options }, labelOrValue: raw });
-    if (Array.isArray(raw)) {
-        return raw.filter((value) => typeof value === 'string').map((value) => formOptionValueForLabel({ question: { options }, labelOrValue: value }));
-    }
-    return undefined;
+    const resolve = (labelOrValue) => formOptionValueForLabel({ question: { options }, labelOrValue });
+    if (Array.isArray(question.defaultValue))
+        return stringsOnly(question.defaultValue).map(resolve);
+    const raw = scalarString(question.defaultValue) ?? scalarString(question.default);
+    return raw === undefined ? undefined : resolve(raw);
+}
+function scalarString(raw) {
+    if (typeof raw === 'number' || typeof raw === 'boolean')
+        return String(raw);
+    return stringOrUndefined(raw);
 }
 /** `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`. */
 const HEX_COLOR = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
@@ -170,24 +162,22 @@ export function isRenderableColor({ value }) {
 function parseDirectionCards(raw) {
     if (!Array.isArray(raw))
         return undefined;
-    const out = [];
-    for (const entry of raw) {
-        if (!entry || typeof entry !== 'object')
-            continue;
-        const e = entry;
-        const id = typeof e.id === 'string' && e.id.trim().length > 0 ? e.id.trim() : null;
-        const label = typeof e.label === 'string' ? e.label : null;
-        if (id === null || label === null)
-            continue;
-        const mood = typeof e.mood === 'string' ? e.mood : '';
-        const references = Array.isArray(e.references) ? e.references.filter((r) => typeof r === 'string').slice(0, 6) : [];
-        const palette = Array.isArray(e.palette)
-            ? e.palette.filter((p) => typeof p === 'string' && isRenderableColor({ value: p })).slice(0, 8)
-            : [];
-        const displayFont = typeof e.displayFont === 'string' ? e.displayFont : 'Georgia, serif';
-        const bodyFont = typeof e.bodyFont === 'string' ? e.bodyFont : '-apple-system, system-ui, sans-serif';
-        out.push({ id, label, mood, references, palette, displayFont, bodyFont });
-    }
+    const out = raw.flatMap((entry) => parseDirectionCard(asRecord(entry) ?? {}) ?? []);
     return out.length > 0 ? out : undefined;
 }
+function parseDirectionCard(e) {
+    const id = trimmedNonBlank(e.id);
+    const label = stringOrUndefined(e.label);
+    if (id === undefined || label === undefined)
+        return null;
+    return {
+        id,
+        label,
+        mood: stringOrUndefined(e.mood) ?? '',
+        references: stringsOnly(e.references).slice(0, 6),
+        palette: stringsOnly(e.palette).filter((value) => isRenderableColor({ value })).slice(0, 8),
+        displayFont: stringOrUndefined(e.displayFont) ?? 'Georgia, serif',
+        bodyFont: stringOrUndefined(e.bodyFont) ?? '-apple-system, system-ui, sans-serif',
+    };
+}
 //# sourceMappingURL=normalize.js.map