@protobase/schema 0.68.2 → 0.68.3

package/dist/index.d.ts

@@ -49,4 +49,8 @@ import { AccessSource, ResolveOptions, ResolvedAccess, RowFilterOperation, acces
 import { restrictModel } from "./access/restrict.js";
 import "./access/index.js";
 import { AssistantAction, AssistantActionRequest, AssistantCardPart, AssistantDiff, AssistantEvent, AssistantMessage, AssistantMessageRequest, AssistantPart, AssistantState, AssistantStep, AssistantStepState, AssistantTablePart, AssistantTextPart, AssistantTone, AssistantWidgetPart } from "./assistant/protocol.js";
-export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type ArgumentSpec, type ArgumentType, type ArgumentsSpec, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BadgeTone, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type CommentsSectionModel, type CompareOp, type ComponentRef, type ComputedReveal, type ConnectAddress, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type Encrypted, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExactCapability, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileField, type FileFieldModel, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListDragModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NamedListModel, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PageWidth, type ParentAccess, type ParentModel, type PeriodChartInput, type PeriodChartModel, type PositionAfterModel, type RecordChartModel, type RecordChartRange, type RecordKey, type RecordMode, type RecordOf, type RecordPageModel, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelatedPresentation, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RevealCaller, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type TabItemModel, type TabModel, type TenantOptions, type TimelineView, type TitleFromModel, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, badgeTones, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isBadgeTone, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, maxJsonDepth, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };
+import { CellKind, FileCell, FileDate, FileJson, cellKind, isEmptyFileCell } from "./user-tables/cell-kind.js";
+import { UserTableFieldType, UserTableNameIssue, userTableNameIssue } from "./user-tables/names.js";
+import { ColumnType, ColumnTypeReader, DecimalType, columnTypeReader, inferColumnType, maxShortText, minWholeDigits, widerFieldTypes } from "./user-tables/column-type.js";
+import { fieldNamesOf, tableNameOf } from "./user-tables/column-names.js";
+export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type ArgumentSpec, type ArgumentType, type ArgumentsSpec, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BadgeTone, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type CellKind, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type ColumnType, type ColumnTypeReader, type CommentsSectionModel, type CompareOp, type ComponentRef, type ComputedReveal, type ConnectAddress, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DecimalType, type DeletedOptions, type DurationLiteral, type DurationUnit, type Encrypted, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExactCapability, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileCell, type FileDate, type FileField, type FileFieldModel, type FileJson, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListDragModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NamedListModel, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PageWidth, type ParentAccess, type ParentModel, type PeriodChartInput, type PeriodChartModel, type PositionAfterModel, type RecordChartModel, type RecordChartRange, type RecordKey, type RecordMode, type RecordOf, type RecordPageModel, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelatedPresentation, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RevealCaller, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type TabItemModel, type TabModel, type TenantOptions, type TimelineView, type TitleFromModel, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type UserTableFieldType, type UserTableNameIssue, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, badgeTones, bottomBar, bottomBarErrors, cellKind, checkFilter, checkOrderBy, checkRecord, columnTypeReader, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldNamesOf, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, inferColumnType, isBadgeTone, isEmptyFileCell, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, maxJsonDepth, maxShortText, minWholeDigits, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, tableNameOf, userMenu, userTableNameIssue, view, where, widerFieldTypes };

package/dist/index.js

@@ -30,4 +30,8 @@ import { rule } from "./access/rule.js";
 import { defineRoles } from "./access/roles.js";
 import { pickView } from "./access/pick-view.js";
 import { restrictModel } from "./access/restrict.js";
