@questpie/admin 1.1.1 → 2.0.0

package/dist/client/utils/build-field-definitions-from-schema.mjs

@@ -0,0 +1,256 @@
+import { formatLabel } from "../lib/utils.mjs";
+
+//#region src/client/utils/build-field-definitions-from-schema.ts
+/**
+* Build admin field definitions from server collection schema.
+*
+* Maps server field metadata to admin FieldDefinition objects:
+* - Uses `metadata.type` to look up field in registry
+* - Applies `metadata.meta.admin` overrides
+* - Handles relation type mapping (belongsTo -> single, hasMany -> multiple)
+*
+* @param schema - Collection schema from server introspection
+* @param registry - Field registry from admin config (admin.getFields())
+* @param options - Optional configuration
+*
+* @example
+* ```tsx
+* // In a component with admin context
+* const admin = useAdminStore(selectAdmin);
+* const { data: schema } = useCollectionSchema("posts");
+* const fields = buildFieldDefinitionsFromSchema(
+*   schema,
+*   admin.getFields(),
+* );
+* ```
+*/
+/**
+* Build field definitions from raw field metadata.
+* Works with metadata from any source (collection schema, global schema, block fields).
+*
+* @param fields - Record of field name to field metadata
+* @param registry - Field registry from admin config
+*
+* @example
+* ```tsx
+* const admin = useAdminStore(selectAdmin);
+* const fields = buildFieldDefinitionsFromMetadata(
+*   blockDef.fields,
+*   admin.getFields(),
+* );
+* ```
+*/
+function buildFieldDefinitionsFromMetadata(fields, registry) {
+	if (!fields) return {};
+	const result = {};
+	for (const [fieldName, fieldSchema] of Object.entries(fields)) {
+		const metadata = fieldSchema.metadata ?? fieldSchema;
+		const fieldType = resolveFieldType(metadata);
+		const fieldBuilder = registry[fieldType];
+		if (!fieldBuilder) continue;
+		const config = buildFieldConfig(fieldSchema.name ?? fieldName, metadata, {}, registry, fieldType);
+		result[fieldName] = fieldBuilder.$options(config);
+	}
+	return result;
+}
+function buildFieldDefinitionsFromSchema(schema, registry, options = {}) {
+	if (!schema) return {};
+	const relations = "relations" in schema ? schema.relations : {};
+	const result = {};
+	for (const [fieldName, fieldSchema] of Object.entries(schema.fields)) {
+		if (options.exclude?.includes(fieldName)) continue;
+		if (options.include && !options.include.includes(fieldName)) continue;
+		if (isSystemField(fieldName)) continue;
+		const fieldDef = buildFieldDefinition(fieldName, fieldSchema, relations, registry, options.overrides?.[fieldName]);
+		if (fieldDef) result[fieldName] = fieldDef;
+	}
+	return result;
+}
+/**
+* Build a single field definition from schema
+*/
+function buildFieldDefinition(fieldName, fieldSchema, relations, registry, overrides) {
+	const { metadata } = fieldSchema;
+	const fieldType = resolveFieldType(metadata);
+	const fieldBuilder = registry[fieldType];
+	if (!fieldBuilder) return null;
+	const config = buildFieldConfig(fieldName, metadata, relations, registry, fieldType);
+	const adminConfig = metadata.meta?.admin;
+	if (adminConfig) applyAdminConfig(config, adminConfig);
+	if (overrides) Object.assign(config, overrides);
+	return fieldBuilder.$options(config);
+}
+/**
+* Build field config from metadata
+*/
+function buildFieldConfig(fieldName, metadata, relations, registry, fieldType) {
+	const config = {
+		label: metadata.label ?? formatLabel(fieldName),
+		description: metadata.description,
+		required: metadata.required,
+		localized: metadata.localized,
+		readOnly: metadata.readOnly
+	};
+	if (metadata.validation) Object.assign(config, metadata.validation);
+	if (isSelectMetadata(metadata)) applySelectConfig(config, metadata);
+	else if (isRelationMetadata(metadata)) if (fieldType === "upload") applyUploadConfig(config, metadata, relations[fieldName]);
+	else applyRelationConfig(config, metadata, relations[fieldName]);
+	else if (isNestedMetadata(metadata)) applyNestedConfig(config, metadata, relations, registry);
+	else if (metadata.type === "richText") applyRichTextConfig(config, metadata);
+	applyExtraMetadata(config, metadata);
+	return config;
+}
+function isSelectMetadata(m) {
+	return m.type === "select";
+}
+function isRelationMetadata(m) {
+	return m.type === "relation";
+}
+function isNestedMetadata(m) {
+	return m.type === "object" || m.type === "array" || m.type === "blocks";
+}
+/**
+* Apply select field config
+*/
+function applySelectConfig(config, metadata) {
+	config.options = metadata.options.map((opt) => ({
+		value: opt.value,
+		label: opt.label ?? String(opt.value)
+	}));
+	if (metadata.multiple !== void 0) config.multiple = metadata.multiple;
+}
+/**
+* Apply relation field config
+*/
+function applyRelationConfig(config, metadata, relationSchema) {
+	const isSingle = ["belongsTo", "morphTo"].includes(metadata.relationType);
+	config.targetCollection = metadata.targetCollection;
+	config.type = isSingle ? "single" : "multiple";
+	config.relationType = metadata.relationType;
+	if (metadata.through ?? relationSchema?.through) config.through = metadata.through ?? relationSchema?.through;
+	if (metadata.foreignKey ?? relationSchema?.foreignKey) config.foreignKey = metadata.foreignKey ?? relationSchema?.foreignKey;
+}
+function applyUploadConfig(config, metadata, relationSchema) {
+	const isMultiple = [
+		"hasMany",
+		"manyToMany",
+		"multiple",
+		"morphMany"
+	].includes(metadata.relationType);
+	config.to = metadata.targetCollection;
+	config.multiple = isMultiple;
+	if (metadata.through ?? relationSchema?.through) config.through = metadata.through ?? relationSchema?.through;
+	if (metadata.foreignKey ?? relationSchema?.foreignKey) config.foreignKey = metadata.foreignKey ?? relationSchema?.foreignKey;
+}
+function applyNestedConfig(config, metadata, relations, registry) {
+	if (!metadata.nestedFields) return;
+	if (metadata.type === "object") {
+		const nestedDefs = buildNestedFieldDefinitions(metadata.nestedFields, relations, registry);
+		config.fields = () => nestedDefs;
+		return;
+	}
+	if (metadata.type === "array") {
+		const itemMetadata = metadata.nestedFields.item;
+		if (!itemMetadata) return;
+		if (itemMetadata.type === "object" && itemMetadata.nestedFields) {
+			const itemFields = buildNestedFieldDefinitions(itemMetadata.nestedFields ?? {}, relations, registry);
+			config.item = () => itemFields;
+			return;
+		}
+		const itemType = mapArrayItemType(itemMetadata.type);
+		if (itemType) {
+			config.itemType = itemType;
+			if (itemMetadata.type === "select") applySelectConfig(config, itemMetadata);
+		}
+	}
+	if (metadata.type === "blocks") {
+		const blocksMetadata = metadata;
+		if (blocksMetadata.allowedBlocks) config.allowedBlocks = blocksMetadata.allowedBlocks;
+		if (blocksMetadata.minBlocks !== void 0) config.minBlocks = blocksMetadata.minBlocks;
+		if (blocksMetadata.maxBlocks !== void 0) config.maxBlocks = blocksMetadata.maxBlocks;
+	}
+}
+function applyExtraMetadata(config, metadata) {
+	const reservedKeys = new Set([
+		"type",
+		"label",
+		"description",
+		"required",
+		"localized",
+		"readOnly",
+		"writeOnly",
+		"validation",
+		"meta",
+		"nestedFields",
+		"features"
+	]);
+	for (const [key, value] of Object.entries(metadata)) {
+		if (reservedKeys.has(key)) continue;
+		if (key.startsWith("_")) continue;
+		if (value === void 0) continue;
+		config[key] = value;
+	}
+}
+function applyRichTextConfig(config, metadata) {
+	if (metadata.maxCharacters !== void 0) {
+		config.maxCharacters = metadata.maxCharacters;
+		config.showCharacterCount = true;
+	}
+	if (metadata.placeholder !== void 0) config.placeholder = metadata.placeholder;
+	if (metadata.allowImages !== void 0) config.enableImages = metadata.allowImages;
+	if (metadata.imageCollection !== void 0) config.imageCollection = metadata.imageCollection;
+}
+function buildNestedFieldDefinitions(nestedFields, relations, registry) {
+	const result = {};
+	for (const [nestedName, nestedMetadata] of Object.entries(nestedFields)) {
+		const fieldType = resolveFieldType(nestedMetadata);
+		const fieldBuilder = registry[fieldType];
+		if (!fieldBuilder) continue;
+		const config = buildFieldConfig(nestedName, nestedMetadata, relations, registry, fieldType);
+		const adminConfig = nestedMetadata.meta?.admin;
+		if (adminConfig) applyAdminConfig(config, adminConfig);
+		result[nestedName] = fieldBuilder.$options(config);
+	}
+	return result;
+}
+function resolveFieldType(metadata) {
+	if (metadata.type === "relation") {
+		if (metadata.isUpload) return "upload";
+	}
+	return metadata.type;
+}
+function mapArrayItemType(type) {
+	return new Set([
+		"text",
+		"number",
+		"email",
+		"textarea",
+		"select"
+	]).has(type) ? type : null;
+}
+/**
+* Apply admin config overrides from server meta.admin
+*
+* Since each field type has its own admin meta with only valid properties,
+* we simply copy all defined properties from adminConfig to config.
+*/
+function applyAdminConfig(config, adminConfig) {
+	for (const [key, value] of Object.entries(adminConfig)) if (value !== void 0) config[key] = value;
+}
+/**
+* Check if a field is a system field that shouldn't be in forms
+*/
+function isSystemField(fieldName) {
+	return [
+		"id",
+		"createdAt",
+		"updatedAt",
+		"deletedAt",
+		"_title",
+		"_locale"
+	].includes(fieldName);
+}
+
+//#endregion
+export { buildFieldDefinitionsFromMetadata, buildFieldDefinitionsFromSchema };
+//# sourceMappingURL=build-field-definitions-from-schema.mjs.map

