@happyvertical/smrt-svelte 0.55.7 → 0.55.9

package/dist/components/screens/fields.js

@@ -0,0 +1,229 @@
+/** Managed by the platform; never editable and never a default column. */
+const SYSTEM_FIELDS = new Set([
+    'id',
+    'tenantId',
+    'createdAt',
+    'updatedAt',
+    'createdBy',
+    'updatedBy',
+]);
+/** System timestamps that are informative (read-only) on a record view. */
+const META_TIMESTAMP_FIELDS = ['createdAt', 'updatedAt'];
+/** Columns shown by default on a list when the policy marks many basic. */
+export const DEFAULT_MAX_LIST_COLUMNS = 6;
+/** `dueDate` -> `Due date`; reference fields drop a trailing `Id`. */
+export function humanizeFieldName(name) {
+    const spaced = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .replace(/[_-]+/g, ' ')
+        .trim();
+    if (spaced === '')
+        return name;
+    const lower = spaced.toLowerCase();
+    return lower.charAt(0).toUpperCase() + lower.slice(1);
+}
+function humanizeLabel(name, definition) {
+    if ((definition.type === 'foreignKey' ||
+        definition.type === 'crossPackageRef') &&
+        /.[a-z]Id$/.test(name)) {
+        return humanizeFieldName(name.slice(0, -2));
+    }
+    return humanizeFieldName(name);
+}
+/** Singular and plural display names derived from the class name. */
+export function screenTitles(definition) {
+    const singular = humanizeFieldName(definition.className);
+    const last = singular.slice(-1);
+    const plural = /(s|x|z|ch|sh)$/i.test(singular)
+        ? `${singular}es`
+        : /[^aeiou]y$/i.test(singular)
+            ? `${singular.slice(0, -1)}ies`
+            : last === ''
+                ? singular
+                : `${singular}s`;
+    return { singular, plural };
+}
+/** Which control renders a field, from its widget hint and wire type. */
+export function inputKindFor(definition) {
+    const widget = definition.ui?.widget;
+    if (definition.type === 'text') {
+        if (widget === 'textarea')
+            return 'textarea';
+        if (widget === 'email')
+            return 'email';
+        if (widget === 'url')
+            return 'url';
+        if (widget === 'phone')
+            return 'tel';
+        return 'text';
+    }
+    // Money is integer minor units only; a currency hint on a decimal is a
+    // plain decimal (rates and confidences are the only decimals).
+    if (definition.type === 'integer') {
+        return widget === 'currency' ? 'money' : 'integer';
+    }
+    switch (definition.type) {
+        case 'decimal':
+            return 'decimal';
+        case 'boolean':
+            return 'boolean';
+        case 'datetime':
+            return 'datetime';
+        case 'json':
+            return 'json';
+        default:
+            return 'reference';
+    }
+}
+function isRequired(definition, policyRequired) {
+    if (policyRequired !== undefined)
+        return policyRequired;
+    return definition.required === true && definition.nullable !== true;
+}
+/**
+ * Mismatch between a definition and a policy, or `null` when they belong
+ * together. Components surface this instead of rendering the wrong object.
+ */
+export function screenSourceError(definition, policy) {
+    if (policy && policy.objectRef !== definition.objectRef) {
+        return `Field policy is for '${policy.objectRef}', not '${definition.objectRef}'.`;
+    }
+    return null;
+}
+function isDeclaredName(name) {
+    return !name.startsWith('_') && !name.startsWith('$');
+}
+function seedBasicSet(candidates) {
+    const hasMarkers = candidates.some((c) => c.definition.ui?.basic === true);
+    const basic = new Set();
+    for (const c of candidates) {
+        if (c.definition.ui?.basic === true)
+            basic.add(c.name);
+        else if (c.definition.ui?.basic !== false && !hasMarkers)
+            basic.add(c.name);
+    }
+    return basic;
+}
+/** Order by explicit `order` (nulls last), then declaration order. */
+function byOrder(a, b) {
+    return ((a.order ?? Number.MAX_SAFE_INTEGER) -
+        (b.order ?? Number.MAX_SAFE_INTEGER) || a.index - b.index);
+}
+/**
+ * Select and decorate the fields one screen shows.
+ *
+ * - `edit`: basic and advanced tiers, system fields never.
+ * - `view`: basic and advanced tiers, then `createdAt`/`updatedAt` as
+ *   read-only advanced meta when the definition has them.
+ * - `list`: basic tier only, without long text, JSON or raw reference columns,
+ *   capped at {@link DEFAULT_MAX_LIST_COLUMNS}; `include` overrides all of it.
+ */
+export function deriveScreenFields(definition, policy, options) {
+    const { mode, include, exclude } = options;
+    const excluded = new Set(exclude ?? []);
+    const candidates = Object.entries(definition.fields)
+        .map(([name, fieldDefinition], index) => ({
+        name,
+        definition: fieldDefinition,
+        index,
+    }))
+        .filter((c) => isDeclaredName(c.name) &&
+        !SYSTEM_FIELDS.has(c.name) &&
+        c.name !== definition.idField);
+    const seedBasic = policy ? null : seedBasicSet(candidates);
+    const decorate = (c) => {
+        const policyField = policy?.fields[c.name];
+        if (policy && !policyField)
+            return null;
+        const tier = policyField
+            ? policyField.visibility
+            : seedBasic?.has(c.name)
+                ? 'basic'
+                : 'advanced';
+        if (tier === 'hidden')
+            return null;
+        const label = policyField?.label?.trim();
+        const help = policyField?.help ?? c.definition.description ?? null;
+        return {
+            name: c.name,
+            label: label || humanizeLabel(c.name, c.definition),
+            help: help && help.trim() !== '' ? help : null,
+            type: c.definition.type,
+            kind: inputKindFor(c.definition),
+            required: isRequired(c.definition, policyField?.required),
+            tier,
+            group: policyField?.group ?? c.definition.ui?.group ?? null,
+            order: policyField?.order ?? c.definition.ui?.order ?? null,
+            definition: c.definition,
+        };
+    };
+    const decorated = candidates
+        .map((c) => ({ c, field: decorate(c) }))
+        .filter((e) => e.field !== null)
+        .filter((e) => !excluded.has(e.c.name));
+    const meta = (name) => {
+        const fieldDefinition = definition.fields[name];
+        if (!fieldDefinition || excluded.has(name))
+            return null;
+        return {
+            name,
+            label: humanizeFieldName(name),
+            help: null,
+            type: fieldDefinition.type,
+            kind: 'datetime',
+            required: false,
+            tier: 'advanced',
+            group: null,
+            order: null,
+            definition: fieldDefinition,
+        };
+    };
+    if (include) {
+        const byName = new Map(decorated.map((e) => [e.c.name, e.field]));
+        const picked = [];
+        for (const name of include) {
+            if (excluded.has(name))
+                continue;
+            if (mode !== 'edit' && META_TIMESTAMP_FIELDS.includes(name)) {
+                const metaField = meta(name);
+                if (metaField)
+                    picked.push(metaField);
+                continue;
+            }
+            const field = byName.get(name);
+            if (field)
+                picked.push(field);
+        }
+        return picked;
+    }
+    const ordered = decorated
+        .map((e) => e.field)
+        .map((field, position) => ({ field, order: field.order, index: position }))
+        .sort(byOrder)
+        .map((e) => e.field);
+    if (mode === 'list') {
+        const cap = options.maxListColumns ?? DEFAULT_MAX_LIST_COLUMNS;
+        return ordered
+            .filter((f) => f.tier === 'basic' &&
+            f.kind !== 'json' &&
+            f.kind !== 'textarea' &&
+            f.kind !== 'reference')
+            .slice(0, Math.max(0, cap));
+    }
+    if (mode === 'view') {
+        const metas = META_TIMESTAMP_FIELDS.map(meta).filter((f) => f !== null);
+        return [...ordered, ...metas];
+    }
+    return ordered;
+}
+/** Group fields preserving first-seen group order; ungrouped is `null`. */
+export function groupScreenFields(fields) {
+    const groups = new Map();
+    for (const field of fields) {
+        const bucket = groups.get(field.group) ?? [];
+        bucket.push(field);
+        groups.set(field.group, bucket);
+    }
+    return [...groups.entries()];
+}