-export { accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, badgeTones, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isBadgeTone, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, maxJsonDepth, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };
+import { cellKind, isEmptyFileCell } from "./user-tables/cell-kind.js";
+import { columnTypeReader, inferColumnType, maxShortText, minWholeDigits, widerFieldTypes } from "./user-tables/column-type.js";
+import { userTableNameIssue } from "./user-tables/names.js";
+import { fieldNamesOf, tableNameOf } from "./user-tables/column-names.js";
+export { accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, badgeTones, bottomBar, bottomBarErrors, cellKind, checkFilter, checkOrderBy, checkRecord, columnTypeReader, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldNamesOf, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, inferColumnType, isBadgeTone, isEmptyFileCell, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, maxJsonDepth, maxShortText, minWholeDigits, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, tableNameOf, userMenu, userTableNameIssue, view, where, widerFieldTypes };

package/dist/internal.d.ts

@@ -8,6 +8,8 @@ import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
 import { parseCapability } from "./access/capability.js";
+import { reservedWords } from "./user-tables/reserved-words.js";
+import { isUserTableName, maxLabelLength, maxNameBytes, maxOrganizationNameBytes, organizationColumn, reservedFieldNames, userTableName } from "./user-tables/names.js";
 import { checkEventFilter } from "./events/event-models.js";
 import { webhookResources } from "./webhooks/webhook-resources.js";
 import { workflowResources } from "./workflows/workflow-resources.js";
@@ -45,4 +47,4 @@ import { builtInFieldTypes } from "./built-in-field-types.js";
 import { CallCandidate, CallClientMessage, CallDescription, CallGuestLink, CallGuestRefusal, CallGuestState, CallLeftReason, CallLobbyGuest, CallMode, CallRemoteTrack, CallResume, CallRosterMember, CallServerMessage, CallTrackRequest, CallTrackSource, CallVideoLayer } from "./calls/call-protocol.js";
 import { guestCallsPath } from "./calls/call-guests.js";
 import { CallRing, callsChannelEvent, declineWord, ringNotice, ringsPath } from "./calls/call-rings.js";
-export { type AddressCheck, type Availability, type CallCandidate, type CallClientMessage, type CallDescription, type CallGuestLink, type CallGuestRefusal, type CallGuestState, type CallLeftReason, type CallLobbyGuest, type CallMode, type CallRemoteTrack, type CallResume, type CallRing, type CallRosterMember, type CallServerMessage, type CallTrackRequest, type CallTrackSource, type CallVideoLayer, type FormulaNode, type Locale, type MobileReleaseAnswer, type PersonStatus, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type ReleaseBinding, type SearchTerm, type StatusInput, type WorkflowTypeEntry, type WorkflowTypeList, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };
+export { type AddressCheck, type Availability, type CallCandidate, type CallClientMessage, type CallDescription, type CallGuestLink, type CallGuestRefusal, type CallGuestState, type CallLeftReason, type CallLobbyGuest, type CallMode, type CallRemoteTrack, type CallResume, type CallRing, type CallRosterMember, type CallServerMessage, type CallTrackRequest, type CallTrackSource, type CallVideoLayer, type FormulaNode, type Locale, type MobileReleaseAnswer, type PersonStatus, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type ReleaseBinding, type SearchTerm, type StatusInput, type WorkflowTypeEntry, type WorkflowTypeList, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, isUserTableName, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxLabelLength, maxNameBytes, maxOrganizationNameBytes, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, organizationColumn, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, reservedFieldNames, reservedWords, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, userTableName, viewOfList, webhookResources, workflowResources, workflowTypesPath };

package/dist/internal.js

@@ -17,6 +17,8 @@ import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field
 import { boardErrors, cardPhotoLimit, datesErrors, displayFields, tableDisplay } from "./view-displays.js";
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
+import { reservedWords } from "./user-tables/reserved-words.js";
+import { isUserTableName, maxLabelLength, maxNameBytes, maxOrganizationNameBytes, organizationColumn, reservedFieldNames, userTableName } from "./user-tables/names.js";
 import { webhookResources } from "./webhooks/webhook-resources.js";
 import { workflowResources } from "./workflows/workflow-resources.js";
 import { workflowTypesPath } from "./workflows/workflow-types-path.js";