package/dist/client/utils/build-field-definitions-from-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-field-definitions-from-schema.mjs","names":["result: FieldDefinitionsResult","config: Record<string, unknown>"],"sources":["../../../src/client/utils/build-field-definitions-from-schema.ts"],"sourcesContent":["/**\n * Build Field Definitions from Schema\n *\n * Maps server introspection schema to admin field definitions.\n * Used by AutoForm to dynamically render forms based on server schema\n * when explicit field config is not provided.\n */\n\nimport type {\n\tCollectionSchema,\n\tFieldMetadata,\n\tGlobalSchema,\n\tNestedFieldMetadata,\n\tRelationFieldMetadata,\n\tRelationSchema,\n\tSelectFieldMetadata,\n} from \"questpie\";\nimport type { AnyAdminMeta } from \"../../augmentation\";\nimport type { FieldBuilder, FieldDefinition } from \"../builder/field/field\";\nimport { formatLabel } from \"../lib/utils\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Field registry type - maps field type names to FieldBuilder instances\n * This is what Admin.getFields() returns\n */\nexport type FieldRegistry = Record<string, FieldBuilder<any>>;\n\n/**\n * Options for building field definitions\n */\nexport interface BuildFieldDefinitionsOptions {\n\t/**\n\t * Field names to exclude from generation\n\t */\n\texclude?: string[];\n\n\t/**\n\t * Only generate these field names\n\t */\n\tinclude?: string[];\n\n\t/**\n\t * Override generated config for specific fields\n\t */\n\toverrides?: Record<string, Partial<Record<string, unknown>>>;\n}\n\n/**\n * Result of building field definitions\n */\nexport type FieldDefinitionsResult = Record<string, FieldDefinition>;\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Build admin field definitions from server collection schema.\n *\n * Maps server field metadata to admin FieldDefinition objects:\n * - Uses `metadata.type` to look up field in registry\n * - Applies `metadata.meta.admin` overrides\n * - Handles relation type mapping (belongsTo -> single, hasMany -> multiple)\n *\n * @param schema - Collection schema from server introspection\n * @param registry - Field registry from admin config (admin.getFields())\n * @param options - Optional configuration\n *\n * @example\n * ```tsx\n * // In a component with admin context\n * const admin = useAdminStore(selectAdmin);\n * const { data: schema } = useCollectionSchema(\"posts\");\n * const fields = buildFieldDefinitionsFromSchema(\n *   schema,\n *   admin.getFields(),\n * );\n * ```\n */\n\n/**\n * Build field definitions from raw field metadata.\n * Works with metadata from any source (collection schema, global schema, block fields).\n *\n * @param fields - Record of field name to field metadata\n * @param registry - Field registry from admin config\n *\n * @example\n * ```tsx\n * const admin = useAdminStore(selectAdmin);\n * const fields = buildFieldDefinitionsFromMetadata(\n *   blockDef.fields,\n *   admin.getFields(),\n * );\n * ```\n */\nexport function buildFieldDefinitionsFromMetadata(\n\tfields: Record<string, { metadata?: unknown; name?: string }> | undefined,\n\tregistry: FieldRegistry,\n): FieldDefinitionsResult {\n\tif (!fields) return {};\n\n\tconst result: FieldDefinitionsResult = {};\n\n\tfor (const [fieldName, fieldSchema] of Object.entries(fields)) {\n\t\tconst metadata = (fieldSchema.metadata ?? fieldSchema) as FieldMetadata;\n\t\tconst fieldType = resolveFieldType(metadata);\n\n\t\tconst fieldBuilder = registry[fieldType];\n\t\tif (!fieldBuilder) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst config = buildFieldConfig(\n\t\t\tfieldSchema.name ?? fieldName,\n\t\t\tmetadata,\n\t\t\t{},\n\t\t\tregistry,\n\t\t\tfieldType,\n\t\t);\n\n\t\tresult[fieldName] = fieldBuilder.$options(config);\n\t}\n\n\treturn result;\n}\n\nexport function buildFieldDefinitionsFromSchema(\n\tschema: CollectionSchema | GlobalSchema | null | undefined,\n\tregistry: FieldRegistry,\n\toptions: BuildFieldDefinitionsOptions = {},\n): FieldDefinitionsResult {\n\tif (!schema) return {};\n\n\tconst relations = \"relations\" in schema ? schema.relations : {};\n\n\tconst result: FieldDefinitionsResult = {};\n\n\tfor (const [fieldName, fieldSchema] of Object.entries(schema.fields)) {\n\t\t// Skip excluded fields\n\t\tif (options.exclude?.includes(fieldName)) continue;\n\n\t\t// Skip if not in include list (when include is specified)\n\t\tif (options.include && !options.include.includes(fieldName)) continue;\n\n\t\t// Skip system fields that shouldn't be in forms\n\t\tif (isSystemField(fieldName)) continue;\n\n\t\tconst fieldDef = buildFieldDefinition(\n\t\t\tfieldName,\n\t\t\tfieldSchema,\n\t\t\trelations,\n\t\t\tregistry,\n\t\t\toptions.overrides?.[fieldName],\n\t\t);\n\n\t\tif (fieldDef) {\n\t\t\tresult[fieldName] = fieldDef;\n\t\t}\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// Field Definition Builder\n// ============================================================================\n\n/**\n * Build a single field definition from schema\n */\nfunction buildFieldDefinition(\n\tfieldName: string,\n\tfieldSchema: { metadata: FieldMetadata },\n\trelations: Record<string, RelationSchema>,\n\tregistry: FieldRegistry,\n\toverrides?: Partial<Record<string, unknown>>,\n): FieldDefinition | null {\n\tconst { metadata } = fieldSchema;\n\tconst fieldType = resolveFieldType(metadata);\n\n\t// Get field builder from registry\n\tconst fieldBuilder = registry[fieldType];\n\tif (!fieldBuilder) {\n\t\t// Unknown field type - skip silently\n\t\t// Custom fields might not be registered in admin yet\n\t\treturn null;\n\t}\n\n\t// Build field config from metadata\n\tconst config = buildFieldConfig(\n\t\tfieldName,\n\t\tmetadata,\n\t\trelations,\n\t\tregistry,\n\t\tfieldType,\n\t);\n\n\t// Apply admin overrides from server meta\n\t// The meta.admin property is added via module augmentation on field-specific meta interfaces\n\tconst adminConfig = (metadata.meta as { admin?: AnyAdminMeta } | undefined)\n\t\t?.admin;\n\tif (adminConfig) {\n\t\tapplyAdminConfig(config, adminConfig);\n\t}\n\n\t// Apply local overrides\n\tif (overrides) {\n\t\tObject.assign(config, overrides);\n\t}\n\n\t// Create field definition with options\n\treturn fieldBuilder.$options(config);\n}\n\n/**\n * Build field config from metadata\n */\nfunction buildFieldConfig(\n\tfieldName: string,\n\tmetadata: FieldMetadata,\n\trelations: Record<string, RelationSchema>,\n\tregistry: FieldRegistry,\n\tfieldType: string,\n): Record<string, unknown> {\n\tconst config: Record<string, unknown> = {\n\t\tlabel: metadata.label ?? formatLabel(fieldName),\n\t\tdescription: metadata.description,\n\t\trequired: metadata.required,\n\t\tlocalized: metadata.localized,\n\t\treadOnly: metadata.readOnly,\n\t};\n\n\t// Apply validation constraints from base metadata\n\tif (metadata.validation) {\n\t\tObject.assign(config, metadata.validation);\n\t}\n\n\t// Handle field-type-specific config via type guard\n\tif (isSelectMetadata(metadata)) {\n\t\tapplySelectConfig(config, metadata);\n\t} else if (isRelationMetadata(metadata)) {\n\t\tif (fieldType === \"upload\") {\n\t\t\tapplyUploadConfig(config, metadata, relations[fieldName]);\n\t\t} else {\n\t\t\tapplyRelationConfig(config, metadata, relations[fieldName]);\n\t\t}\n\t} else if (isNestedMetadata(metadata)) {\n\t\tapplyNestedConfig(config, metadata, relations, registry);\n\t} else if (metadata.type === \"richText\") {\n\t\tapplyRichTextConfig(config, metadata as unknown as Record<string, unknown>);\n\t}\n\n\tapplyExtraMetadata(config, metadata);\n\n\treturn config;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\nfunction isSelectMetadata(m: FieldMetadata): m is SelectFieldMetadata {\n\treturn m.type === \"select\";\n}\n\nfunction isRelationMetadata(m: FieldMetadata): m is RelationFieldMetadata {\n\treturn m.type === \"relation\";\n}\n\nfunction isNestedMetadata(m: FieldMetadata): m is NestedFieldMetadata {\n\treturn m.type === \"object\" || m.type === \"array\" || m.type === \"blocks\";\n}\n\n// ============================================================================\n// Config Appliers (mutate config object)\n// ============================================================================\n\n/**\n * Apply select field config\n */\nfunction applySelectConfig(\n\tconfig: Record<string, unknown>,\n\tmetadata: SelectFieldMetadata,\n): void {\n\tconfig.options = metadata.options.map((opt) => ({\n\t\tvalue: opt.value,\n\t\tlabel: opt.label ?? String(opt.value),\n\t}));\n\tif (metadata.multiple !== undefined) {\n\t\tconfig.multiple = metadata.multiple;\n\t}\n}\n\n/**\n * Apply relation field config\n */\nfunction applyRelationConfig(\n\tconfig: Record<string, unknown>,\n\tmetadata: RelationFieldMetadata,\n\trelationSchema?: RelationSchema,\n): void {\n\t// Map relation type to single/multiple\n\tconst isSingle = [\"belongsTo\", \"morphTo\"].includes(metadata.relationType);\n\n\tconfig.targetCollection = metadata.targetCollection;\n\tconfig.type = isSingle ? \"single\" : \"multiple\";\n\t// Pass through relation metadata for advanced use\n\tconfig.relationType = metadata.relationType;\n\n\tif (metadata.through ?? relationSchema?.through) {\n\t\tconfig.through = metadata.through ?? relationSchema?.through;\n\t}\n\tif (metadata.foreignKey ?? relationSchema?.foreignKey) {\n\t\tconfig.foreignKey = metadata.foreignKey ?? relationSchema?.foreignKey;\n\t}\n}\n\nfunction applyUploadConfig(\n\tconfig: Record<string, unknown>,\n\tmetadata: RelationFieldMetadata,\n\trelationSchema?: RelationSchema,\n): void {\n\tconst isMultiple = [\n\t\t\"hasMany\",\n\t\t\"manyToMany\",\n\t\t\"multiple\",\n\t\t\"morphMany\",\n\t].includes(metadata.relationType);\n\n\tconfig.to = metadata.targetCollection;\n\tconfig.multiple = isMultiple;\n\n\tif (metadata.through ?? relationSchema?.through) {\n\t\tconfig.through = metadata.through ?? relationSchema?.through;\n\t}\n\tif (metadata.foreignKey ?? relationSchema?.foreignKey) {\n\t\tconfig.foreignKey = metadata.foreignKey ?? relationSchema?.foreignKey;\n\t}\n}\n\nfunction applyNestedConfig(\n\tconfig: Record<string, unknown>,\n\tmetadata: NestedFieldMetadata,\n\trelations: Record<string, RelationSchema>,\n\tregistry: FieldRegistry,\n): void {\n\tif (!metadata.nestedFields) return;\n\n\tif (metadata.type === \"object\") {\n\t\tconst nestedDefs = buildNestedFieldDefinitions(\n\t\t\tmetadata.nestedFields,\n\t\t\trelations,\n\t\t\tregistry,\n\t\t);\n\t\tconfig.fields = () => nestedDefs;\n\t\treturn;\n\t}\n\n\tif (metadata.type === \"array\") {\n\t\tconst itemMetadata = metadata.nestedFields.item as\n\t\t\t| FieldMetadata\n\t\t\t| undefined;\n\t\tif (!itemMetadata) return;\n\n\t\tif (\n\t\t\titemMetadata.type === \"object\" &&\n\t\t\t(itemMetadata as NestedFieldMetadata).nestedFields\n\t\t) {\n\t\t\tconst itemFields = buildNestedFieldDefinitions(\n\t\t\t\t(itemMetadata as NestedFieldMetadata).nestedFields ?? {},\n\t\t\t\trelations,\n\t\t\t\tregistry,\n\t\t\t);\n\t\t\tconfig.item = () => itemFields;\n\t\t\treturn;\n\t\t}\n\n\t\tconst itemType = mapArrayItemType(itemMetadata.type);\n\t\tif (itemType) {\n\t\t\tconfig.itemType = itemType;\n\t\t\tif (itemMetadata.type === \"select\") {\n\t\t\t\tapplySelectConfig(config, itemMetadata as SelectFieldMetadata);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (metadata.type === \"blocks\") {\n\t\tconst blocksMetadata = metadata as unknown as Record<string, unknown>;\n\t\tif (blocksMetadata.allowedBlocks) {\n\t\t\tconfig.allowedBlocks = blocksMetadata.allowedBlocks;\n\t\t}\n\t\tif (blocksMetadata.minBlocks !== undefined) {\n\t\t\tconfig.minBlocks = blocksMetadata.minBlocks;\n\t\t}\n\t\tif (blocksMetadata.maxBlocks !== undefined) {\n\t\t\tconfig.maxBlocks = blocksMetadata.maxBlocks;\n\t\t}\n\t}\n}\n\nfunction applyExtraMetadata(\n\tconfig: Record<string, unknown>,\n\tmetadata: FieldMetadata,\n) {\n\tconst reservedKeys = new Set([\n\t\t\"type\",\n\t\t\"label\",\n\t\t\"description\",\n\t\t\"required\",\n\t\t\"localized\",\n\t\t\"readOnly\",\n\t\t\"writeOnly\",\n\t\t\"validation\",\n\t\t\"meta\",\n\t\t\"nestedFields\",\n\t\t\"features\",\n\t]);\n\n\tfor (const [key, value] of Object.entries(\n\t\tmetadata as unknown as Record<string, unknown>,\n\t)) {\n\t\tif (reservedKeys.has(key)) continue;\n\t\tif (key.startsWith(\"_\")) continue;\n\t\tif (value === undefined) continue;\n\t\tconfig[key] = value;\n\t}\n}\n\nfunction applyRichTextConfig(\n\tconfig: Record<string, unknown>,\n\tmetadata: Record<string, unknown>,\n) {\n\tif (metadata.maxCharacters !== undefined) {\n\t\tconfig.maxCharacters = metadata.maxCharacters;\n\t\tconfig.showCharacterCount = true;\n\t}\n\tif (metadata.placeholder !== undefined) {\n\t\tconfig.placeholder = metadata.placeholder;\n\t}\n\tif (metadata.allowImages !== undefined) {\n\t\tconfig.enableImages = metadata.allowImages;\n\t}\n\tif (metadata.imageCollection !== undefined) {\n\t\tconfig.imageCollection = metadata.imageCollection;\n\t}\n}\n\nfunction buildNestedFieldDefinitions(\n\tnestedFields: Record<string, FieldMetadata>,\n\trelations: Record<string, RelationSchema>,\n\tregistry: FieldRegistry,\n): FieldDefinitionsResult {\n\tconst result: FieldDefinitionsResult = {};\n\n\tfor (const [nestedName, nestedMetadata] of Object.entries(nestedFields)) {\n\t\tconst fieldType = resolveFieldType(nestedMetadata);\n\t\tconst fieldBuilder = registry[fieldType];\n\t\tif (!fieldBuilder) continue;\n\n\t\tconst config = buildFieldConfig(\n\t\t\tnestedName,\n\t\t\tnestedMetadata,\n\t\t\trelations,\n\t\t\tregistry,\n\t\t\tfieldType,\n\t\t);\n\n\t\tconst adminConfig = (\n\t\t\tnestedMetadata.meta as { admin?: AnyAdminMeta } | undefined\n\t\t)?.admin;\n\t\tif (adminConfig) {\n\t\t\tapplyAdminConfig(config, adminConfig);\n\t\t}\n\n\t\tresult[nestedName] = fieldBuilder.$options(config);\n\t}\n\n\treturn result;\n}\n\nfunction resolveFieldType(metadata: FieldMetadata): string {\n\tif (metadata.type === \"relation\") {\n\t\tconst relationMeta = metadata as RelationFieldMetadata;\n\t\t// Upload fields are marked explicitly by server metadata\n\t\tif (relationMeta.isUpload) {\n\t\t\treturn \"upload\";\n\t\t}\n\t}\n\treturn metadata.type;\n}\n\nfunction mapArrayItemType(type: string): string | null {\n\tconst allowed = new Set([\"text\", \"number\", \"email\", \"textarea\", \"select\"]);\n\treturn allowed.has(type) ? type : null;\n}\n\n/**\n * Apply admin config overrides from server meta.admin\n *\n * Since each field type has its own admin meta with only valid properties,\n * we simply copy all defined properties from adminConfig to config.\n */\nfunction applyAdminConfig(\n\tconfig: Record<string, unknown>,\n\tadminConfig: AnyAdminMeta,\n): void {\n\t// Copy all defined properties from admin config\n\t// Each field type's admin meta only contains valid properties for that type\n\tfor (const [key, value] of Object.entries(adminConfig)) {\n\t\tif (value !== undefined) {\n\t\t\tconfig[key] = value;\n\t\t}\n\t}\n}\n\n// ============================================================================\n// Utilities\n// ============================================================================\n\n/**\n * Check if a field is a system field that shouldn't be in forms\n */\nfunction isSystemField(fieldName: string): boolean {\n\tconst systemFields = [\n\t\t\"id\",\n\t\t\"createdAt\",\n\t\t\"updatedAt\",\n\t\t\"deletedAt\",\n\t\t\"_title\",\n\t\t\"_locale\",\n\t];\n\treturn systemFields.includes(fieldName);\n}\n"],"mappings":"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"}

