@panneau/codemods 0.0.0-stage → 5.0.0-alpha.6

package/dist/mappings.js

@@ -0,0 +1,574 @@
+import { kebabCase } from "./names.js";
+//#region src/mappings.ts
+/** Props of every v5 field (`FieldProps` of `@panneau/fields`), plus React's `key`. */
+var FIELD_PROPS = [
+	"key",
+	"value",
+	"onChange",
+	"onBlur",
+	"errors",
+	"disabled",
+	"readOnly",
+	"required",
+	"label",
+	"description",
+	"name",
+	"id",
+	"autoFocus",
+	"aria-label",
+	"className",
+	"labelClassName",
+	"descriptionClassName",
+	"errorsClassName"
+];
+/** v4 props of every field with another name in v5. */
+var FIELD_RENAMES = { helpText: "description" };
+var TEXT_PROPS = [
+	"placeholder",
+	"maxLength",
+	"prefix",
+	"suffix",
+	"type",
+	"inputMode",
+	"autoComplete",
+	"controlClassName",
+	"inputClassName"
+];
+var TEXT_RENAMES = {
+	prepend: "prefix",
+	append: "suffix"
+};
+var SELECT_PROPS = [
+	"options",
+	"placeholder",
+	"multiple",
+	"widget",
+	"controlClassName"
+];
+var MEDIA_PROPS = [
+	"accept",
+	"adapter",
+	"image",
+	"itemTitle",
+	"maxSize",
+	"multiple",
+	"refreshInterval",
+	"resource",
+	"sources",
+	"stateKey",
+	"uploadSource"
+];
+var MEDIA_NOTE = "it needs `resource`, the id of the media library, and the `mediaPlugin`";
+var text = {
+	source: "@panneau/fields/text",
+	name: "TextField",
+	props: TEXT_PROPS,
+	renames: TEXT_RENAMES,
+	valueType: "string"
+};
+var select = {
+	source: "@panneau/fields/select",
+	name: "SelectField",
+	props: SELECT_PROPS
+};
+var relation = {
+	source: "@panneau/fields/relation",
+	name: "RelationField",
+	props: [
+		"resource",
+		"multiple",
+		"onCreate",
+		"placeholder",
+		"source",
+		"controlClassName"
+	],
+	note: "it searches the resource through the relation source of the app: `resource` is its id"
+};
+var media = {
+	source: "@panneau/media",
+	name: "MediaField",
+	props: MEDIA_PROPS,
+	note: MEDIA_NOTE
+};
+var image = {
+	source: "@panneau/media",
+	name: "ImageField",
+	props: [
+		...MEDIA_PROPS,
+		"cropRequired",
+		"enforceRatios",
+		"focalPoint",
+		"ratios",
+		"rotate",
+		"transformBase"
+	],
+	note: MEDIA_NOTE
+};
+/**
+* The v5 component of each v4 field, by the v4 id in kebab case: `useFieldComponent('date_time')`
+* and `@panneau/field-date-time` both give `date-time`, as v4 looked components up by their name
+* in Pascal case.
+*/
+var FIELD_TARGETS = {
+	text,
+	textarea: {
+		source: "@panneau/fields/textarea",
+		name: "TextAreaField",
+		valueType: "string",
+		props: [
+			"maxLength",
+			"placeholder",
+			"rows",
+			"textAreaClassName"
+		]
+	},
+	email: {
+		...text,
+		source: "@panneau/fields/email",
+		name: "EmailField"
+	},
+	url: {
+		source: "@panneau/fields/url",
+		name: "UrlField",
+		valueType: "string",
+		props: [...TEXT_PROPS.filter((prop) => prop !== "suffix"), "defaultScheme"],
+		renames: { prepend: "prefix" }
+	},
+	telephone: {
+		...text,
+		source: "@panneau/fields/tel",
+		name: "TelField"
+	},
+	tel: {
+		...text,
+		source: "@panneau/fields/tel",
+		name: "TelField"
+	},
+	number: {
+		source: "@panneau/fields/number",
+		name: "NumberField",
+		valueType: "number",
+		props: [
+			"controlClassName",
+			"formatOptions",
+			"inputClassName",
+			"max",
+			"min",
+			"placeholder",
+			"step",
+			"suffix"
+		],
+		renames: { append: "suffix" }
+	},
+	color: {
+		source: "@panneau/fields/color",
+		name: "ColorField",
+		valueType: "string",
+		props: TEXT_PROPS.filter((prop) => ![
+			"type",
+			"prefix",
+			"maxLength"
+		].includes(prop))
+	},
+	date: {
+		source: "@panneau/fields/date",
+		name: "DateField",
+		valueType: "string",
+		props: [
+			"controlClassName",
+			"max",
+			"min"
+		]
+	},
+	"date-time": {
+		source: "@panneau/fields/datetime",
+		name: "DateTimeField",
+		valueType: "string",
+		props: [
+			"controlClassName",
+			"hourCycle",
+			"timeZone",
+			"withSeconds"
+		]
+	},
+	datetime: {
+		source: "@panneau/fields/datetime",
+		name: "DateTimeField",
+		valueType: "string",
+		props: [
+			"controlClassName",
+			"hourCycle",
+			"timeZone",
+			"withSeconds"
+		]
+	},
+	select,
+	radios: {
+		...select,
+		adds: { widget: "radios" }
+	},
+	checkboxes: {
+		...select,
+		adds: {
+			multiple: true,
+			widget: "checkboxes"
+		}
+	},
+	toggles: {
+		...select,
+		adds: {
+			multiple: true,
+			widget: "checkboxes"
+		}
+	},
+	toggle: {
+		source: "@panneau/fields/boolean",
+		name: "BooleanField",
+		valueType: "boolean",
+		props: ["widget", "controlClassName"],
+		adds: { widget: "switch" }
+	},
+	checkbox: {
+		source: "@panneau/fields/boolean",
+		name: "BooleanField",
+		valueType: "boolean",
+		props: ["widget", "controlClassName"]
+	},
+	embed: {
+		source: "@panneau/fields/embed",
+		name: "EmbedField",
+		props: ["embedSource", "placeholder"]
+	},
+	localized: {
+		source: "@panneau/fields/localized",
+		name: "LocalizedField",
+		props: [
+			"children",
+			"localeClassName",
+			"locales"
+		]
+	},
+	fields: {
+		source: "@panneau/fields/group",
+		name: "GroupField",
+		props: [
+			"fields",
+			"fieldsClassName",
+			"path"
+		],
+		note: "`fields` are fields of the definition of Panneau 5 (`Field[]` of `@panneau/protocol`)"
+	},
+	items: {
+		source: "@panneau/fields/repeater",
+		name: "RepeaterField",
+		props: [
+			"fields",
+			"itemClassName",
+			"max",
+			"min",
+			"path",
+			"types"
+		],
+		note: "its items are made of fields of the definition of Panneau 5, or of block `types`"
+	},
+	item: relation,
+	"resource-item": relation,
+	upload: media,
+	media,
+	video: {
+		...media,
+		adds: { accept: ["video/*"] }
+	},
+	audio: {
+		...media,
+		adds: { accept: ["audio/*"] }
+	},
+	document: media,
+	image,
+	"image-upload": image,
+	"video-upload": {
+		...media,
+		adds: { accept: ["video/*"] }
+	},
+	"audio-upload": {
+		...media,
+		adds: { accept: ["audio/*"] }
+	},
+	"document-upload": media
+};
+/** v4 fields with no v5 component, and what replaces them. */
+var FIELDS_WITHOUT_TARGET = {
+	html: "the `richtext` field of `@panneau/editor` replaces it",
+	password: "Panneau 5 has no password field",
+	autocomplete: "Panneau 5 has no autocomplete field: a `select` or a `relation` replaces it",
+	display: "Panneau 5 has no display field: read-only fields (`readOnly`) replace it",
+	"input-group": "Panneau 5 has no input group: the `prefix` and `suffix` of text fields replace it",
+	import: "Panneau 5 has no import field: the `import` action replaces it"
+};
+/** The v5 component of a v4 field id (`date_time`, `DateTime`, `date-time`). */
+function getFieldTarget(id) {
+	return FIELD_TARGETS[kebabCase(id)] ?? null;
+}
+/** v4 namespaces of the `components` prop of the app, and the kinds of v5 plugins. */
+var NAMESPACES = {
+	fields: {
+		kind: "fields",
+		constant: "FIELDS_NAMESPACE"
+	},
+	displays: {
+		kind: "displays",
+		constant: "DISPLAYS_NAMESPACE",
+		note: "displays of Panneau 5 get `value`, `item`, `field` and `column` (`DisplayProps` of `@panneau/lists`)"
+	},
+	actions: {
+		kind: "actions",
+		constant: "ACTIONS_NAMESPACE",
+		note: "actions of Panneau 5 are handlers of `client` actions of the definition, not buttons: see decision 0017"
+	},
+	pages: {
+		kind: "pages",
+		constant: "PAGES_NAMESPACE",
+		note: "pages of Panneau 5 render inside the shell of the app: drop `MainLayout` and `PageHeader`"
+	},
+	previews: {
+		kind: "previews",
+		constant: "PREVIEWS_NAMESPACE",
+		note: "previews of Panneau 5 get `PreviewProps` of `@panneau/core`"
+	},
+	lists: {
+		kind: "listLayouts",
+		constant: "LISTS_NAMESPACE",
+		note: "list layouts of Panneau 5 render the list state of `@panneau/lists`"
+	},
+	forms: {
+		kind: null,
+		constant: "FORMS_NAMESPACE"
+	},
+	filters: {
+		kind: null,
+		constant: "FILTERS_NAMESPACE"
+	},
+	modals: {
+		kind: null,
+		constant: "MODALS_NAMESPACE"
+	},
+	buttons: {
+		kind: null,
+		constant: "BUTTONS_NAMESPACE"
+	},
+	app: {
+		kind: null,
+		constant: "APP_NAMESPACE"
+	}
+};
+/** The namespace of a constant of `@panneau/core/contexts` (`FIELDS_NAMESPACE`). */
+function getNamespaceOfConstant(constant) {
+	return Object.entries(NAMESPACES).find(([, namespace]) => namespace.constant === constant)?.[0] ?? null;
+}
+/**
+* Packages of v4 that have a package of the same name in v5. Their main entry point is v5 for
+* every name but those listed here, which only v4 exported (`default` is the default export).
+*/
+var SHARED_PACKAGES = {
+	"@panneau/actions": ["default"],
+	"@panneau/app": [
+		"default",
+		"MainLayout",
+		"GuestLayout",
+		"PageHeader",
+		"ResourceFilters",
+		"ResourceItemsList",
+		"ResourceForm"
+	],
+	"@panneau/auth": [
+		"default",
+		"AuthProvider",
+		"useAuth",
+		"useUser",
+		"useSetUser",
+		"useLogout",
+		"useLoggedIn",
+		"useAuthCheck",
+		"useAuthLogin",
+		"useAuthLogout",
+		"useAuthRegister",
+		"useAuthRequestPassword",
+		"useAuthResetPassword"
+	],
+	"@panneau/core": [
+		"default",
+		"ComponentsManager",
+		"DefinitionsManager",
+		"EventsManager",
+		"FieldsManager",
+		"FontsParser",
+		"FormsManager",
+		"MediasParser",
+		"Tracking",
+		"Action",
+		"ActionDefinition",
+		"ActionValue",
+		"AudioMedia",
+		"Breadcrumb",
+		"BreakpointsSize",
+		"Button",
+		"ButtonElement",
+		"ButtonSize",
+		"ButtonTheme",
+		"ButtonType",
+		"Column",
+		"ComponentsMap",
+		"ControlSize",
+		"Definition",
+		"DialogSize",
+		"DropdownAlign",
+		"Feedback",
+		"Field",
+		"FieldDefinition",
+		"FieldOption",
+		"FieldSettings",
+		"Filter",
+		"Font",
+		"FormDefinition",
+		"FormError",
+		"ImageMedia",
+		"Item",
+		"Label",
+		"Media",
+		"MediaFile",
+		"MediaType",
+		"MenuItem",
+		"Message",
+		"MessageValue",
+		"MessageValues",
+		"Modal",
+		"PageDefinition",
+		"Pagination",
+		"PanneauAuth",
+		"PanneauComponents",
+		"PanneauDefinition",
+		"PanneauIntl",
+		"PanneauIntlValues",
+		"PanneauMenuItem",
+		"PanneauMenus",
+		"PanneauPages",
+		"PanneauTheme",
+		"Preview",
+		"Resource",
+		"ResourceForm",
+		"ResourceForms",
+		"ResourceIndex",
+		"ResourceIntl",
+		"ResourceIntlValues",
+		"ResourceItem",
+		"ResourcePages",
+		"ResourceType",
+		"RouteDefinition",
+		"Routes",
+		"SelectOption",
+		"StatusCode",
+		"TableColumn",
+		"Toggle",
+		"TrackingVariables",
+		"TriggerUpdate",
+		"Uppy",
+		"User",
+		"VideoMedia"
+	],
+	"@panneau/data": [
+		"default",
+		"Api",
+		"BaseApi",
+		"DataProvider",
+		"ApiProvider",
+		"useApi",
+		"QueryProvider",
+		"useQueryContext",
+		"useItem",
+		"useItems",
+		"UseItemsResponse",
+		"useResourceDestroy",
+		"useResourceItem",
+		"useResourceItems",
+		"useResourceStore",
+		"useResourceUpdate",
+		"useResourceClone",
+		"useResourceRestore"
+	],
+	"@panneau/fields": ["default"],
+	"@panneau/forms": ["default"],
+	"@panneau/intl": [
+		"default",
+		"IntlManager",
+		"IntlProvider",
+		"ResourceMessage",
+		"useResourceValues"
+	],
+	"@panneau/lists": ["default"]
+};
+/** Packages that only exist in v4. Their imports are rewritten or reported. */
+function isV4Package(name) {
+	return /^@panneau\/(action|display|element|field|filter|form|list|modal)-/.test(name) || [
+		"@panneau/ckeditor",
+		"@panneau/displays",
+		"@panneau/filters",
+		"@panneau/form",
+		"@panneau/medias",
+		"@panneau/modals",
+		"@panneau/panneau",
+		"@panneau/themes",
+		"@panneau/uppy"
+	].includes(name);
+}
+/** What replaces v4 exports, by module and name, for the messages of the report. */
+var REPLACEMENTS = {
+	"@panneau/core/contexts": {
+		usePanneauResource: "`useResource(id)` of `@panneau/core` gives `{ resource, form, list }`: the fields of the resource are `resource.fields`, fields of the protocol",
+		usePanneauResources: "`useDefinition()` of `@panneau/data/query` gives the definition, with its `resources`",
+		useResource: "a field of Panneau 5 gets its values from its props: `useResource(id)` of `@panneau/core` resolves a resource of the definition",
+		useUrlGenerator: "Panneau 5 has no named routes: link to `{basePath}/resources/{resource}/{id}` (decision 0019), or run a resource action",
+		usePanneau: "`usePanneau()` of `@panneau/core` gives the definition and the plugins: custom keys of the definition move to `settings` of the resources or fields",
+		useFormSetValue: "`useFormContext().setValue(path, value)` of `@panneau/forms` sets the value of another field",
+		useForm: "a field of Panneau 5 reads its form through `useFormContext()` of `@panneau/forms`",
+		useLocales: "`useFieldsContext().locales` of `@panneau/fields`",
+		useListComponent: "list layouts come from plugins (`listLayouts`); `ListView` of `@panneau/lists` renders one",
+		useModalComponent: "`Dialog` of `@panneau/ui`",
+		useDisplayComponent: "displays come from plugins (`displays`); `@panneau/lists` exports the built-in ones",
+		ResourceProvider: "Panneau 5 has no resource context: pass the resource id as a prop"
+	},
+	"@panneau/data": {
+		useResourceItems: "`useResourceList(resource, query)` of `@panneau/data/query`: its `data.data` are the items, and the query is a list query of the protocol (`page`, `perPage`, `filter`)",
+		useResourceItem: "`useResourceItem(resource, id)` of `@panneau/data/query`: its `data` is the item",
+		useItems: "`useResourceList(resource, query)` of `@panneau/data/query`",
+		useItem: "`useResourceItem(resource, id)` of `@panneau/data/query`"
+	},
+	"@panneau/app": {
+		MainLayout: "pages of Panneau 5 render inside the shell of the app: drop the layout",
+		PageHeader: "pages of Panneau 5 render inside the shell of the app, which shows their title",
+		ResourceItemsList: "`ListView` of `@panneau/lists`, with `useResourceList()` of `@panneau/data/query`",
+		ResourceForm: "`FormView` of `@panneau/forms`"
+	},
+	"@panneau/medias": { MediasBrowserProvider: "the media field and picker of `@panneau/media` (`mediaPlugin`) browse the media libraries through the adapter" },
+	"@panneau/intl": {
+		default: "messages come with the packages and with plugins (`locales`)",
+		useResourceValues: "labels of resources come from the definition, already translated"
+	},
+	"@panneau/element-button": { default: "`Button` of `@panneau/ui` (`variant` and `tone` instead of `theme`, Lucide icons)" },
+	"@panneau/element-buttons": { default: "`Inline` and `Button` of `@panneau/ui`" },
+	"@panneau/element-modal": { default: "`Dialog` of `@panneau/ui`" },
+	"@panneau/modal-dialog": { default: "`Dialog` of `@panneau/ui`" },
+	"@panneau/element-card": { default: "`Card` of `@panneau/ui`" },
+	"@panneau/element-alert": { default: "`Alert` of `@panneau/ui`" },
+	"@panneau/element-loading": { default: "`Skeleton` of `@panneau/ui` while content loads, `Spinner` for an operation in progress" },
+	"@panneau/element-icon": { default: "`Icon` of `@panneau/ui`, with Lucide icons" },
+	"@panneau/element-label": { default: "labels are given to fields and primitives as `label`" },
+	"@panneau/element-select": { default: "`Select` of `@panneau/ui`, or `SelectField` of `@panneau/fields/select`" },
+	"@panneau/element-radios": { default: "`RadioGroup` of `@panneau/ui`" },
+	"@panneau/element-range": { default: "`Slider` of `@panneau/ui`" },
+	"@panneau/element-table": { default: "`ListView` of `@panneau/lists`" },
+	"@panneau/form": { default: "`Form` of `@panneau/forms`, with fields of the protocol" }
+};
+//#endregion
+export { FIELDS_WITHOUT_TARGET, FIELD_PROPS, FIELD_RENAMES, FIELD_TARGETS, NAMESPACES, REPLACEMENTS, SHARED_PACKAGES, getFieldTarget, getNamespaceOfConstant, isV4Package };
+
+//# sourceMappingURL=mappings.js.map