@@ -44,4 +46,4 @@ import { listColumnNames } from "./list-columns.js";
 import { builtInFieldTypes } from "./built-in-field-types.js";
 import { guestCallsPath } from "./calls/call-guests.js";
 import { callsChannelEvent, declineWord, ringNotice, ringsPath } from "./calls/call-rings.js";
-export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };
+export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, isUserTableName, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxLabelLength, maxNameBytes, maxOrganizationNameBytes, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, organizationColumn, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, reservedFieldNames, reservedWords, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, userTableName, viewOfList, webhookResources, workflowResources, workflowTypesPath };

package/dist/model.d.ts

@@ -1334,8 +1334,11 @@ export type ViewModel = {
   signIn?: SignInPromptModel;
   /** The list page's button that saves its filter as a search of the user's own. */
   saveSearch?: SaveSearchModel;
-  /** Whether the list page offers Import, which creates or updates records from an .xlsx or CSV file; it does when omitted. */
-  import?: boolean;
+  /**
+   * Whether the list page offers Import, which creates or updates records from an .xlsx, CSV or JSON file; it does when
+   * omitted. `table` makes it a new table users add from the file, with its fields and records.
+   */
+  import?: boolean | 'table';
   /** The list page shows the user's saved searches of another resource, each with what it finds, instead of rows. */
   searchesOf?: SearchesOfModel;
   /** Whether the list page offers Export, and the most rows a file holds; offered without a limit when omitted. */

package/dist/user-tables/cell-kind.d.ts

@@ -0,0 +1,29 @@
+//#region src/user-tables/cell-kind.d.ts
+/**
+ * A cell of a file as a table is made from it: text (every CSV cell), a number, a boolean, a date or time a workbook
+ * stores as one (`{ date: '2026-03-01' }` or `{ date: '2026-03-01T14:30:00' }`, without a zone), a JSON file's nested
+ * object or array (`{ json }`), or `null` for an empty cell.
+ */
+export type FileCell = string | number | boolean | FileDate | FileJson | null;
+/** A date or time a workbook stores as one. */
+export type FileDate = {
+  /** `2026-03-01`, or `2026-03-01T14:30:00` with its time and no zone. */
+  date: string;
+};
+/** A JSON file's nested object or array. */
+export type FileJson = {
+  /** The value as the file states it. */
+  json: unknown;
+};
+/** Whether the cell holds nothing: no value, or only spaces. */
+export declare const isEmptyFileCell: (cell: FileCell) => boolean;
+/**
+ * What one cell says it is. Only forms that read one way are anything but text: a whole number without leading zeros
+ * or a plus sign (so `007` and `+31` stay text), a decimal with a point, true or false, an ISO date, an ISO date and
+ * time with its zone (`zoned`) or without (`local`), or a nested JSON value. A comma decimal, a thousands separator or
+ * `03/04/2026` could be read two ways, so they are text.
+ */
+export type CellKind = 'text' | 'whole' | 'decimal' | 'boolean' | 'date' | 'local' | 'zoned' | 'json';
+/** What a cell that is not empty says it is. */
+export declare const cellKind: (cell: Exclude<FileCell, null>) => CellKind;
+//#endregion

package/dist/user-tables/cell-kind.js

@@ -0,0 +1,43 @@
+//#region src/user-tables/cell-kind.ts
+/** Whether the cell holds nothing: no value, or only spaces. */
+const isEmptyFileCell = (cell) => cell === null || typeof cell === "string" && cell.trim() === "";
+const wholePattern = /^-?(0|[1-9]\d*)$/;
+const decimalPattern = /^-?(0|[1-9]\d*)\.\d+$/;
+const datePattern = /^(\d{4})-(\d{2})-(\d{2})$/;
+const timePattern = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,6})?)?(Z|[+-]\d{2}:\d{2})?$/;
+const isCalendarDate = (text) => {
+	const match = datePattern.exec(text);
+	if (!match) return false;
+	const [year, month, day] = [
+		Number(match[1]),
+		Number(match[2]),
+		Number(match[3])
+	];
+	const at = new Date(Date.UTC(year, month - 1, day));
+	return at.getUTCFullYear() === year && at.getUTCMonth() === month - 1 && at.getUTCDate() === day;
+};
+const textKind = (text) => {
+	if (wholePattern.test(text)) return "whole";
+	if (decimalPattern.test(text)) return "decimal";
+	if (/^(true|false)$/i.test(text)) return "boolean";
+	if (isCalendarDate(text)) return "date";
+	const time = timePattern.exec(text);
+	if (!time?.[1] || !isCalendarDate(time[1])) return "text";
+	if (Number(time[2]) > 23 || Number(time[3]) > 59 || Number(time[4] ?? 0) > 59) return "text";
+	return time[5] ? "zoned" : "local";
+};
+/** What a cell that is not empty says it is. */
+const cellKind = (cell) => {
+	if (typeof cell === "boolean") return "boolean";
+	if (typeof cell === "number") return Number.isInteger(cell) ? "whole" : "decimal";
+	if (typeof cell === "string") return textKind(cell.trim());
+	if ("json" in cell) return "json";
+	return cell.date.includes("T") ? "local" : "date";
+};
+/** A number cell, or the text of a whole or decimal one, as plain digits with a point: `1e21` as `1000000000000000000000`. */
+const plainNumber = (cell) => typeof cell === "number" ? cell.toLocaleString("en-US", {
+	useGrouping: false,
+	maximumFractionDigits: 100
+}) : cell.trim();
+//#endregion
+export { cellKind, isEmptyFileCell, plainNumber };