package/dist/client/utils/detect-relations.mjs

@@ -0,0 +1,46 @@
+//#region src/client/utils/detect-relations.ts
+function isMultiRelationType(relationType) {
+	return relationType === "hasMany" || relationType === "manyToMany" || relationType === "multiple" || relationType === "morphMany";
+}
+/**
+* Auto-detect M:N relation fields from config and build `with` clause.
+*
+* M:N relations need to be explicitly loaded when fetching items for editing,
+* as they are stored in junction tables and not included by default.
+*
+* @param config - Collection configuration with fields
+* @returns Object mapping relation field names to `true` for M:N relations
+*
+* @example
+* ```tsx
+* const withRelations = detectManyToManyRelations({ fields: config?.fields });
+*
+* // Use with query
+* const { data } = useCollectionItem(collection, id, {
+*   with: withRelations,
+* });
+* ```
+*/
+function detectManyToManyRelations(config) {
+	const withRelations = {};
+	if (config.schema?.fields) for (const [fieldName, fieldSchema] of Object.entries(config.schema.fields)) {
+		const metadata = fieldSchema?.metadata;
+		if (metadata?.type !== "relation") continue;
+		if (isMultiRelationType(metadata.relationType)) withRelations[fieldName] = true;
+	}
+	if (config?.fields) for (const [fieldName, fieldConfig] of Object.entries(config.fields)) {
+		const fc = fieldConfig;
+		if (fc?.name === "relation" && fc?.["~options"]?.type === "multiple") withRelations[fieldName] = true;
+	}
+	return withRelations;
+}
+/**
+* Check if there are any M:N relations to include
+*/
+function hasManyToManyRelations(withRelations) {
+	return Object.keys(withRelations).length > 0;
+}
+
+//#endregion
+export { detectManyToManyRelations, hasManyToManyRelations };
+//# sourceMappingURL=detect-relations.mjs.map