package/dist/components/screens/index.d.ts

@@ -0,0 +1,8 @@
+export { default as DetailScreen } from './DetailScreen.svelte';
+export { default as EditForm } from './EditForm.svelte';
+export { DEFAULT_MAX_LIST_COLUMNS, type DeriveScreenFieldsOptions, deriveScreenFields, groupScreenFields, humanizeFieldName, inputKindFor, screenSourceError, screenTitles, } from './fields.js';
+export { default as ListScreen } from './ListScreen.svelte';
+export { default as RecipeScreens } from './RecipeScreens.svelte';
+export type { DetailScreenProps, EditFormProps, EditFormSubmitResult, ListScreenProps, RecipeScreensProps, RecipeScreensSource, RecipeScreenView, ScreenCollectionDefinition, ScreenDraft, ScreenDraftValue, ScreenField, ScreenFieldDefinition, ScreenFieldErrorCode, ScreenFieldPolicy, ScreenFieldType, ScreenFieldUIHints, ScreenFieldVisibility, ScreenInputKind, ScreenMode, ScreenPolicy, ScreenRecord, } from './types.js';
+export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, type FormatValueContext, formatScreenValue, majorStringToMinorUnits, minorUnitsToMajorString, type ParsedDraft, parseDraft, toDatetimeLocal, toDraftValue, } from './values.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/screens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/screens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,WAAW,EAChB,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/components/screens/index.js