package/dist/user-tables/column-names.d.ts

@@ -0,0 +1,15 @@
+//#region src/user-tables/column-names.d.ts
+/**
+ * The field names of a file's columns from their headers, in order: each in snake_case, `column_<letters>` (its
+ * letters in the file) for a header with no letters or digits, and a name that repeats an earlier one, is a word SQL
+ * reserves or a name every table's field has (`id`, `etag`, `organization_id`) with `_2`, `_3` and so on after it.
+ * Two headers never share a name.
+ */
+export declare const fieldNamesOf: (headers: readonly string[]) => string[];
+/**
+ * A table's name from a file's name, without its extension, in snake_case, and with `_2`, `_3` and so on after it when
+ * a name in `taken`, such as the app's resources, or a word SQL reserves has it; `undefined` when the name has no
+ * letters or digits. `maxBytes` is 42 in an app with organizations.
+ */
+export declare const tableNameOf: (fileName: string, taken?: Iterable<string>, maxBytes?: number) => string | undefined;
+//#endregion

package/dist/user-tables/column-names.js

@@ -0,0 +1,42 @@
+import { reservedWords } from "./reserved-words.js";
+import { reservedFieldNames } from "./names.js";
+//#region src/user-tables/column-names.ts
+const snakeOf = (text) => text.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+const fitted = (name, prefix, maxBytes) => (/^[a-z]/.test(name) ? name : `${prefix}_${name}`).slice(0, maxBytes).replace(/_+$/, "");
+const unique = (name, taken, maxBytes) => {
+	let candidate = name;
+	for (let next = 2; taken.has(candidate) || reservedWords.has(candidate); next++) {
+		const suffix = `_${next}`;
+		candidate = `${name.slice(0, maxBytes - suffix.length).replace(/_+$/, "")}${suffix}`;
+	}
+	return candidate;
+};
+/** A spreadsheet's letters for column `index`, in lower case: 0 is `a`, 27 is `ab`. */
+const columnLetters = (index) => index < 26 ? String.fromCharCode(97 + index) : columnLetters(Math.floor(index / 26) - 1) + columnLetters(index % 26);
+/**
+* The field names of a file's columns from their headers, in order: each in snake_case, `column_<letters>` (its
+* letters in the file) for a header with no letters or digits, and a name that repeats an earlier one, is a word SQL
+* reserves or a name every table's field has (`id`, `etag`, `organization_id`) with `_2`, `_3` and so on after it.
+* Two headers never share a name.
+*/
+const fieldNamesOf = (headers) => {
+	const taken = new Set(reservedFieldNames);
+	return headers.map((header, index) => {
+		const snake = snakeOf(header);
+		const name = unique(snake === "" ? `column_${columnLetters(index)}` : fitted(snake, "column", 63), taken, 63);
+		taken.add(name);
+		return name;
+	});
+};
+/**
+* A table's name from a file's name, without its extension, in snake_case, and with `_2`, `_3` and so on after it when
+* a name in `taken`, such as the app's resources, or a word SQL reserves has it; `undefined` when the name has no
+* letters or digits. `maxBytes` is 42 in an app with organizations.
+*/
+const tableNameOf = (fileName, taken = [], maxBytes = 63) => {
+	const snake = snakeOf(fileName.replace(/\.(csv|tsv|txt|xlsx|json)$/i, ""));
+	if (snake === "") return;
+	return unique(fitted(snake, "table", maxBytes), new Set(taken), maxBytes);
+};
+//#endregion
+export { fieldNamesOf, tableNameOf };