package/dist/client/utils/detect-relations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-relations.mjs","names":["withRelations: Record<string, boolean>"],"sources":["../../../src/client/utils/detect-relations.ts"],"sourcesContent":["/**\n * Detect Relations Utility\n *\n * Automatically detects relation fields (especially M:N relations)\n * that need to be included when fetching data for forms.\n */\n\nimport type { CollectionSchema } from \"questpie/client\";\nimport type { FieldDefinition } from \"../builder/field/field\";\n\nexport interface DetectRelationsConfig {\n\t/**\n\t * Collection fields configuration\n\t */\n\tfields?: Record<string, FieldDefinition>;\n\n\t/**\n\t * Collection schema from introspection\n\t */\n\tschema?: CollectionSchema;\n}\n\nfunction isMultiRelationType(relationType: unknown): boolean {\n\treturn (\n\t\trelationType === \"hasMany\" ||\n\t\trelationType === \"manyToMany\" ||\n\t\trelationType === \"multiple\" ||\n\t\trelationType === \"morphMany\"\n\t);\n}\n\n/**\n * Auto-detect M:N relation fields from config and build `with` clause.\n *\n * M:N relations need to be explicitly loaded when fetching items for editing,\n * as they are stored in junction tables and not included by default.\n *\n * @param config - Collection configuration with fields\n * @returns Object mapping relation field names to `true` for M:N relations\n *\n * @example\n * ```tsx\n * const withRelations = detectManyToManyRelations({ fields: config?.fields });\n *\n * // Use with query\n * const { data } = useCollectionItem(collection, id, {\n *   with: withRelations,\n * });\n * ```\n */\nexport function detectManyToManyRelations(\n\tconfig: DetectRelationsConfig,\n): Record<string, boolean> {\n\tconst withRelations: Record<string, boolean> = {};\n\n\t// Prefer schema metadata when available (source of truth from server)\n\tif (config.schema?.fields) {\n\t\tfor (const [fieldName, fieldSchema] of Object.entries(\n\t\t\tconfig.schema.fields,\n\t\t)) {\n\t\t\tconst metadata = (fieldSchema as any)?.metadata;\n\t\t\tif (metadata?.type !== \"relation\") continue;\n\n\t\t\tif (isMultiRelationType(metadata.relationType)) {\n\t\t\t\twithRelations[fieldName] = true;\n\t\t\t}\n\t\t}\n\t}\n\n\t// Fallback to local field definitions (for compatibility when schema is unavailable)\n\tif (config?.fields) {\n\t\tfor (const [fieldName, fieldConfig] of Object.entries(config.fields)) {\n\t\t\tconst fc = fieldConfig as any;\n\t\t\t// Detect M:N relation fields (FieldDefinition.name: \"relation\" with ~options.type: \"multiple\")\n\t\t\tif (fc?.name === \"relation\" && fc?.[\"~options\"]?.type === \"multiple\") {\n\t\t\t\twithRelations[fieldName] = true;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn withRelations;\n}\n\n/**\n * Check if there are any M:N relations to include\n */\nexport function hasManyToManyRelations(\n\twithRelations: Record<string, boolean>,\n): boolean {\n\treturn Object.keys(withRelations).length > 0;\n}\n"],"mappings":";AAsBA,SAAS,oBAAoB,cAAgC;AAC5D,QACC,iBAAiB,aACjB,iBAAiB,gBACjB,iBAAiB,cACjB,iBAAiB;;;;;;;;;;;;;;;;;;;;;AAuBnB,SAAgB,0BACf,QAC0B;CAC1B,MAAMA,gBAAyC,EAAE;AAGjD,KAAI,OAAO,QAAQ,OAClB,MAAK,MAAM,CAAC,WAAW,gBAAgB,OAAO,QAC7C,OAAO,OAAO,OACd,EAAE;EACF,MAAM,WAAY,aAAqB;AACvC,MAAI,UAAU,SAAS,WAAY;AAEnC,MAAI,oBAAoB,SAAS,aAAa,CAC7C,eAAc,aAAa;;AAM9B,KAAI,QAAQ,OACX,MAAK,MAAM,CAAC,WAAW,gBAAgB,OAAO,QAAQ,OAAO,OAAO,EAAE;EACrE,MAAM,KAAK;AAEX,MAAI,IAAI,SAAS,cAAc,KAAK,aAAa,SAAS,WACzD,eAAc,aAAa;;AAK9B,QAAO;;;;;AAMR,SAAgB,uBACf,eACU;AACV,QAAO,OAAO,KAAK,cAAc,CAAC,SAAS"}