@@ -0,0 +1,6 @@
+export { default as DetailScreen } from './DetailScreen.svelte';
+export { default as EditForm } from './EditForm.svelte';
+export { DEFAULT_MAX_LIST_COLUMNS, deriveScreenFields, groupScreenFields, humanizeFieldName, inputKindFor, screenSourceError, screenTitles, } from './fields.js';
+export { default as ListScreen } from './ListScreen.svelte';
+export { default as RecipeScreens } from './RecipeScreens.svelte';
+export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, formatScreenValue, majorStringToMinorUnits, minorUnitsToMajorString, parseDraft, toDatetimeLocal, toDraftValue, } from './values.js';

package/dist/components/screens/types.d.ts

@@ -0,0 +1,215 @@
+import type { Snippet } from 'svelte';
+/**
+ * Structural types for the manifest-derived record screens (#3718).
+ *
+ * These mirror the browser-safe `SmrtWebCollectionDefinition` that the SMRT
+ * build emits and the `ResolvedObjectFieldPolicy` that `@happyvertical/smrt-fields`
+ * resolves, without importing either package: smrt-svelte stays below the
+ * domain layer in the dependency graph, and an app passes the generated
+ * definition and resolved policy straight in as props.
+ */
+/** Persisted public wire types emitted by generated web collections. */
+export type ScreenFieldType = 'text' | 'integer' | 'decimal' | 'boolean' | 'datetime' | 'json' | 'foreignKey' | 'crossPackageRef';
+/** Static `@field({ ui })` presentation hints from the manifest. */
+export interface ScreenFieldUIHints {
+    basic?: boolean;
+    group?: string;
+    order?: number;
+    locked?: boolean;
+    widget?: 'textarea' | 'currency' | 'email' | 'url' | 'phone';
+}
+/** Browser-safe subset of one generated web field definition. */
+export interface ScreenFieldDefinition {
+    type: ScreenFieldType;
+    required?: boolean;
+    nullable?: boolean;
+    default?: unknown;
+    /** Developer-authored `@field({ description })`; the code-seed help text. */
+    description?: string;
+    ui?: ScreenFieldUIHints;
+}
+/** Structural subset of a generated `SmrtWebCollectionDefinition`. */
+export interface ScreenCollectionDefinition {
+    /** Canonical qualified model identity (`@package/name:ClassName`). */
+    objectRef: string;
+    /** Simple class name, used to derive default titles. */
+    className: string;
+    /** Primary-key field name. Defaults to `id`. */
+    idField?: string;
+    fields: Readonly<Record<string, ScreenFieldDefinition>>;
+}
+export type ScreenFieldVisibility = 'basic' | 'advanced' | 'hidden';
+/**
+ * One field's resolved policy. Structurally satisfied by smrt-fields'
+ * `ResolvedFieldPolicy`, so a resolved policy can be passed unchanged.
+ */
+export interface ScreenFieldPolicy {
+    visibility: ScreenFieldVisibility;
+    label?: string | null;
+    help?: string | null;
+    order?: number | null;
+    group?: string | null;
+    required?: boolean;
+    hasDefault?: boolean;
+    defaultValue?: unknown;
+    locked?: boolean;
+}
+/** Structurally satisfied by smrt-fields' `ResolvedObjectFieldPolicy`. */
+export interface ScreenPolicy {
+    objectRef: string;
+    fields: Readonly<Record<string, ScreenFieldPolicy>>;
+}
+export type ScreenMode = 'list' | 'view' | 'edit';
+/** How a field is rendered and edited. */
+export type ScreenInputKind = 'text' | 'textarea' | 'email' | 'url' | 'tel' | 'integer' | 'decimal' | 'money' | 'boolean' | 'datetime' | 'json' | 'reference';
+/** A field selected and decorated for one screen. */
+export interface ScreenField {
+    name: string;
+    label: string;
+    /** Help text (policy help, else the manifest description). */
+    help: string | null;
+    type: ScreenFieldType;
+    kind: ScreenInputKind;
+    required: boolean;
+    /** `basic` fields show first; `advanced` ones sit behind a disclosure. */
+    tier: 'basic' | 'advanced';
+    group: string | null;
+    order: number | null;
+    definition: ScreenFieldDefinition;
+}
+/** Why a draft value could not become a payload value. */
+export type ScreenFieldErrorCode = 'required' | 'invalid_integer' | 'invalid_decimal' | 'invalid_money' | 'invalid_datetime' | 'invalid_json';
+/** A row from the backing collection. */
+export type ScreenRecord = Readonly<Record<string, unknown>>;
+/** Draft value held by an edit form: booleans stay booleans, the rest text. */
+export type ScreenDraftValue = string | boolean;
+export type ScreenDraft = Record<string, ScreenDraftValue>;
+/** Data access a {@link RecipeScreens} instance drives. Transport-neutral. */
+export interface RecipeScreensSource {
+    list(): Promise<readonly ScreenRecord[]>;
+    /** Optional: when absent the record is looked up in the loaded list. */
+    get?(id: string): Promise<ScreenRecord | undefined>;
+    create?(values: Record<string, unknown>): Promise<ScreenRecord | undefined>;
+    update?(id: string, values: Record<string, unknown>): Promise<ScreenRecord | undefined>;
+    delete?(id: string): Promise<void>;
+}
+export type RecipeScreenView = 'list' | 'view' | 'create' | 'edit';
+export interface ListScreenProps {
+    /** Generated browser-safe collection definition. */
+    definition: ScreenCollectionDefinition;
+    /** Resolved field policy for the same object; omit for the code seed. */
+    policy?: ScreenPolicy | null;
+    /** Rows to show. */
+    rows: readonly ScreenRecord[];
+    /** Page title. Defaults to the pluralized class name. */
+    title?: string;
+    /** Subtitle under the title. */
+    description?: string;
+    /** Explicit column field names, in order (overrides the derived set). */
+    columns?: readonly string[];
+    /** Cap on derived columns. */
+    maxColumns?: number;
+    /** Rows per page. */
+    pageSize?: number;
+    /** Show the search box. */
+    searchable?: boolean;
+    loading?: boolean;
+    /** Load failure message; rows already present stay visible. */
+    error?: string | null;
+    /** ISO 4217 code used by money fields. */
+    currency?: string;
+    /** BCP-47 locale for number and date formatting. */
+    locale?: string;
+    /** Render the page header (title and create action). */
+    showHeader?: boolean;
+    /** Row activation (click or Enter). */
+    onselect?: (row: ScreenRecord) => void;
+    /** When set, a create action is offered. */
+    oncreate?: () => void;
+    onretry?: () => void;
+    /** Extra header actions, rendered before the create action. */
+    extraActions?: Snippet;
+}
+export interface DetailScreenProps {
+    definition: ScreenCollectionDefinition;
+    /** Resolved field policy for the same object; omit for the code seed. */
+    policy?: ScreenPolicy | null;
+    record: ScreenRecord;
+    /** Page title. Defaults to the first basic text field, else the class name. */
+    title?: string;
+    /** Explicit field names, in order (overrides the derived set). */
+    fields?: readonly string[];
+    /** ISO 4217 code used by money fields. */
+    currency?: string;
+    /** BCP-47 locale for number and date formatting. */
+    locale?: string;
+    showHeader?: boolean;
+    /** Label for the back action; defaults to the pluralized class name. */
+    backLabel?: string;
+    /** Mutation in flight; locks the delete confirmation. */
+    deleting?: boolean;
+    onback?: () => void;
+    onedit?: () => void;
+    /** When set, a Delete action with a confirmation is offered. */
+    ondelete?: () => void | Promise<void>;
+    /** Extra header actions, rendered before Edit and Delete. */
+    extraActions?: Snippet;
+    /** Extra content under the fields. */
+    children?: Snippet;
+}
+/** What a submit handler may return to report server-side field problems. */
+export interface EditFormSubmitResult {
+    fieldErrors?: Readonly<Record<string, string>>;
+}
+export interface EditFormProps {
+    definition: ScreenCollectionDefinition;
+    /** Resolved field policy for the same object; omit for the code seed. */
+    policy?: ScreenPolicy | null;
+    /** The record being edited; omit to create a new one. */
+    record?: ScreenRecord;
+    /** Page title. Defaults to "New x" / "Edit x" from the class name. */
+    title?: string;
+    /** Explicit field names, in order (overrides the derived set). */
+    fields?: readonly string[];
+    /** ISO 4217 code used by money fields. */
+    currency?: string;
+    showHeader?: boolean;
+    /** True while the host is persisting; locks the form. */
+    submitting?: boolean;
+    /** Server-reported field messages, keyed by field name. */
+    fieldErrors?: Readonly<Record<string, string>>;
+    /** A form-level failure message from the host. */
+    error?: string | null;
+    /** Receives wire-ready values for the displayed fields. */
+    onsubmit: (values: Record<string, unknown>, context: {
+        isNew: boolean;
+    }) => void | EditFormSubmitResult | Promise<void | EditFormSubmitResult>;
+    oncancel?: () => void;
+}
+export interface RecipeScreensProps {
+    definition: ScreenCollectionDefinition;
+    /** Resolved field policy for the same object; omit for the code seed. */
+    policy?: ScreenPolicy | null;
+    source: RecipeScreensSource;
+    /** Current screen (bindable). */
+    view?: RecipeScreenView;
+    /** Record shown by `view` and `edit` (bindable). */
+    recordId?: string | null;
+    /** List title. Defaults to the pluralized class name. */
+    title?: string;
+    /** Explicit list columns, in order. */
+    columns?: readonly string[];
+    /** Explicit view / edit field names, in order. */
+    fields?: readonly string[];
+    currency?: string;
+    locale?: string;
+    /** Turn operations off even when the source supports them. */
+    can?: {
+        create?: boolean;
+        update?: boolean;
+        delete?: boolean;
+    };
+    /** Called on every user navigation, for router synchronization. */
+    onnavigate?: (view: RecipeScreenView, recordId: string | null) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/screens/types.d.ts.map

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

package/dist/components/screens/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/screens/values.d.ts

@@ -0,0 +1,62 @@
+import type { ScreenDraft, ScreenDraftValue, ScreenField, ScreenFieldErrorCode, ScreenPolicy, ScreenRecord } from './types.js';
+/** Currency used for money fields when the screen is not told otherwise. */
+export declare const DEFAULT_SCREEN_CURRENCY = "USD";
+/** Decimal places of a currency's minor unit (2 for an unknown code). */
+export declare function currencyMinorDigits(currency: string): number;
+/** `1999`, 2 digits -> `19.99`. Exact; `null` for a non-safe integer. */
+export declare function minorUnitsToMajorString(minor: unknown, digits: number): string | null;
+/**
+ * `19.99`, 2 digits -> `1999`. Accepts a leading sign and `,` grouping;
+ * rejects more fraction digits than the currency has and non-safe integers.
+ */
+export declare function majorStringToMinorUnits(text: string, digits: number): number | null;
+/** A record datetime as a `datetime-local` input value (local time). */
+export declare function toDatetimeLocal(value: unknown): string;
+export interface ScreenValueContext {
+    /** ISO 4217 code used by money fields. */
+    currency?: string;
+}
+/** One field's value as the draft representation its control edits. */
+export declare function toDraftValue(field: Pick<ScreenField, 'kind'>, value: unknown, context?: ScreenValueContext): ScreenDraftValue;
+/** Draft for editing an existing record. */
+export declare function draftFromRecord(fields: readonly ScreenField[], record: ScreenRecord, context?: ScreenValueContext): ScreenDraft;
+/**
+ * Draft for a new record: the resolved policy default when one resolved
+ * (an explicit `null` default included), else the manifest default.
+ */
+export declare function draftForCreate(fields: readonly ScreenField[], policy?: ScreenPolicy | null, context?: ScreenValueContext): ScreenDraft;
+export interface ParseDraftContext extends ScreenValueContext {
+    /**
+     * The loaded record being edited. A datetime control shows minute
+     * precision only, so a datetime whose draft text still equals what the
+     * record rendered is submitted as the record's own value, keeping seconds
+     * and milliseconds. A genuinely edited datetime saves the new value.
+     */
+    record?: ScreenRecord | null;
+}
+export interface ParsedDraft {
+    /** Payload values, keyed by field name. */
+    values: Record<string, unknown>;
+    errors: Record<string, ScreenFieldErrorCode>;
+}
+/**
+ * Convert a draft into a write payload. An empty optional text field becomes
+ * `null` when the field is nullable and `''` otherwise; every other empty
+ * optional field becomes `null`. A required empty field is an error.
+ */
+export declare function parseDraft(fields: readonly ScreenField[], draft: ScreenDraft, context?: ParseDraftContext): ParsedDraft;
+export interface FormatValueContext extends ScreenValueContext {
+    locale?: string;
+    timeZone?: string;
+    /** Labels for boolean values (the component supplies localized ones). */
+    yes?: string;
+    no?: string;
+}
+/** A record value as display text for a list cell or a view row. */
+export declare function formatScreenValue(field: Pick<ScreenField, 'kind'>, value: unknown, context?: FormatValueContext): string;
+/**
+ * Order two record values for a list column: empty values last (whichever
+ * way the column sorts), numbers numerically, everything else as text.
+ */
+export declare function compareScreenValues(left: unknown, right: unknown, direction: 'asc' | 'desc' | null): number;
+//# sourceMappingURL=values.d.ts.map

package/dist/components/screens/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/components/screens/values.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAYf;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAUf;AAMD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CAkBlB;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAMb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAWb;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA8Fb;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAsDR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAC/B,MAAM,CAgBR"}