package/dist/user-tables/column-type.d.ts

@@ -0,0 +1,54 @@
+import { FileCell } from "./cell-kind.js";
+import { UserTableFieldType } from "./names.js";
+//#region src/user-tables/column-type.d.ts
+/** The type a column of a file becomes, with a decimal's precision and scale. */
+export type ColumnType = {
+  /** The field type of a table users add. */
+  type: UserTableFieldType;
+  /** A decimal's digits in all. */
+  precision?: number;
+  /** A decimal's digits after the point. */
+  scale?: number;
+};
+/** A decimal number's type, which always has its precision and scale. */
+export type DecimalType = ColumnType & {
+  /** Its digits in all, from 1 to 1000. */
+  precision: number;
+  /** Its digits after the point, at most the precision. */
+  scale: number;
+};
+/** Reads a column's cells one at a time; see `columnTypeReader`. */
+export type ColumnTypeReader = {
+  /** Reads one more cell of the column. */
+  add: (cell: FileCell) => void;
+  /** The type every cell read so far is written as. */
+  type: () => ColumnType;
+  /** The decimal number that holds every number read so far, for a column of numbers or one changed to a decimal. */
+  decimal: () => DecimalType;
+};
+/** The most characters a `text` field holds; a column with a longer value is `long_text`. */
+export declare const maxShortText = 500;
+/** The digits a decimal keeps before its point at least: 15, as many as a spreadsheet keeps of a number. */
+export declare const minWholeDigits = 15;
+/**
+ * Reads a column's cells one at a time and keeps only what its type needs, so a file of any length is read in the
+ * memory of one row: `add` each cell, then `type()` is one type every non-empty cell is written as, else text, and
+ * nothing else.
+ *
+ * - Whole numbers are `integer`, or a decimal of scale 0 once one is past the integer range.
+ * - Whole numbers with decimals are a `decimal` whose scale is the most digits after the point, with room for at least
+ *   `minWholeDigits` before it.
+ * - True or false is `boolean`, ISO dates `date`, ISO dates and times `timestamp`: a time without a zone is read in
+ *   the browser's time zone, as Import reads one.
+ * - A column with a nested JSON value is `json`, which holds its other values as they are.
+ * - A column of mixed forms, or of no values, is text: `long_text` once a value is over `maxShortText` characters.
+ */
+export declare const columnTypeReader: () => ColumnTypeReader;
+/** The type of a column from all its cells at once; see `columnTypeReader`. */
+export declare const inferColumnType: (cells: Iterable<FileCell>) => ColumnType;
+/**
+ * The types a column of `type` may be changed to, itself first: only less specific ones, which take every value it
+ * holds as the file wrote it. A long text and a JSON column keep their type.
+ */
+export declare const widerFieldTypes: (type: UserTableFieldType) => UserTableFieldType[];
+//#endregion

package/dist/user-tables/column-type.js