package/dist/client/utils/locale-to-flag.d.mts

@@ -0,0 +1,118 @@
+//#region src/client/utils/locale-to-flag.d.ts
+/**
+ * Locale to Flag Utility
+ *
+ * Converts locale codes to country codes for flag display.
+ * Uses flagcdn.com for PNG flags via CDN (no dependencies).
+ *
+ * ## Features
+ *
+ * - **Smart mapping**: Automatically maps locale codes to country codes (sk → SK, en → GB, en-US → US)
+ * - **Custom overrides**: Support for custom country codes via `flagCountryCode` in locale config
+ * - **Lightweight**: No dependencies, uses CDN for flags
+ * - **Fallback support**: Gracefully handles unknown locale codes
+ *
+ * ## Usage
+ *
+ * ### Basic Usage
+ *
+ * ```tsx
+ * import { getFlagUrl } from "@questpie/admin/client";
+ *
+ * function LocaleBadge({ locale }: { locale: string }) {
+ *   return (
+ *     <div>
+ *       <img src={getFlagUrl(locale, 20)} alt={locale} />
+ *       {locale}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * ### Custom Country Code Mapping
+ *
+ * If the default mapping doesn't fit your needs, you can provide custom mapping:
+ *
+ * ```tsx
+ * // Show US flag for English instead of UK
+ * const flagUrl = getFlagUrl("en", 20, { en: "us" });
+ * ```
+ *
+ * ### In CMS Configuration
+ *
+ * The best way to customize flag mapping is in your CMS locale config:
+ *
+ * ```ts
+ * // questpie/server/cms.ts
+ * q().locale({
+ *   locales: [
+ *     {
+ *       code: "en",
+ *       label: "English",
+ *       flagCountryCode: "us", // Show US flag instead of UK
+ *     },
+ *     { code: "sk", label: "Slovenčina" },
+ *   ],
+ *   defaultLocale: "en",
+ * })
+ * ```
+ *
+ * The `flagCountryCode` will be automatically used by `LocaleSwitcher` and other locale UI components.
+ */
+interface FlagConfig {
+  /** Country code (ISO 3166-1 alpha-2) */
+  countryCode: string;
+  /** Alt text for accessibility */
+  alt: string;
+}
+/**
+ * Get country code from locale code.
+ *
+ * @param locale - Locale code (e.g., "en", "sk", "en-US")
+ * @param customMapping - Optional custom locale-to-country mapping (overrides defaults)
+ * @returns Country code (lowercase, e.g., "gb", "sk", "us")
+ *
+ * @example
+ * ```ts
+ * getCountryCode("en") // "gb" (default)
+ * getCountryCode("en-US") // "us"
+ * getCountryCode("sk") // "sk"
+ * getCountryCode("en", { en: "us" }) // "us" (custom mapping)
+ * getCountryCode("unknown") // "unknown" (fallback to input)
+ * ```
+ */
+declare function getCountryCode(locale: string, customMapping?: Record<string, string>): string;
+/**
+ * Get flag configuration for a locale.
+ *
+ * @param locale - Locale code
+ * @param customMapping - Optional custom locale-to-country mapping
+ * @returns Flag configuration with country code and alt text
+ *
+ * @example
+ * ```ts
+ * getFlagConfig("sk") // { countryCode: "sk", alt: "Slovakia" }
+ * getFlagConfig("en-US") // { countryCode: "us", alt: "United States" }
+ * getFlagConfig("en", { en: "us" }) // { countryCode: "us", alt: "EN" }
+ * ```
+ */
+declare function getFlagConfig(locale: string, customMapping?: Record<string, string>): FlagConfig;
+/**
+ * Get flag image URL from flagcdn.com.
+ *
+ * @param locale - Locale code
+ * @param size - Width in pixels (default: 20)
+ * @param customMapping - Optional custom locale-to-country mapping
+ * @returns URL to flag PNG
+ *
+ * @example
+ * ```tsx
+ * <img src={getFlagUrl("sk")} alt="SK" />
+ * <img src={getFlagUrl("en-US", 40)} alt="EN-US" />
+ * <img src={getFlagUrl("en", 20, { en: "us" })} alt="EN" />
+ * ```
+ */
+declare function getFlagUrl(locale: string, size?: number, customMapping?: Record<string, string>): string;
+//#endregion
+export { FlagConfig, getCountryCode, getFlagConfig, getFlagUrl };
+//# sourceMappingURL=locale-to-flag.d.mts.map