package/dist/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","names":[],"sources":["../src/mappings.ts"],"sourcesContent":["// What v4 code becomes in Panneau 5: the field components, the modules and their exports. The\n// codemods only rewrite what these tables settle, and report the rest.\nimport { kebabCase } from './names';\n\n/** A v5 field component that replaces a v4 one. */\nexport interface FieldTarget {\n    /** Module of the v5 component. */\n    source: string;\n    /** Export of the v5 component. */\n    name: string;\n    /** Props of the v5 component besides those of every field (`FieldProps`). */\n    props: readonly string[];\n    /** v4 props that have another name in v5. */\n    renames?: Readonly<Record<string, string>>;\n    /** Props that give the v5 component the behavior of the v4 one (`widget=\"radios\"`). */\n    adds?: Readonly<Record<string, string | true | readonly string[]>>;\n    /** The type of the value, for the input of a locale of a localized field in TypeScript. */\n    valueType?: 'string' | 'number' | 'boolean';\n    /** What to check after the rewrite, when the props of the v4 and v5 components differ. */\n    note?: string;\n}\n\n/** Props of every v5 field (`FieldProps` of `@panneau/fields`), plus React's `key`. */\nexport const FIELD_PROPS: readonly string[] = [\n    'key',\n    'value',\n    'onChange',\n    'onBlur',\n    'errors',\n    'disabled',\n    'readOnly',\n    'required',\n    'label',\n    'description',\n    'name',\n    'id',\n    'autoFocus',\n    'aria-label',\n    'className',\n    'labelClassName',\n    'descriptionClassName',\n    'errorsClassName',\n];\n\n/** v4 props of every field with another name in v5. */\nexport const FIELD_RENAMES: Readonly<Record<string, string>> = { helpText: 'description' };\n\nconst TEXT_PROPS = [\n    'placeholder',\n    'maxLength',\n    'prefix',\n    'suffix',\n    'type',\n    'inputMode',\n    'autoComplete',\n    'controlClassName',\n    'inputClassName',\n];\nconst TEXT_RENAMES = { prepend: 'prefix', append: 'suffix' };\nconst SELECT_PROPS = ['options', 'placeholder', 'multiple', 'widget', 'controlClassName'];\nconst MEDIA_PROPS = [\n    'accept',\n    'adapter',\n    'image',\n    'itemTitle',\n    'maxSize',\n    'multiple',\n    'refreshInterval',\n    'resource',\n    'sources',\n    'stateKey',\n    'uploadSource',\n];\nconst MEDIA_NOTE = 'it needs `resource`, the id of the media library, and the `mediaPlugin`';\n\nconst text: FieldTarget = {\n    source: '@panneau/fields/text',\n    name: 'TextField',\n    props: TEXT_PROPS,\n    renames: TEXT_RENAMES,\n    valueType: 'string',\n};\nconst select: FieldTarget = {\n    source: '@panneau/fields/select',\n    name: 'SelectField',\n    props: SELECT_PROPS,\n};\nconst relation: FieldTarget = {\n    source: '@panneau/fields/relation',\n    name: 'RelationField',\n    props: ['resource', 'multiple', 'onCreate', 'placeholder', 'source', 'controlClassName'],\n    note: 'it searches the resource through the relation source of the app: `resource` is its id',\n};\nconst media: FieldTarget = {\n    source: '@panneau/media',\n    name: 'MediaField',\n    props: MEDIA_PROPS,\n    note: MEDIA_NOTE,\n};\nconst image: FieldTarget = {\n    source: '@panneau/media',\n    name: 'ImageField',\n    props: [\n        ...MEDIA_PROPS,\n        'cropRequired',\n        'enforceRatios',\n        'focalPoint',\n        'ratios',\n        'rotate',\n        'transformBase',\n    ],\n    note: MEDIA_NOTE,\n};\n\n/**\n * The v5 component of each v4 field, by the v4 id in kebab case: `useFieldComponent('date_time')`\n * and `@panneau/field-date-time` both give `date-time`, as v4 looked components up by their name\n * in Pascal case.\n */\nexport const FIELD_TARGETS: Readonly<Record<string, FieldTarget>> = {\n    text,\n    textarea: {\n        source: '@panneau/fields/textarea',\n        name: 'TextAreaField',\n        valueType: 'string',\n        props: ['maxLength', 'placeholder', 'rows', 'textAreaClassName'],\n    },\n    email: { ...text, source: '@panneau/fields/email', name: 'EmailField' },\n    url: {\n        source: '@panneau/fields/url',\n        name: 'UrlField',\n        valueType: 'string',\n        props: [...TEXT_PROPS.filter((prop) => prop !== 'suffix'), 'defaultScheme'],\n        renames: { prepend: 'prefix' },\n    },\n    telephone: { ...text, source: '@panneau/fields/tel', name: 'TelField' },\n    tel: { ...text, source: '@panneau/fields/tel', name: 'TelField' },\n    number: {\n        source: '@panneau/fields/number',\n        name: 'NumberField',\n        valueType: 'number',\n        props: [\n            'controlClassName',\n            'formatOptions',\n            'inputClassName',\n            'max',\n            'min',\n            'placeholder',\n            'step',\n            'suffix',\n        ],\n        renames: { append: 'suffix' },\n    },\n    color: {\n        source: '@panneau/fields/color',\n        name: 'ColorField',\n        valueType: 'string',\n        props: TEXT_PROPS.filter((prop) => !['type', 'prefix', 'maxLength'].includes(prop)),\n    },\n    date: {\n        source: '@panneau/fields/date',\n        name: 'DateField',\n        valueType: 'string',\n        props: ['controlClassName', 'max', 'min'],\n    },\n    'date-time': {\n        source: '@panneau/fields/datetime',\n        name: 'DateTimeField',\n        valueType: 'string',\n        props: ['controlClassName', 'hourCycle', 'timeZone', 'withSeconds'],\n    },\n    datetime: {\n        source: '@panneau/fields/datetime',\n        name: 'DateTimeField',\n        valueType: 'string',\n        props: ['controlClassName', 'hourCycle', 'timeZone', 'withSeconds'],\n    },\n    select,\n    radios: { ...select, adds: { widget: 'radios' } },\n    checkboxes: { ...select, adds: { multiple: true, widget: 'checkboxes' } },\n    toggles: { ...select, adds: { multiple: true, widget: 'checkboxes' } },\n    toggle: {\n        source: '@panneau/fields/boolean',\n        name: 'BooleanField',\n        valueType: 'boolean',\n        props: ['widget', 'controlClassName'],\n        adds: { widget: 'switch' },\n    },\n    checkbox: {\n        source: '@panneau/fields/boolean',\n        name: 'BooleanField',\n        valueType: 'boolean',\n        props: ['widget', 'controlClassName'],\n    },\n    embed: {\n        source: '@panneau/fields/embed',\n        name: 'EmbedField',\n        props: ['embedSource', 'placeholder'],\n    },\n    localized: {\n        source: '@panneau/fields/localized',\n        name: 'LocalizedField',\n        props: ['children', 'localeClassName', 'locales'],\n    },\n    fields: {\n        source: '@panneau/fields/group',\n        name: 'GroupField',\n        props: ['fields', 'fieldsClassName', 'path'],\n        note: '`fields` are fields of the definition of Panneau 5 (`Field[]` of `@panneau/protocol`)',\n    },\n    items: {\n        source: '@panneau/fields/repeater',\n        name: 'RepeaterField',\n        props: ['fields', 'itemClassName', 'max', 'min', 'path', 'types'],\n        note: 'its items are made of fields of the definition of Panneau 5, or of block `types`',\n    },\n    item: relation,\n    'resource-item': relation,\n    upload: media,\n    media,\n    video: { ...media, adds: { accept: ['video/*'] } },\n    audio: { ...media, adds: { accept: ['audio/*'] } },\n    document: media,\n    image,\n    'image-upload': image,\n    'video-upload': { ...media, adds: { accept: ['video/*'] } },\n    'audio-upload': { ...media, adds: { accept: ['audio/*'] } },\n    'document-upload': media,\n};\n\n/** v4 fields with no v5 component, and what replaces them. */\nexport const FIELDS_WITHOUT_TARGET: Readonly<Record<string, string>> = {\n    html: 'the `richtext` field of `@panneau/editor` replaces it',\n    password: 'Panneau 5 has no password field',\n    autocomplete: 'Panneau 5 has no autocomplete field: a `select` or a `relation` replaces it',\n    display: 'Panneau 5 has no display field: read-only fields (`readOnly`) replace it',\n    'input-group':\n        'Panneau 5 has no input group: the `prefix` and `suffix` of text fields replace it',\n    import: 'Panneau 5 has no import field: the `import` action replaces it',\n};\n\n/** The v5 component of a v4 field id (`date_time`, `DateTime`, `date-time`). */\nexport function getFieldTarget(id: string): FieldTarget | null {\n    return FIELD_TARGETS[kebabCase(id)] ?? null;\n}\n\n/** v4 namespaces of the `components` prop of the app, and the kinds of v5 plugins. */\nexport const NAMESPACES: Readonly<\n    Record<string, { kind: string | null; note?: string; constant: string }>\n> = {\n    fields: { kind: 'fields', constant: 'FIELDS_NAMESPACE' },\n    displays: {\n        kind: 'displays',\n        constant: 'DISPLAYS_NAMESPACE',\n        note: 'displays of Panneau 5 get `value`, `item`, `field` and `column` (`DisplayProps` of `@panneau/lists`)',\n    },\n    actions: {\n        kind: 'actions',\n        constant: 'ACTIONS_NAMESPACE',\n        note: 'actions of Panneau 5 are handlers of `client` actions of the definition, not buttons: see decision 0017',\n    },\n    pages: {\n        kind: 'pages',\n        constant: 'PAGES_NAMESPACE',\n        note: 'pages of Panneau 5 render inside the shell of the app: drop `MainLayout` and `PageHeader`',\n    },\n    previews: {\n        kind: 'previews',\n        constant: 'PREVIEWS_NAMESPACE',\n        note: 'previews of Panneau 5 get `PreviewProps` of `@panneau/core`',\n    },\n    lists: {\n        kind: 'listLayouts',\n        constant: 'LISTS_NAMESPACE',\n        note: 'list layouts of Panneau 5 render the list state of `@panneau/lists`',\n    },\n    forms: { kind: null, constant: 'FORMS_NAMESPACE' },\n    filters: { kind: null, constant: 'FILTERS_NAMESPACE' },\n    modals: { kind: null, constant: 'MODALS_NAMESPACE' },\n    buttons: { kind: null, constant: 'BUTTONS_NAMESPACE' },\n    app: { kind: null, constant: 'APP_NAMESPACE' },\n};\n\n/** The namespace of a constant of `@panneau/core/contexts` (`FIELDS_NAMESPACE`). */\nexport function getNamespaceOfConstant(constant: string): string | null {\n    return (\n        Object.entries(NAMESPACES).find(([, namespace]) => namespace.constant === constant)?.[0] ??\n        null\n    );\n}\n\n/**\n * Packages of v4 that have a package of the same name in v5. Their main entry point is v5 for\n * every name but those listed here, which only v4 exported (`default` is the default export).\n */\nexport const SHARED_PACKAGES: Readonly<Record<string, readonly string[]>> = {\n    '@panneau/actions': ['default'],\n    '@panneau/app': [\n        'default',\n        'MainLayout',\n        'GuestLayout',\n        'PageHeader',\n        'ResourceFilters',\n        'ResourceItemsList',\n        'ResourceForm',\n    ],\n    '@panneau/auth': [\n        'default',\n        'AuthProvider',\n        'useAuth',\n        'useUser',\n        'useSetUser',\n        'useLogout',\n        'useLoggedIn',\n        'useAuthCheck',\n        'useAuthLogin',\n        'useAuthLogout',\n        'useAuthRegister',\n        'useAuthRequestPassword',\n        'useAuthResetPassword',\n    ],\n    '@panneau/core': [\n        'default',\n        'ComponentsManager',\n        'DefinitionsManager',\n        'EventsManager',\n        'FieldsManager',\n        'FontsParser',\n        'FormsManager',\n        'MediasParser',\n        'Tracking',\n        // Types of v4. `Form` and `FormStatus` are left out: v5 exports types of the same names.\n        'Action',\n        'ActionDefinition',\n        'ActionValue',\n        'AudioMedia',\n        'Breadcrumb',\n        'BreakpointsSize',\n        'Button',\n        'ButtonElement',\n        'ButtonSize',\n        'ButtonTheme',\n        'ButtonType',\n        'Column',\n        'ComponentsMap',\n        'ControlSize',\n        'Definition',\n        'DialogSize',\n        'DropdownAlign',\n        'Feedback',\n        'Field',\n        'FieldDefinition',\n        'FieldOption',\n        'FieldSettings',\n        'Filter',\n        'Font',\n        'FormDefinition',\n        'FormError',\n        'ImageMedia',\n        'Item',\n        'Label',\n        'Media',\n        'MediaFile',\n        'MediaType',\n        'MenuItem',\n        'Message',\n        'MessageValue',\n        'MessageValues',\n        'Modal',\n        'PageDefinition',\n        'Pagination',\n        'PanneauAuth',\n        'PanneauComponents',\n        'PanneauDefinition',\n        'PanneauIntl',\n        'PanneauIntlValues',\n        'PanneauMenuItem',\n        'PanneauMenus',\n        'PanneauPages',\n        'PanneauTheme',\n        'Preview',\n        'Resource',\n        'ResourceForm',\n        'ResourceForms',\n        'ResourceIndex',\n        'ResourceIntl',\n        'ResourceIntlValues',\n        'ResourceItem',\n        'ResourcePages',\n        'ResourceType',\n        'RouteDefinition',\n        'Routes',\n        'SelectOption',\n        'StatusCode',\n        'TableColumn',\n        'Toggle',\n        'TrackingVariables',\n        'TriggerUpdate',\n        'Uppy',\n        'User',\n        'VideoMedia',\n    ],\n    '@panneau/data': [\n        'default',\n        'Api',\n        'BaseApi',\n        'DataProvider',\n        'ApiProvider',\n        'useApi',\n        'QueryProvider',\n        'useQueryContext',\n        'useItem',\n        'useItems',\n        'UseItemsResponse',\n        'useResourceDestroy',\n        'useResourceItem',\n        'useResourceItems',\n        'useResourceStore',\n        'useResourceUpdate',\n        'useResourceClone',\n        'useResourceRestore',\n    ],\n    '@panneau/fields': ['default'],\n    '@panneau/forms': ['default'],\n    '@panneau/intl': [\n        'default',\n        'IntlManager',\n        'IntlProvider',\n        'ResourceMessage',\n        'useResourceValues',\n    ],\n    '@panneau/lists': ['default'],\n};\n\n/** Packages that only exist in v4. Their imports are rewritten or reported. */\nexport function isV4Package(name: string): boolean {\n    return (\n        /^@panneau\\/(action|display|element|field|filter|form|list|modal)-/.test(name) ||\n        [\n            '@panneau/ckeditor',\n            '@panneau/displays',\n            '@panneau/filters',\n            '@panneau/form',\n            '@panneau/medias',\n            '@panneau/modals',\n            '@panneau/panneau',\n            '@panneau/themes',\n            '@panneau/uppy',\n        ].includes(name)\n    );\n}\n\n/** What replaces v4 exports, by module and name, for the messages of the report. */\nexport const REPLACEMENTS: Readonly<Record<string, Readonly<Record<string, string>>>> = {\n    '@panneau/core/contexts': {\n        usePanneauResource:\n            '`useResource(id)` of `@panneau/core` gives `{ resource, form, list }`: the fields of the resource are `resource.fields`, fields of the protocol',\n        usePanneauResources:\n            '`useDefinition()` of `@panneau/data/query` gives the definition, with its `resources`',\n        useResource:\n            'a field of Panneau 5 gets its values from its props: `useResource(id)` of `@panneau/core` resolves a resource of the definition',\n        useUrlGenerator:\n            'Panneau 5 has no named routes: link to `{basePath}/resources/{resource}/{id}` (decision 0019), or run a resource action',\n        usePanneau:\n            '`usePanneau()` of `@panneau/core` gives the definition and the plugins: custom keys of the definition move to `settings` of the resources or fields',\n        useFormSetValue:\n            '`useFormContext().setValue(path, value)` of `@panneau/forms` sets the value of another field',\n        useForm:\n            'a field of Panneau 5 reads its form through `useFormContext()` of `@panneau/forms`',\n        useLocales: '`useFieldsContext().locales` of `@panneau/fields`',\n        useListComponent:\n            'list layouts come from plugins (`listLayouts`); `ListView` of `@panneau/lists` renders one',\n        useModalComponent: '`Dialog` of `@panneau/ui`',\n        useDisplayComponent:\n            'displays come from plugins (`displays`); `@panneau/lists` exports the built-in ones',\n        ResourceProvider: 'Panneau 5 has no resource context: pass the resource id as a prop',\n    },\n    '@panneau/data': {\n        useResourceItems:\n            '`useResourceList(resource, query)` of `@panneau/data/query`: its `data.data` are the items, and the query is a list query of the protocol (`page`, `perPage`, `filter`)',\n        useResourceItem:\n            '`useResourceItem(resource, id)` of `@panneau/data/query`: its `data` is the item',\n        useItems: '`useResourceList(resource, query)` of `@panneau/data/query`',\n        useItem: '`useResourceItem(resource, id)` of `@panneau/data/query`',\n    },\n    '@panneau/app': {\n        MainLayout: 'pages of Panneau 5 render inside the shell of the app: drop the layout',\n        PageHeader:\n            'pages of Panneau 5 render inside the shell of the app, which shows their title',\n        ResourceItemsList:\n            '`ListView` of `@panneau/lists`, with `useResourceList()` of `@panneau/data/query`',\n        ResourceForm: '`FormView` of `@panneau/forms`',\n    },\n    '@panneau/medias': {\n        MediasBrowserProvider:\n            'the media field and picker of `@panneau/media` (`mediaPlugin`) browse the media libraries through the adapter',\n    },\n    '@panneau/intl': {\n        default: 'messages come with the packages and with plugins (`locales`)',\n        useResourceValues: 'labels of resources come from the definition, already translated',\n    },\n    '@panneau/element-button': {\n        default:\n            '`Button` of `@panneau/ui` (`variant` and `tone` instead of `theme`, Lucide icons)',\n    },\n    '@panneau/element-buttons': { default: '`Inline` and `Button` of `@panneau/ui`' },\n    '@panneau/element-modal': { default: '`Dialog` of `@panneau/ui`' },\n    '@panneau/modal-dialog': { default: '`Dialog` of `@panneau/ui`' },\n    '@panneau/element-card': { default: '`Card` of `@panneau/ui`' },\n    '@panneau/element-alert': { default: '`Alert` of `@panneau/ui`' },\n    '@panneau/element-loading': {\n        default:\n            '`Skeleton` of `@panneau/ui` while content loads, `Spinner` for an operation in progress',\n    },\n    '@panneau/element-icon': { default: '`Icon` of `@panneau/ui`, with Lucide icons' },\n    '@panneau/element-label': { default: 'labels are given to fields and primitives as `label`' },\n    '@panneau/element-select': {\n        default: '`Select` of `@panneau/ui`, or `SelectField` of `@panneau/fields/select`',\n    },\n    '@panneau/element-radios': { default: '`RadioGroup` of `@panneau/ui`' },\n    '@panneau/element-range': { default: '`Slider` of `@panneau/ui`' },\n    '@panneau/element-table': { default: '`ListView` of `@panneau/lists`' },\n    '@panneau/form': { default: '`Form` of `@panneau/forms`, with fields of the protocol' },\n};\n"],"mappings":";;;AAuBA,IAAa,cAAiC;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;;AAGA,IAAa,gBAAkD,EAAE,UAAU,cAAc;AAEzF,IAAM,aAAa;CACf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;AACA,IAAM,eAAe;CAAE,SAAS;CAAU,QAAQ;AAAS;AAC3D,IAAM,eAAe;CAAC;CAAW;CAAe;CAAY;CAAU;AAAkB;AACxF,IAAM,cAAc;CAChB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ;AACA,IAAM,aAAa;AAEnB,IAAM,OAAoB;CACtB,QAAQ;CACR,MAAM;CACN,OAAO;CACP,SAAS;CACT,WAAW;AACf;AACA,IAAM,SAAsB;CACxB,QAAQ;CACR,MAAM;CACN,OAAO;AACX;AACA,IAAM,WAAwB;CAC1B,QAAQ;CACR,MAAM;CACN,OAAO;EAAC;EAAY;EAAY;EAAY;EAAe;EAAU;CAAkB;CACvF,MAAM;AACV;AACA,IAAM,QAAqB;CACvB,QAAQ;CACR,MAAM;CACN,OAAO;CACP,MAAM;AACV;AACA,IAAM,QAAqB;CACvB,QAAQ;CACR,MAAM;CACN,OAAO;EACH,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;CACJ;CACA,MAAM;AACV;;;;;;AAOA,IAAa,gBAAuD;CAChE;CACA,UAAU;EACN,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO;GAAC;GAAa;GAAe;GAAQ;EAAmB;CACnE;CACA,OAAO;EAAE,GAAG;EAAM,QAAQ;EAAyB,MAAM;CAAa;CACtE,KAAK;EACD,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO,CAAC,GAAG,WAAW,QAAQ,SAAS,SAAS,QAAQ,GAAG,eAAe;EAC1E,SAAS,EAAE,SAAS,SAAS;CACjC;CACA,WAAW;EAAE,GAAG;EAAM,QAAQ;EAAuB,MAAM;CAAW;CACtE,KAAK;EAAE,GAAG;EAAM,QAAQ;EAAuB,MAAM;CAAW;CAChE,QAAQ;EACJ,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO;GACH;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACJ;EACA,SAAS,EAAE,QAAQ,SAAS;CAChC;CACA,OAAO;EACH,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO,WAAW,QAAQ,SAAS,CAAC;GAAC;GAAQ;GAAU;EAAW,CAAC,CAAC,SAAS,IAAI,CAAC;CACtF;CACA,MAAM;EACF,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO;GAAC;GAAoB;GAAO;EAAK;CAC5C;CACA,aAAa;EACT,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO;GAAC;GAAoB;GAAa;GAAY;EAAa;CACtE;CACA,UAAU;EACN,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO;GAAC;GAAoB;GAAa;GAAY;EAAa;CACtE;CACA;CACA,QAAQ;EAAE,GAAG;EAAQ,MAAM,EAAE,QAAQ,SAAS;CAAE;CAChD,YAAY;EAAE,GAAG;EAAQ,MAAM;GAAE,UAAU;GAAM,QAAQ;EAAa;CAAE;CACxE,SAAS;EAAE,GAAG;EAAQ,MAAM;GAAE,UAAU;GAAM,QAAQ;EAAa;CAAE;CACrE,QAAQ;EACJ,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO,CAAC,UAAU,kBAAkB;EACpC,MAAM,EAAE,QAAQ,SAAS;CAC7B;CACA,UAAU;EACN,QAAQ;EACR,MAAM;EACN,WAAW;EACX,OAAO,CAAC,UAAU,kBAAkB;CACxC;CACA,OAAO;EACH,QAAQ;EACR,MAAM;EACN,OAAO,CAAC,eAAe,aAAa;CACxC;CACA,WAAW;EACP,QAAQ;EACR,MAAM;EACN,OAAO;GAAC;GAAY;GAAmB;EAAS;CACpD;CACA,QAAQ;EACJ,QAAQ;EACR,MAAM;EACN,OAAO;GAAC;GAAU;GAAmB;EAAM;EAC3C,MAAM;CACV;CACA,OAAO;EACH,QAAQ;EACR,MAAM;EACN,OAAO;GAAC;GAAU;GAAiB;GAAO;GAAO;GAAQ;EAAO;EAChE,MAAM;CACV;CACA,MAAM;CACN,iBAAiB;CACjB,QAAQ;CACR;CACA,OAAO;EAAE,GAAG;EAAO,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE;CAAE;CACjD,OAAO;EAAE,GAAG;EAAO,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE;CAAE;CACjD,UAAU;CACV;CACA,gBAAgB;CAChB,gBAAgB;EAAE,GAAG;EAAO,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE;CAAE;CAC1D,gBAAgB;EAAE,GAAG;EAAO,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE;CAAE;CAC1D,mBAAmB;AACvB;;AAGA,IAAa,wBAA0D;CACnE,MAAM;CACN,UAAU;CACV,cAAc;CACd,SAAS;CACT,eACI;CACJ,QAAQ;AACZ;;AAGA,SAAgB,eAAe,IAAgC;CAC3D,OAAO,cAAc,UAAU,EAAE,MAAM;AAC3C;;AAGA,IAAa,aAET;CACA,QAAQ;EAAE,MAAM;EAAU,UAAU;CAAmB;CACvD,UAAU;EACN,MAAM;EACN,UAAU;EACV,MAAM;CACV;CACA,SAAS;EACL,MAAM;EACN,UAAU;EACV,MAAM;CACV;CACA,OAAO;EACH,MAAM;EACN,UAAU;EACV,MAAM;CACV;CACA,UAAU;EACN,MAAM;EACN,UAAU;EACV,MAAM;CACV;CACA,OAAO;EACH,MAAM;EACN,UAAU;EACV,MAAM;CACV;CACA,OAAO;EAAE,MAAM;EAAM,UAAU;CAAkB;CACjD,SAAS;EAAE,MAAM;EAAM,UAAU;CAAoB;CACrD,QAAQ;EAAE,MAAM;EAAM,UAAU;CAAmB;CACnD,SAAS;EAAE,MAAM;EAAM,UAAU;CAAoB;CACrD,KAAK;EAAE,MAAM;EAAM,UAAU;CAAgB;AACjD;;AAGA,SAAgB,uBAAuB,UAAiC;CACpE,OACI,OAAO,QAAQ,UAAU,CAAC,CAAC,MAAM,GAAG,eAAe,UAAU,aAAa,QAAQ,CAAC,GAAG,MACtF;AAER;;;;;AAMA,IAAa,kBAA+D;CACxE,oBAAoB,CAAC,SAAS;CAC9B,gBAAgB;EACZ;EACA;EACA;EACA;EACA;EACA;EACA;CACJ;CACA,iBAAiB;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ;CACA,iBAAiB;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ;CACA,iBAAiB;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ;CACA,mBAAmB,CAAC,SAAS;CAC7B,kBAAkB,CAAC,SAAS;CAC5B,iBAAiB;EACb;EACA;EACA;EACA;EACA;CACJ;CACA,kBAAkB,CAAC,SAAS;AAChC;;AAGA,SAAgB,YAAY,MAAuB;CAC/C,OACI,oEAAoE,KAAK,IAAI,KAC7E;EACI;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC,CAAC,SAAS,IAAI;AAEvB;;AAGA,IAAa,eAA2E;CACpF,0BAA0B;EACtB,oBACI;EACJ,qBACI;EACJ,aACI;EACJ,iBACI;EACJ,YACI;EACJ,iBACI;EACJ,SACI;EACJ,YAAY;EACZ,kBACI;EACJ,mBAAmB;EACnB,qBACI;EACJ,kBAAkB;CACtB;CACA,iBAAiB;EACb,kBACI;EACJ,iBACI;EACJ,UAAU;EACV,SAAS;CACb;CACA,gBAAgB;EACZ,YAAY;EACZ,YACI;EACJ,mBACI;EACJ,cAAc;CAClB;CACA,mBAAmB,EACf,uBACI,gHACR;CACA,iBAAiB;EACb,SAAS;EACT,mBAAmB;CACvB;CACA,2BAA2B,EACvB,SACI,oFACR;CACA,4BAA4B,EAAE,SAAS,yCAAyC;CAChF,0BAA0B,EAAE,SAAS,4BAA4B;CACjE,yBAAyB,EAAE,SAAS,4BAA4B;CAChE,yBAAyB,EAAE,SAAS,0BAA0B;CAC9D,0BAA0B,EAAE,SAAS,2BAA2B;CAChE,4BAA4B,EACxB,SACI,0FACR;CACA,yBAAyB,EAAE,SAAS,6CAA6C;CACjF,0BAA0B,EAAE,SAAS,uDAAuD;CAC5F,2BAA2B,EACvB,SAAS,0EACb;CACA,2BAA2B,EAAE,SAAS,gCAAgC;CACtE,0BAA0B,EAAE,SAAS,4BAA4B;CACjE,0BAA0B,EAAE,SAAS,iCAAiC;CACtE,iBAAiB,EAAE,SAAS,0DAA0D;AAC1F"}