@@ -0,0 +1,104 @@
+import { cellKind, isEmptyFileCell, plainNumber } from "./cell-kind.js";
+//#region src/user-tables/column-type.ts
+/** The most characters a `text` field holds; a column with a longer value is `long_text`. */
+const maxShortText = 500;
+/** The digits a decimal keeps before its point at least: 15, as many as a spreadsheet keeps of a number. */
+const minWholeDigits = 15;
+const maxPrecision = 1e3;
+const int4 = 2147483647n;
+const kindTypes = {
+	boolean: "boolean",
+	date: "date",
+	local: "timestamp",
+	zoned: "timestamp",
+	json: "json"
+};
+/**
+* Reads a column's cells one at a time and keeps only what its type needs, so a file of any length is read in the
+* memory of one row: `add` each cell, then `type()` is one type every non-empty cell is written as, else text, and
+* nothing else.
+*
+* - Whole numbers are `integer`, or a decimal of scale 0 once one is past the integer range.
+* - Whole numbers with decimals are a `decimal` whose scale is the most digits after the point, with room for at least
+*   `minWholeDigits` before it.
+* - True or false is `boolean`, ISO dates `date`, ISO dates and times `timestamp`: a time without a zone is read in
+*   the browser's time zone, as Import reads one.
+* - A column with a nested JSON value is `json`, which holds its other values as they are.
+* - A column of mixed forms, or of no values, is text: `long_text` once a value is over `maxShortText` characters.
+*/
+const columnTypeReader = () => {
+	const kinds = /* @__PURE__ */ new Set();
+	let wholeDigits = 1;
+	let scale = 0;
+	let pastInteger = false;
+	let longest = 0;
+	const add = (cell) => {
+		if (cell === null || isEmptyFileCell(cell)) return;
+		if (typeof cell === "string") longest = Math.max(longest, cell.length);
+		const kind = cellKind(cell);
+		kinds.add(kind);
+		if (kind !== "whole" && kind !== "decimal") return;
+		const [whole = "", fraction = ""] = plainNumber(cell).replace("-", "").split(".");
+		wholeDigits = Math.max(wholeDigits, whole.length);
+		scale = Math.max(scale, fraction.length);
+		if (kind === "whole" && !pastInteger) {
+			const value = BigInt(plainNumber(cell));
+			pastInteger = (value < 0n ? -value - 1n : value) > int4;
+		}
+	};
+	const decimal = () => {
+		const precision = Math.min(maxPrecision, Math.max(wholeDigits, 15) + scale);
+		return {
+			type: "decimal",
+			precision,
+			scale: Math.min(scale, precision)
+		};
+	};
+	const type = () => {
+		if (kinds.has("json")) return { type: "json" };
+		const only = kinds.size === 1 ? [...kinds][0] : void 0;
+		if (only === "whole") return pastInteger ? decimal() : { type: "integer" };
+		if (kinds.size === 2 && kinds.has("whole") && kinds.has("decimal")) return decimal();
+		if (only === "decimal") return decimal();
+		if (only && only !== "text") return { type: kindTypes[only] };
+		return { type: longest > 500 ? "long_text" : "text" };
+	};
+	return {
+		add,
+		type,
+		decimal
+	};
+};
+/** The type of a column from all its cells at once; see `columnTypeReader`. */
+const inferColumnType = (cells) => {
+	const reader = columnTypeReader();
+	for (const cell of cells) reader.add(cell);
+	return reader.type();
+};
+/**
+* The types a column of `type` may be changed to, itself first: only less specific ones, which take every value it
+* holds as the file wrote it. A long text and a JSON column keep their type.
+*/
+const widerFieldTypes = (type) => {
+	switch (type) {
+		case "integer": return [
+			"integer",
+			"decimal",
+			"text",
+			"long_text"
+		];
+		case "decimal":
+		case "boolean":
+		case "date":
+		case "timestamp": return [
+			type,
+			"text",
+			"long_text"
+		];
+		case "text": return ["text", "long_text"];
+		case "long_text":
+		case "json": return [type];
+	}
+};
+//#endregion
+export { columnTypeReader, inferColumnType, maxShortText, minWholeDigits, widerFieldTypes };