package/dist/client/utils/locale-to-flag.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-to-flag.d.mts","names":[],"sources":["../../../src/client/utils/locale-to-flag.ts"],"sourcesContent":[],"mappings":";;AAiEA;AAoGA;AA2CA;AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAzKiB,UAAA;;;;;;;;;;;;;;;;;;;;;;iBAoGD,cAAA,iCAEE;;;;;;;;;;;;;;;iBAyCF,aAAA,iCAEE,yBACf;;;;;;;;;;;;;;;;iBAuBa,UAAA,gDAGE"}

package/dist/client/utils/locale-to-flag.mjs

@@ -0,0 +1,130 @@
+//#region src/client/utils/locale-to-flag.ts
+/**
+* Maps locale codes to country codes.
+* Handles both simple codes (en, sk) and region-specific (en-US, en-GB).
+*/
+const LOCALE_TO_COUNTRY = {
+	en: "gb",
+	"en-US": "us",
+	"en-GB": "gb",
+	"en-CA": "ca",
+	"en-AU": "au",
+	"en-NZ": "nz",
+	"en-IE": "ie",
+	sk: "sk",
+	cs: "cz",
+	de: "de",
+	"de-AT": "at",
+	"de-CH": "ch",
+	fr: "fr",
+	"fr-CA": "ca",
+	"fr-CH": "ch",
+	es: "es",
+	"es-MX": "mx",
+	"es-AR": "ar",
+	it: "it",
+	pt: "pt",
+	"pt-BR": "br",
+	nl: "nl",
+	pl: "pl",
+	ru: "ru",
+	uk: "ua",
+	tr: "tr",
+	sv: "se",
+	no: "no",
+	da: "dk",
+	fi: "fi",
+	hu: "hu",
+	ro: "ro",
+	bg: "bg",
+	hr: "hr",
+	sr: "rs",
+	sl: "si",
+	et: "ee",
+	lv: "lv",
+	lt: "lt",
+	zh: "cn",
+	"zh-CN": "cn",
+	"zh-TW": "tw",
+	"zh-HK": "hk",
+	ja: "jp",
+	ko: "kr",
+	th: "th",
+	vi: "vn",
+	id: "id",
+	ms: "my",
+	hi: "in",
+	ar: "sa",
+	he: "il",
+	el: "gr",
+	fa: "ir",
+	ur: "pk"
+};
+/**
+* Get country code from locale code.
+*
+* @param locale - Locale code (e.g., "en", "sk", "en-US")
+* @param customMapping - Optional custom locale-to-country mapping (overrides defaults)
+* @returns Country code (lowercase, e.g., "gb", "sk", "us")
+*
+* @example
+* ```ts
+* getCountryCode("en") // "gb" (default)
+* getCountryCode("en-US") // "us"
+* getCountryCode("sk") // "sk"
+* getCountryCode("en", { en: "us" }) // "us" (custom mapping)
+* getCountryCode("unknown") // "unknown" (fallback to input)
+* ```
+*/
+function getCountryCode(locale, customMapping) {
+	const normalized = locale.toLowerCase();
+	if (customMapping?.[normalized]) return customMapping[normalized].toLowerCase();
+	if (LOCALE_TO_COUNTRY[normalized]) return LOCALE_TO_COUNTRY[normalized];
+	const baseCode = normalized.split("-")[0];
+	if (baseCode && customMapping?.[baseCode]) return customMapping[baseCode].toLowerCase();
+	if (baseCode && LOCALE_TO_COUNTRY[baseCode]) return LOCALE_TO_COUNTRY[baseCode];
+	return normalized;
+}
+/**
+* Get flag configuration for a locale.
+*
+* @param locale - Locale code
+* @param customMapping - Optional custom locale-to-country mapping
+* @returns Flag configuration with country code and alt text
+*
+* @example
+* ```ts
+* getFlagConfig("sk") // { countryCode: "sk", alt: "Slovakia" }
+* getFlagConfig("en-US") // { countryCode: "us", alt: "United States" }
+* getFlagConfig("en", { en: "us" }) // { countryCode: "us", alt: "EN" }
+* ```
+*/
+function getFlagConfig(locale, customMapping) {
+	return {
+		countryCode: getCountryCode(locale, customMapping),
+		alt: locale.toUpperCase()
+	};
+}
+/**
+* Get flag image URL from flagcdn.com.
+*
+* @param locale - Locale code
+* @param size - Width in pixels (default: 20)
+* @param customMapping - Optional custom locale-to-country mapping
+* @returns URL to flag PNG
+*
+* @example
+* ```tsx
+* <img src={getFlagUrl("sk")} alt="SK" />
+* <img src={getFlagUrl("en-US", 40)} alt="EN-US" />
+* <img src={getFlagUrl("en", 20, { en: "us" })} alt="EN" />
+* ```
+*/
+function getFlagUrl(locale, size = 24, customMapping) {
+	const { countryCode } = getFlagConfig(locale, customMapping);
+	return `https://flagcdn.com/h${size}/${countryCode}.png`;
+}
+
+//#endregion
+export { getCountryCode, getFlagConfig, getFlagUrl };
+//# sourceMappingURL=locale-to-flag.mjs.map