package/dist/names.d.ts

@@ -0,0 +1,5 @@
+/** `VideoOrEmbed` for `video_or_embed`, as v4 looked components up by name. */
+export declare function pascalCase(name: string): string;
+/** `video-or-embed` for `VideoOrEmbed` or `video_or_embed`. */
+export declare function kebabCase(name: string): string;
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAUA,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/names.js

@@ -0,0 +1,13 @@
+//#region src/names.ts
+/** The words of a name: `videoOrEmbed`, `video_or_embed`, `VideoOrEmbed` give video, or, embed. */
+function words(name) {
+	return name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").split(/[^a-zA-Z0-9]+/).filter((word) => word !== "").map((word) => word.toLowerCase());
+}
+/** `video-or-embed` for `VideoOrEmbed` or `video_or_embed`. */
+function kebabCase(name) {
+	return words(name).join("-");
+}
+//#endregion
+export { kebabCase };
+
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","names":[],"sources":["../src/names.ts"],"sourcesContent":["/** The words of a name: `videoOrEmbed`, `video_or_embed`, `VideoOrEmbed` give video, or, embed. */\nfunction words(name: string): string[] {\n    return name\n        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n        .replace(/([A-Z])([A-Z][a-z])/g, '$1 $2')\n        .split(/[^a-zA-Z0-9]+/)\n        .filter((word) => word !== '')\n        .map((word) => word.toLowerCase());\n}\n\n/** `VideoOrEmbed` for `video_or_embed`, as v4 looked components up by name. */\nexport function pascalCase(name: string): string {\n    return words(name)\n        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n        .join('');\n}\n\n/** `video-or-embed` for `VideoOrEmbed` or `video_or_embed`. */\nexport function kebabCase(name: string): string {\n    return words(name).join('-');\n}\n"],"mappings":";;AACA,SAAS,MAAM,MAAwB;CACnC,OAAO,KACF,QAAQ,sBAAsB,OAAO,CAAC,CACtC,QAAQ,wBAAwB,OAAO,CAAC,CACxC,MAAM,eAAe,CAAC,CACtB,QAAQ,SAAS,SAAS,EAAE,CAAC,CAC7B,KAAK,SAAS,KAAK,YAAY,CAAC;AACzC;;AAUA,SAAgB,UAAU,MAAsB;CAC5C,OAAO,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;AAC/B"}