package/dist/user-tables/names.d.ts

@@ -0,0 +1,26 @@
+import { reservedWords } from "./reserved-words.js";
+//#region src/user-tables/names.d.ts
+/** The field types a table users add may have. */
+export type UserTableFieldType = 'text' | 'long_text' | 'integer' | 'decimal' | 'boolean' | 'date' | 'timestamp' | 'json';
+/** What a name of a user table or field must be: it reaches SQL as an identifier, always quoted too. */
+export declare const userTableName: RegExp;
+/** The most bytes Postgres keeps of an identifier. */
+export declare const maxNameBytes = 63;
+/**
+ * The most bytes the name of a table has in an app with organizations: its table is `t<id>_<name>`, and the id, a
+ * bigint, takes up to 19 digits of the 63 bytes Postgres keeps.
+ */
+export declare const maxOrganizationNameBytes: number;
+/** The most characters a label of a table or field users add has. */
+export declare const maxLabelLength = 200;
+/** The column that holds the organization of each record of a table users add with organizations, and of each definition. */
+export declare const organizationColumn = "organization_id";
+/** The names a field never takes: the key's, the API's for the record version, and the organization's. */
+export declare const reservedFieldNames: readonly string[];
+export declare const isUserTableName: (name: string) => boolean;
+/** Why a table or field users add may not have a name: its form or length, a word SQL reserves, or a name every table's field has. */
+export type UserTableNameIssue = 'form' | 'reserved_word' | 'reserved_field';
+/** What is wrong with a name a table or field users add is given, or `undefined` when it may have it; `maxBytes` defaults to 63. */
+export declare const userTableNameIssue: (name: unknown, kind: "table" | "field", maxBytes?: number) => UserTableNameIssue | undefined;
+//#endregion
+export { reservedWords };

package/dist/user-tables/names.js

@@ -0,0 +1,30 @@
+import { reservedWords } from "./reserved-words.js";
+//#region src/user-tables/names.ts
+/** What a name of a user table or field must be: it reaches SQL as an identifier, always quoted too. */
+const userTableName = /^[a-z][a-z0-9_]*$/;
+/** The most bytes Postgres keeps of an identifier. */
+const maxNameBytes = 63;
+/**
+* The most bytes the name of a table has in an app with organizations: its table is `t<id>_<name>`, and the id, a
+* bigint, takes up to 19 digits of the 63 bytes Postgres keeps.
+*/
+const maxOrganizationNameBytes = 42;
+/** The most characters a label of a table or field users add has. */
+const maxLabelLength = 200;
+/** The column that holds the organization of each record of a table users add with organizations, and of each definition. */
+const organizationColumn = "organization_id";
+/** The names a field never takes: the key's, the API's for the record version, and the organization's. */
+const reservedFieldNames = [
+	"id",
+	"etag",
+	organizationColumn
+];
+const isUserTableName = (name) => userTableName.test(name) && new TextEncoder().encode(name).length <= 63;
+/** What is wrong with a name a table or field users add is given, or `undefined` when it may have it; `maxBytes` defaults to 63. */
+const userTableNameIssue = (name, kind, maxBytes = 63) => {
+	if (typeof name !== "string" || !isUserTableName(name) || new TextEncoder().encode(name).length > maxBytes) return "form";
+	if (reservedWords.has(name)) return "reserved_word";
+	if (kind === "field" && reservedFieldNames.includes(name)) return "reserved_field";
+};
+//#endregion
+export { isUserTableName, maxLabelLength, maxNameBytes, maxOrganizationNameBytes, organizationColumn, reservedFieldNames, reservedWords, userTableName, userTableNameIssue };

package/dist/user-tables/reserved-words.d.ts

@@ -0,0 +1,7 @@
+//#region src/user-tables/reserved-words.d.ts
+/**
+ * The key words Postgres 18 reserves, `select word from pg_get_keywords() where catcode = 'R'`: a table or field users
+ * add never takes one, so its name works unquoted in any SQL a developer writes against it.
+ */
+export declare const reservedWords: ReadonlySet<string>;
+//#endregion