package/dist/client/utils/locale-to-flag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-to-flag.mjs","names":["LOCALE_TO_COUNTRY: Record<string, string>"],"sources":["../../../src/client/utils/locale-to-flag.ts"],"sourcesContent":["/**\n * Locale to Flag Utility\n *\n * Converts locale codes to country codes for flag display.\n * Uses flagcdn.com for PNG flags via CDN (no dependencies).\n *\n * ## Features\n *\n * - **Smart mapping**: Automatically maps locale codes to country codes (sk → SK, en → GB, en-US → US)\n * - **Custom overrides**: Support for custom country codes via `flagCountryCode` in locale config\n * - **Lightweight**: No dependencies, uses CDN for flags\n * - **Fallback support**: Gracefully handles unknown locale codes\n *\n * ## Usage\n *\n * ### Basic Usage\n *\n * ```tsx\n * import { getFlagUrl } from \"@questpie/admin/client\";\n *\n * function LocaleBadge({ locale }: { locale: string }) {\n *   return (\n *     <div>\n *       <img src={getFlagUrl(locale, 20)} alt={locale} />\n *       {locale}\n *     </div>\n *   );\n * }\n * ```\n *\n * ### Custom Country Code Mapping\n *\n * If the default mapping doesn't fit your needs, you can provide custom mapping:\n *\n * ```tsx\n * // Show US flag for English instead of UK\n * const flagUrl = getFlagUrl(\"en\", 20, { en: \"us\" });\n * ```\n *\n * ### In CMS Configuration\n *\n * The best way to customize flag mapping is in your CMS locale config:\n *\n * ```ts\n * // questpie/server/cms.ts\n * q().locale({\n *   locales: [\n *     {\n *       code: \"en\",\n *       label: \"English\",\n *       flagCountryCode: \"us\", // Show US flag instead of UK\n *     },\n *     { code: \"sk\", label: \"Slovenčina\" },\n *   ],\n *   defaultLocale: \"en\",\n * })\n * ```\n *\n * The `flagCountryCode` will be automatically used by `LocaleSwitcher` and other locale UI components.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface FlagConfig {\n  /** Country code (ISO 3166-1 alpha-2) */\n  countryCode: string;\n  /** Alt text for accessibility */\n  alt: string;\n}\n\n// ============================================================================\n// Locale to Country Code Mapping\n// ============================================================================\n\n/**\n * Maps locale codes to country codes.\n * Handles both simple codes (en, sk) and region-specific (en-US, en-GB).\n */\nconst LOCALE_TO_COUNTRY: Record<string, string> = {\n  // English variants\n  en: \"gb\", // Default English → Great Britain\n  \"en-US\": \"us\",\n  \"en-GB\": \"gb\",\n  \"en-CA\": \"ca\",\n  \"en-AU\": \"au\",\n  \"en-NZ\": \"nz\",\n  \"en-IE\": \"ie\",\n\n  // European languages\n  sk: \"sk\", // Slovak\n  cs: \"cz\", // Czech\n  de: \"de\", // German\n  \"de-AT\": \"at\",\n  \"de-CH\": \"ch\",\n  fr: \"fr\", // French\n  \"fr-CA\": \"ca\",\n  \"fr-CH\": \"ch\",\n  es: \"es\", // Spanish\n  \"es-MX\": \"mx\",\n  \"es-AR\": \"ar\",\n  it: \"it\", // Italian\n  pt: \"pt\", // Portuguese\n  \"pt-BR\": \"br\",\n  nl: \"nl\", // Dutch\n  pl: \"pl\", // Polish\n  ru: \"ru\", // Russian\n  uk: \"ua\", // Ukrainian\n  tr: \"tr\", // Turkish\n  sv: \"se\", // Swedish\n  no: \"no\", // Norwegian\n  da: \"dk\", // Danish\n  fi: \"fi\", // Finnish\n  hu: \"hu\", // Hungarian\n  ro: \"ro\", // Romanian\n  bg: \"bg\", // Bulgarian\n  hr: \"hr\", // Croatian\n  sr: \"rs\", // Serbian\n  sl: \"si\", // Slovenian\n  et: \"ee\", // Estonian\n  lv: \"lv\", // Latvian\n  lt: \"lt\", // Lithuanian\n\n  // Asian languages\n  zh: \"cn\", // Chinese\n  \"zh-CN\": \"cn\",\n  \"zh-TW\": \"tw\",\n  \"zh-HK\": \"hk\",\n  ja: \"jp\", // Japanese\n  ko: \"kr\", // Korean\n  th: \"th\", // Thai\n  vi: \"vn\", // Vietnamese\n  id: \"id\", // Indonesian\n  ms: \"my\", // Malay\n  hi: \"in\", // Hindi\n  ar: \"sa\", // Arabic (Saudi Arabia as default)\n  he: \"il\", // Hebrew\n\n  // Other\n  el: \"gr\", // Greek\n  fa: \"ir\", // Persian\n  ur: \"pk\", // Urdu\n};\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Get country code from locale code.\n *\n * @param locale - Locale code (e.g., \"en\", \"sk\", \"en-US\")\n * @param customMapping - Optional custom locale-to-country mapping (overrides defaults)\n * @returns Country code (lowercase, e.g., \"gb\", \"sk\", \"us\")\n *\n * @example\n * ```ts\n * getCountryCode(\"en\") // \"gb\" (default)\n * getCountryCode(\"en-US\") // \"us\"\n * getCountryCode(\"sk\") // \"sk\"\n * getCountryCode(\"en\", { en: \"us\" }) // \"us\" (custom mapping)\n * getCountryCode(\"unknown\") // \"unknown\" (fallback to input)\n * ```\n */\nexport function getCountryCode(\n  locale: string,\n  customMapping?: Record<string, string>,\n): string {\n  const normalized = locale.toLowerCase();\n\n  // Try custom mapping first (highest priority)\n  if (customMapping?.[normalized]) {\n    return customMapping[normalized].toLowerCase();\n  }\n\n  // Try exact match in default mapping\n  if (LOCALE_TO_COUNTRY[normalized]) {\n    return LOCALE_TO_COUNTRY[normalized];\n  }\n\n  // Try base language code (e.g., \"en-US\" → \"en\")\n  const baseCode = normalized.split(\"-\")[0];\n  if (baseCode && customMapping?.[baseCode]) {\n    return customMapping[baseCode].toLowerCase();\n  }\n  if (baseCode && LOCALE_TO_COUNTRY[baseCode]) {\n    return LOCALE_TO_COUNTRY[baseCode];\n  }\n\n  // Fallback to input (useful for direct country codes)\n  return normalized;\n}\n\n/**\n * Get flag configuration for a locale.\n *\n * @param locale - Locale code\n * @param customMapping - Optional custom locale-to-country mapping\n * @returns Flag configuration with country code and alt text\n *\n * @example\n * ```ts\n * getFlagConfig(\"sk\") // { countryCode: \"sk\", alt: \"Slovakia\" }\n * getFlagConfig(\"en-US\") // { countryCode: \"us\", alt: \"United States\" }\n * getFlagConfig(\"en\", { en: \"us\" }) // { countryCode: \"us\", alt: \"EN\" }\n * ```\n */\nexport function getFlagConfig(\n  locale: string,\n  customMapping?: Record<string, string>,\n): FlagConfig {\n  const countryCode = getCountryCode(locale, customMapping);\n  return {\n    countryCode,\n    alt: locale.toUpperCase(),\n  };\n}\n\n/**\n * Get flag image URL from flagcdn.com.\n *\n * @param locale - Locale code\n * @param size - Width in pixels (default: 20)\n * @param customMapping - Optional custom locale-to-country mapping\n * @returns URL to flag PNG\n *\n * @example\n * ```tsx\n * <img src={getFlagUrl(\"sk\")} alt=\"SK\" />\n * <img src={getFlagUrl(\"en-US\", 40)} alt=\"EN-US\" />\n * <img src={getFlagUrl(\"en\", 20, { en: \"us\" })} alt=\"EN\" />\n * ```\n */\nexport function getFlagUrl(\n  locale: string,\n  size = 24,\n  customMapping?: Record<string, string>,\n): string {\n  const { countryCode } = getFlagConfig(locale, customMapping);\n  return `https://flagcdn.com/h${size}/${countryCode}.png`;\n}\n"],"mappings":";;;;;AAgFA,MAAMA,oBAA4C;CAEhD,IAAI;CACJ,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CAGT,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,SAAS;CACT,SAAS;CACT,IAAI;CACJ,SAAS;CACT,SAAS;CACT,IAAI;CACJ,SAAS;CACT,SAAS;CACT,IAAI;CACJ,IAAI;CACJ,SAAS;CACT,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CAGJ,IAAI;CACJ,SAAS;CACT,SAAS;CACT,SAAS;CACT,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CAGJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACL;;;;;;;;;;;;;;;;;AAsBD,SAAgB,eACd,QACA,eACQ;CACR,MAAM,aAAa,OAAO,aAAa;AAGvC,KAAI,gBAAgB,YAClB,QAAO,cAAc,YAAY,aAAa;AAIhD,KAAI,kBAAkB,YACpB,QAAO,kBAAkB;CAI3B,MAAM,WAAW,WAAW,MAAM,IAAI,CAAC;AACvC,KAAI,YAAY,gBAAgB,UAC9B,QAAO,cAAc,UAAU,aAAa;AAE9C,KAAI,YAAY,kBAAkB,UAChC,QAAO,kBAAkB;AAI3B,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,cACd,QACA,eACY;AAEZ,QAAO;EACL,aAFkB,eAAe,QAAQ,cAAc;EAGvD,KAAK,OAAO,aAAa;EAC1B;;;;;;;;;;;;;;;;;AAkBH,SAAgB,WACd,QACA,OAAO,IACP,eACQ;CACR,MAAM,EAAE,gBAAgB,cAAc,QAAQ,cAAc;AAC5D,QAAO,wBAAwB,KAAK,GAAG,YAAY"}