package/dist/user-tables/reserved-words.js

@@ -0,0 +1,87 @@
+//#region src/user-tables/reserved-words.ts
+/**
+* The key words Postgres 18 reserves, `select word from pg_get_keywords() where catcode = 'R'`: a table or field users
+* add never takes one, so its name works unquoted in any SQL a developer writes against it.
+*/
+const reservedWords = /* @__PURE__ */ new Set([
+	"all",
+	"analyse",
+	"analyze",
+	"and",
+	"any",
+	"array",
+	"as",
+	"asc",
+	"asymmetric",
+	"both",
+	"case",
+	"cast",
+	"check",
+	"collate",
+	"column",
+	"constraint",
+	"create",
+	"current_catalog",
+	"current_date",
+	"current_role",
+	"current_time",
+	"current_timestamp",
+	"current_user",
+	"default",
+	"deferrable",
+	"desc",
+	"distinct",
+	"do",
+	"else",
+	"end",
+	"except",
+	"false",
+	"fetch",
+	"for",
+	"foreign",
+	"from",
+	"grant",
+	"group",
+	"having",
+	"in",
+	"initially",
+	"intersect",
+	"into",
+	"lateral",
+	"leading",
+	"limit",
+	"localtime",
+	"localtimestamp",
+	"not",
+	"null",
+	"offset",
+	"on",
+	"only",
+	"or",
+	"order",
+	"placing",
+	"primary",
+	"references",
+	"returning",
+	"select",
+	"session_user",
+	"some",
+	"symmetric",
+	"system_user",
+	"table",
+	"then",
+	"to",
+	"trailing",
+	"true",
+	"union",
+	"unique",
+	"user",
+	"using",
+	"variadic",
+	"when",
+	"where",
+	"window",
+	"with"
+]);
+//#endregion
+export { reservedWords };

package/dist/view.d.ts

@@ -151,11 +151,12 @@ export declare class ViewBuilder<R extends {
    */
   recordWidth(recordWidth: PageWidth): ViewBuilder<R>;
   /**
-   * Whether the list page offers Import, which creates or updates records from an .xlsx or CSV file the user picks
-   * (`true`, the default, to users who may create records); `.import(false)` turns it off. See
+   * Whether the list page offers Import, which creates or updates records from an .xlsx, CSV or JSON file the user
+   * picks (`true`, the default, to users who may create records); `.import(false)` turns it off. `.import('table')`
+   * makes it a new table users add from the file instead, as the Tables list of user tables does. See
    * [Importing records](docs/website/src/content/docs/reference/ui-config.mdx#importing-records).
    */
-  import(enabled: boolean): ViewBuilder<R>;
+  import(enabled: boolean | 'table'): ViewBuilder<R>;
   /**
    * The named actions of the record page's action rail, which composed pages can put on buttons too: `a.update`,
    * `a.remove` and `a.link` need no code, `a.action` runs a handler the app registers.

package/dist/view.js

@@ -223,8 +223,9 @@ var ViewBuilder = class ViewBuilder {
 		return this.next({ recordWidth });
 	}
 	/**
-	* Whether the list page offers Import, which creates or updates records from an .xlsx or CSV file the user picks
-	* (`true`, the default, to users who may create records); `.import(false)` turns it off. See
+	* Whether the list page offers Import, which creates or updates records from an .xlsx, CSV or JSON file the user
+	* picks (`true`, the default, to users who may create records); `.import(false)` turns it off. `.import('table')`
+	* makes it a new table users add from the file instead, as the Tables list of user tables does. See
 	* [Importing records](docs/website/src/content/docs/reference/ui-config.mdx#importing-records).
 	*/
 	import(enabled) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/schema",
-  "version": "0.68.2",
+  "version": "0.68.3",
   "description": "Resource, field, view and access definitions for Protobase configs.",
   "license": "Apache-2.0",
   "repository": {