@ifto/mantine-kit 0.0.0-stage → 0.1.0

package/dist/i18n/messages/ptBR.js

@@ -0,0 +1,97 @@
+"use client";
+import dayjs from "dayjs";
+// src/i18n/messages/ptBR.ts
+/** Brazilian Portuguese texts. */
+var ptBR = {
+	common: {
+		back: "Voltar",
+		save: "Salvar",
+		cancel: "Cancelar",
+		confirm: "Confirmar",
+		add: "Adicionar",
+		home: "Início",
+		success: "Sucesso",
+		warning: "Atenção",
+		error: "Erro",
+		loadError: "Erro ao carregar dados",
+		dateFormat: "DD/MM/YYYY"
+	},
+	form: {
+		action: {
+			create: "Criar",
+			edit: "Atualizar",
+			view: "Visualizar",
+			custom: "Personalizar"
+		},
+		saveSuccess: (action) => `Sucesso ao ${action.toLowerCase()} cadastro!`,
+		saveError: (action) => `Erro ao ${action.toLowerCase()} cadastro`,
+		createSuccess: "Registro cadastrado com sucesso",
+		createError: "Houve um erro ao realizar o cadastro!",
+		updateSuccess: "Cadastro atualizado com sucesso",
+		updateError: "Houve um erro ao atualizar o cadastro",
+		confirmTitle: "Confirme sua ação"
+	},
+	table: {
+		actions: "Ações",
+		view: "Visualizar",
+		edit: "Editar",
+		delete: "Deletar",
+		deleteConfirm: "Você está prestes a excluir este cadastro. Tem certeza de que deseja continuar?",
+		deleteSuccess: "Cadastro excluído com sucesso!",
+		noRecords: "Não há registros disponíveis para exibição.",
+		recordsPerPage: "Registros por página",
+		pagination: ({ from, to, totalRecords }) => `Exibindo ${from} a ${to} de ${totalRecords} registros`,
+		listTitle: (pluralName) => `Lista de ${pluralName}`
+	},
+	rowEdit: {
+		edit: "Editar valores (Enter)",
+		confirm: "Confirmar edição (Enter)",
+		cancel: "Cancelar edição (Esc)"
+	},
+	select: {
+		placeholder: (label) => `Selecione o(a) ${label}`,
+		nothingFound: (label) => `${label} não encontrado(a)`
+	},
+	layout: {
+		userMenu: "Acessar opções do usuário",
+		userMenuTitle: "Opções do Usuário",
+		enableDarkTheme: "Ativar tema escuro",
+		enableLightTheme: "Ativar tema claro",
+		collapseNavigation: "Recolher menu de navegação",
+		expandNavigation: "Expandir menu de navegação"
+	},
+	print: {
+		pdfTipTitle: "Para salvar em PDF",
+		pdfTip: "Na janela de impressão, escolha \"Salvar como PDF\" como destino e desmarque \"Cabeçalhos e rodapés\", para o PDF ter só os do relatório.",
+		printButton: "Imprimir ou salvar como PDF"
+	},
+	stats: { comparedToLastMonth: "Comparado ao último mês" },
+	export: {
+		button: "Exportar",
+		failed: (formatLabel) => `Não foi possível exportar em ${formatLabel}.`,
+		generatedAt: (date) => `Gerado em ${dayjs(date).format("DD/MM/YYYY [às] HH:mm")}`,
+		footer: (systemName) => `Dados gerados pelo ${systemName}`,
+		excelPageNumber: "Página &P de &N",
+		invalidCell: "Erro",
+		defaultFileName: "dados",
+		defaultSheetName: (position) => `Aba ${position}`
+	},
+	chart: {
+		types: {
+			bar: "Colunas",
+			line: "Linha",
+			"stacked-bar": "Colunas empilhadas",
+			donut: "Rosca (um ano)"
+		},
+		saveAsImage: "Exportar imagem",
+		total: (formattedTotal) => `Total: ${formattedTotal}`
+	},
+	http: {
+		unknownError: "Erro desconhecido",
+		noResponse: "Nenhuma resposta recebida",
+		requestFailed: "Requisição falhou"
+	}
+};
+export { ptBR };
+
+//# sourceMappingURL=ptBR.js.map

package/dist/i18n/messages/ptBR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptBR.js","names":[],"sources":["../../../src/i18n/messages/ptBR.ts"],"sourcesContent":["import dayjs from 'dayjs';\n\nimport { KitMessages } from '../KitMessages';\n\n/** Brazilian Portuguese texts. */\nexport const ptBR: KitMessages = {\n    common: {\n        back: 'Voltar',\n        save: 'Salvar',\n        cancel: 'Cancelar',\n        confirm: 'Confirmar',\n        add: 'Adicionar',\n        home: 'Início',\n        success: 'Sucesso',\n        warning: 'Atenção',\n        error: 'Erro',\n        loadError: 'Erro ao carregar dados',\n        dateFormat: 'DD/MM/YYYY'\n    },\n    form: {\n        action: { create: 'Criar', edit: 'Atualizar', view: 'Visualizar', custom: 'Personalizar' },\n        saveSuccess: action => `Sucesso ao ${action.toLowerCase()} cadastro!`,\n        saveError: action => `Erro ao ${action.toLowerCase()} cadastro`,\n        createSuccess: 'Registro cadastrado com sucesso',\n        createError: 'Houve um erro ao realizar o cadastro!',\n        updateSuccess: 'Cadastro atualizado com sucesso',\n        updateError: 'Houve um erro ao atualizar o cadastro',\n        confirmTitle: 'Confirme sua ação'\n    },\n    table: {\n        actions: 'Ações',\n        view: 'Visualizar',\n        edit: 'Editar',\n        delete: 'Deletar',\n        deleteConfirm: 'Você está prestes a excluir este cadastro. Tem certeza de que deseja continuar?',\n        deleteSuccess: 'Cadastro excluído com sucesso!',\n        noRecords: 'Não há registros disponíveis para exibição.',\n        recordsPerPage: 'Registros por página',\n        pagination: ({ from, to, totalRecords }) => `Exibindo ${from} a ${to} de ${totalRecords} registros`,\n        listTitle: pluralName => `Lista de ${pluralName}`\n    },\n    rowEdit: {\n        edit: 'Editar valores (Enter)',\n        confirm: 'Confirmar edição (Enter)',\n        cancel: 'Cancelar edição (Esc)'\n    },\n    select: {\n        placeholder: label => `Selecione o(a) ${label}`,\n        nothingFound: label => `${label} não encontrado(a)`\n    },\n    layout: {\n        userMenu: 'Acessar opções do usuário',\n        userMenuTitle: 'Opções do Usuário',\n        enableDarkTheme: 'Ativar tema escuro',\n        enableLightTheme: 'Ativar tema claro',\n        collapseNavigation: 'Recolher menu de navegação',\n        expandNavigation: 'Expandir menu de navegação'\n    },\n    print: {\n        pdfTipTitle: 'Para salvar em PDF',\n        pdfTip:\n            'Na janela de impressão, escolha \"Salvar como PDF\" como destino e desmarque \"Cabeçalhos e rodapés\", ' +\n            'para o PDF ter só os do relatório.',\n        printButton: 'Imprimir ou salvar como PDF'\n    },\n    stats: {\n        comparedToLastMonth: 'Comparado ao último mês'\n    },\n    export: {\n        button: 'Exportar',\n        failed: formatLabel => `Não foi possível exportar em ${formatLabel}.`,\n        generatedAt: date => `Gerado em ${dayjs(date).format('DD/MM/YYYY [às] HH:mm')}`,\n        footer: systemName => `Dados gerados pelo ${systemName}`,\n        excelPageNumber: 'Página &P de &N',\n        invalidCell: 'Erro',\n        defaultFileName: 'dados',\n        defaultSheetName: position => `Aba ${position}`\n    },\n    chart: {\n        types: { bar: 'Colunas', line: 'Linha', 'stacked-bar': 'Colunas empilhadas', donut: 'Rosca (um ano)' },\n        saveAsImage: 'Exportar imagem',\n        total: formattedTotal => `Total: ${formattedTotal}`\n    },\n    http: {\n        unknownError: 'Erro desconhecido',\n        noResponse: 'Nenhuma resposta recebida',\n        requestFailed: 'Requisição falhou'\n    }\n};\n"],"mappings":";;;;AAKA,IAAa,OAAoB;CAC7B,QAAQ;EACJ,MAAM;EACN,MAAM;EACN,QAAQ;EACR,SAAS;EACT,KAAK;EACL,MAAM;EACN,SAAS;EACT,SAAS;EACT,OAAO;EACP,WAAW;EACX,YAAY;CAChB;CACA,MAAM;EACF,QAAQ;GAAE,QAAQ;GAAS,MAAM;GAAa,MAAM;GAAc,QAAQ;EAAe;EACzF,cAAa,WAAU,cAAc,OAAO,YAAY,EAAE;EAC1D,YAAW,WAAU,WAAW,OAAO,YAAY,EAAE;EACrD,eAAe;EACf,aAAa;EACb,eAAe;EACf,aAAa;EACb,cAAc;CAClB;CACA,OAAO;EACH,SAAS;EACT,MAAM;EACN,MAAM;EACN,QAAQ;EACR,eAAe;EACf,eAAe;EACf,WAAW;EACX,gBAAgB;EAChB,aAAa,EAAE,MAAM,IAAI,mBAAmB,YAAY,KAAK,KAAK,GAAG,MAAM,aAAa;EACxF,YAAW,eAAc,YAAY;CACzC;CACA,SAAS;EACL,MAAM;EACN,SAAS;EACT,QAAQ;CACZ;CACA,QAAQ;EACJ,cAAa,UAAS,kBAAkB;EACxC,eAAc,UAAS,GAAG,MAAM;CACpC;CACA,QAAQ;EACJ,UAAU;EACV,eAAe;EACf,iBAAiB;EACjB,kBAAkB;EAClB,oBAAoB;EACpB,kBAAkB;CACtB;CACA,OAAO;EACH,aAAa;EACb,QACI;EAEJ,aAAa;CACjB;CACA,OAAO,EACH,qBAAqB,0BACzB;CACA,QAAQ;EACJ,QAAQ;EACR,SAAQ,gBAAe,gCAAgC,YAAY;EACnE,cAAa,SAAQ,aAAa,MAAM,IAAI,CAAC,CAAC,OAAO,uBAAuB;EAC5E,SAAQ,eAAc,sBAAsB;EAC5C,iBAAiB;EACjB,aAAa;EACb,iBAAiB;EACjB,mBAAkB,aAAY,OAAO;CACzC;CACA,OAAO;EACH,OAAO;GAAE,KAAK;GAAW,MAAM;GAAS,eAAe;GAAsB,OAAO;EAAiB;EACrG,aAAa;EACb,QAAO,mBAAkB,UAAU;CACvC;CACA,MAAM;EACF,cAAc;EACd,YAAY;EACZ,eAAe;CACnB;AACJ"}

package/dist/i18n/resolveMessages.d.ts

@@ -0,0 +1,13 @@
+import { KitLocale } from './KitLocale';
+import { KitMessages, KitMessagesOverride } from './KitMessages';
+/** Built-in message catalog of each locale. */
+export declare const KIT_MESSAGES: Readonly<Record<KitLocale, KitMessages>>;
+/** Texts of the {@link DEFAULT_LOCALE}, used as defaults by the code outside React. */
+export declare const DEFAULT_MESSAGES: KitMessages;
+/**
+ * Returns the texts of a locale, with the texts the app overrides.
+ * @param locale locale of the texts; defaults to {@link DEFAULT_LOCALE}
+ * @param override texts that replace the ones of the locale, by section
+ * @return the texts, with every section complete
+ */
+export declare function resolveMessages(locale?: KitLocale, override?: KitMessagesOverride): KitMessages;

package/dist/i18n/resolveMessages.js

@@ -0,0 +1,29 @@
+"use client";
+import { DEFAULT_LOCALE } from "./KitLocale.js";
+import { enUS } from "./messages/enUS.js";
+import { ptBR } from "./messages/ptBR.js";
+// src/i18n/resolveMessages.ts
+/** Built-in message catalog of each locale. */
+var KIT_MESSAGES = {
+	"pt-BR": ptBR,
+	"en-US": enUS
+};
+/** Texts of the {@link DEFAULT_LOCALE}, used as defaults by the code outside React. */
+var DEFAULT_MESSAGES = KIT_MESSAGES[DEFAULT_LOCALE];
+/**
+* Returns the texts of a locale, with the texts the app overrides.
+* @param locale locale of the texts; defaults to {@link DEFAULT_LOCALE}
+* @param override texts that replace the ones of the locale, by section
+* @return the texts, with every section complete
+*/
+function resolveMessages(locale = DEFAULT_LOCALE, override = {}) {
+	const base = KIT_MESSAGES[locale];
+	const sections = Object.keys(base);
+	return Object.fromEntries(sections.map((section) => [section, {
+		...base[section],
+		...override[section]
+	}]));
+}
+export { DEFAULT_MESSAGES, KIT_MESSAGES, resolveMessages };
+
+//# sourceMappingURL=resolveMessages.js.map

package/dist/i18n/resolveMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMessages.js","names":[],"sources":["../../src/i18n/resolveMessages.ts"],"sourcesContent":["import { DEFAULT_LOCALE, KitLocale } from './KitLocale';\nimport { KitMessages, KitMessagesOverride } from './KitMessages';\nimport { enUS } from './messages/enUS';\nimport { ptBR } from './messages/ptBR';\n\n/** Built-in message catalog of each locale. */\nexport const KIT_MESSAGES: Readonly<Record<KitLocale, KitMessages>> = { 'pt-BR': ptBR, 'en-US': enUS };\n\n/** Texts of the {@link DEFAULT_LOCALE}, used as defaults by the code outside React. */\nexport const DEFAULT_MESSAGES: KitMessages = KIT_MESSAGES[DEFAULT_LOCALE];\n\n/**\n * Returns the texts of a locale, with the texts the app overrides.\n * @param locale locale of the texts; defaults to {@link DEFAULT_LOCALE}\n * @param override texts that replace the ones of the locale, by section\n * @return the texts, with every section complete\n */\nexport function resolveMessages(locale: KitLocale = DEFAULT_LOCALE, override: KitMessagesOverride = {}): KitMessages {\n    const base = KIT_MESSAGES[locale];\n    const sections = Object.keys(base) as (keyof KitMessages)[];\n\n    return Object.fromEntries(\n        sections.map(section => [section, { ...base[section], ...override[section] }])\n    ) as KitMessages;\n}\n"],"mappings":";;;;;;AAMA,IAAa,eAAyD;CAAE,SAAS;CAAM,SAAS;AAAK;;AAGrG,IAAa,mBAAgC,aAAa;;;;;;;AAQ1D,SAAgB,gBAAgB,SAAoB,gBAAgB,WAAgC,CAAC,GAAgB;CACjH,MAAM,OAAO,aAAa;CAC1B,MAAM,WAAW,OAAO,KAAK,IAAI;CAEjC,OAAO,OAAO,YACV,SAAS,KAAI,YAAW,CAAC,SAAS;EAAE,GAAG,KAAK;EAAU,GAAG,SAAS;CAAS,CAAC,CAAC,CACjF;AACJ"}

package/dist/model/Identifiable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Record that may have an id, the minimum requirement of the components that show or edit records (tables, tabs and
+ * forms). A record without an id was not saved yet.
+ */
+export interface Identifiable {
+    id?: number | string | null;
+}

package/dist/model/Identifiable.js

@@ -0,0 +1 @@
+"use client";

package/dist/provider/KitConfig.d.ts

@@ -0,0 +1,26 @@
+import { KitLocale } from '../i18n/KitLocale';
+import { KitMessages, KitMessagesOverride } from '../i18n/KitMessages';
+import { FormRouteSegments } from '../router/FormRouteSegments';
+import { RouterAdapter } from '../router/RouterAdapter';
+/** Options an app gives to the `KitProvider`. All of them are optional. */
+export type KitOptions = {
+    /** Router of the app; without it, links reload the page (see `anchorRouter`). */
+    router?: RouterAdapter;
+    /** Name of the app, shown in the browser tab title by the page templates (e.g. "Regions - My System"). */
+    appName?: string;
+    /** Locale of the texts and of the number and date formats. Default: `en-US`. */
+    locale?: KitLocale;
+    /** Texts that replace the ones of the locale (e.g. translations from the i18n library of the app). */
+    messages?: KitMessagesOverride;
+    /** URL segments of the CRUD form pages (create, edit and view). */
+    formRouteSegments?: FormRouteSegments;
+};
+/** Configuration the components read from the `KitProvider`: the {@link KitOptions} with the defaults applied. */
+export type KitConfig = {
+    router: RouterAdapter;
+    appName?: string;
+    locale: KitLocale;
+    /** Texts of the locale, with the ones the app overrides. */
+    messages: KitMessages;
+    formRouteSegments: FormRouteSegments;
+};

package/dist/provider/KitConfig.js

@@ -0,0 +1 @@
+"use client";

package/dist/provider/KitContext.d.ts

@@ -0,0 +1,9 @@
+import { KitConfig, KitOptions } from './KitConfig';
+/**
+ * Applies the defaults to the options of an app.
+ * @param options options given to the `KitProvider`
+ * @return the complete configuration
+ */
+export declare function kitConfig(options?: KitOptions): KitConfig;
+/** Context with the {@link KitConfig} of the app, read by the library components. Outside a provider, the defaults apply. */
+export declare const KitContext: import("react").Context<KitConfig>;

package/dist/provider/KitContext.js

@@ -0,0 +1,27 @@
+"use client";
+import "../i18n/KitLocale.js";
+import { resolveMessages } from "../i18n/resolveMessages.js";
+import { anchorRouter } from "../router/anchorRouter.js";
+import { DEFAULT_FORM_ROUTE_SEGMENTS } from "../router/FormRouteSegments.js";
+import { createContext } from "react";
+// src/provider/KitContext.ts
+/**
+* Applies the defaults to the options of an app.
+* @param options options given to the `KitProvider`
+* @return the complete configuration
+*/
+function kitConfig(options = {}) {
+	const locale = options.locale ?? "en-US";
+	return {
+		router: options.router ?? anchorRouter,
+		appName: options.appName,
+		locale,
+		messages: resolveMessages(locale, options.messages),
+		formRouteSegments: options.formRouteSegments ?? DEFAULT_FORM_ROUTE_SEGMENTS
+	};
+}
+/** Context with the {@link KitConfig} of the app, read by the library components. Outside a provider, the defaults apply. */
+var KitContext = createContext(kitConfig());
+export { KitContext, kitConfig };
+
+//# sourceMappingURL=KitContext.js.map

package/dist/provider/KitContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KitContext.js","names":[],"sources":["../../src/provider/KitContext.ts"],"sourcesContent":["import { createContext } from 'react';\n\nimport { DEFAULT_LOCALE } from '../i18n/KitLocale';\nimport { resolveMessages } from '../i18n/resolveMessages';\nimport { anchorRouter } from '../router/anchorRouter';\nimport { DEFAULT_FORM_ROUTE_SEGMENTS } from '../router/FormRouteSegments';\nimport { KitConfig, KitOptions } from './KitConfig';\n\n/**\n * Applies the defaults to the options of an app.\n * @param options options given to the `KitProvider`\n * @return the complete configuration\n */\nexport function kitConfig(options: KitOptions = {}): KitConfig {\n    const locale = options.locale ?? DEFAULT_LOCALE;\n\n    return {\n        router: options.router ?? anchorRouter,\n        appName: options.appName,\n        locale,\n        messages: resolveMessages(locale, options.messages),\n        formRouteSegments: options.formRouteSegments ?? DEFAULT_FORM_ROUTE_SEGMENTS\n    };\n}\n\n/** Context with the {@link KitConfig} of the app, read by the library components. Outside a provider, the defaults apply. */\nexport const KitContext = createContext<KitConfig>(kitConfig());\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,UAAU,UAAsB,CAAC,GAAc;CAC3D,MAAM,SAAS,QAAQ,UAAA;CAEvB,OAAO;EACH,QAAQ,QAAQ,UAAU;EAC1B,SAAS,QAAQ;EACjB;EACA,UAAU,gBAAgB,QAAQ,QAAQ,QAAQ;EAClD,mBAAmB,QAAQ,qBAAqB;CACpD;AACJ;;AAGA,IAAa,aAAa,cAAyB,UAAU,CAAC"}

package/dist/provider/KitProvider.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren, ReactElement } from 'react';
+import { KitOptions } from './KitConfig';
+/**
+ * Gives the library components the configuration of the app: router, name, locale and texts. It must wrap the app,
+ * inside the `MantineProvider`. Options not given use the defaults (see {@link kitConfig}).
+ */
+export declare function KitProvider({ children, router, appName, locale, messages, formRouteSegments }: PropsWithChildren<KitOptions>): ReactElement;

package/dist/provider/KitProvider.js

@@ -0,0 +1,31 @@
+"use client";
+import { KitContext, kitConfig } from "./KitContext.js";
+import { useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+// src/provider/KitProvider.tsx
+/**
+* Gives the library components the configuration of the app: router, name, locale and texts. It must wrap the app,
+* inside the `MantineProvider`. Options not given use the defaults (see {@link kitConfig}).
+*/
+function KitProvider({ children, router, appName, locale, messages, formRouteSegments }) {
+	const config = useMemo(() => kitConfig({
+		router,
+		appName,
+		locale,
+		messages,
+		formRouteSegments
+	}), [
+		router,
+		appName,
+		locale,
+		messages,
+		formRouteSegments
+	]);
+	return /* @__PURE__ */ jsx(KitContext.Provider, {
+		value: config,
+		children
+	});
+}
+export { KitProvider };
+
+//# sourceMappingURL=KitProvider.js.map

package/dist/provider/KitProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KitProvider.js","names":[],"sources":["../../src/provider/KitProvider.tsx"],"sourcesContent":["import { PropsWithChildren, ReactElement, useMemo } from 'react';\n\nimport { KitOptions } from './KitConfig';\nimport { kitConfig, KitContext } from './KitContext';\n\n/**\n * Gives the library components the configuration of the app: router, name, locale and texts. It must wrap the app,\n * inside the `MantineProvider`. Options not given use the defaults (see {@link kitConfig}).\n */\nexport function KitProvider({\n    children,\n    router,\n    appName,\n    locale,\n    messages,\n    formRouteSegments\n}: PropsWithChildren<KitOptions>): ReactElement {\n    const config = useMemo(\n        () => kitConfig({ router, appName, locale, messages, formRouteSegments }),\n        [router, appName, locale, messages, formRouteSegments]\n    );\n\n    return <KitContext.Provider value={config}>{children}</KitContext.Provider>;\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,YAAY,EACxB,UACA,QACA,SACA,QACA,UACA,qBAC4C;CAC5C,MAAM,SAAS,cACL,UAAU;EAAE;EAAQ;EAAS;EAAQ;EAAU;CAAkB,CAAC,GACxE;EAAC;EAAQ;EAAS;EAAQ;EAAU;CAAiB,CACzD;CAEA,OAAO,oBAAC,WAAW,UAAZ;EAAqB,OAAO;EAAS;CAA8B,CAAA;AAC9E"}

package/dist/provider/useKit.d.ts

@@ -0,0 +1,15 @@
+import { KitMessages } from '../i18n/KitMessages';
+import { RouterAdapter } from '../router/RouterAdapter';
+import { KitConfig } from './KitConfig';
+/** @return the configuration of the app, given to the `KitProvider` */
+export declare function useKitConfig(): KitConfig;
+/** @return the router of the app, given to the `KitProvider` */
+export declare function useKitRouter(): RouterAdapter;
+/** @return the texts of the locale chosen in the `KitProvider` */
+export declare function useKitMessages(): KitMessages;
+/**
+ * Builds the browser tab title of a page: the page title followed by the app name, if any.
+ * @param pageTitle title of the page
+ * @return the title, such as "Regions - My System"
+ */
+export declare function useDocumentTitle(pageTitle: string): string;

package/dist/provider/useKit.js

@@ -0,0 +1,28 @@
+"use client";
+import { KitContext } from "./KitContext.js";
+import { useContext } from "react";
+// src/provider/useKit.ts
+/** @return the configuration of the app, given to the `KitProvider` */
+function useKitConfig() {
+	return useContext(KitContext);
+}
+/** @return the router of the app, given to the `KitProvider` */
+function useKitRouter() {
+	return useContext(KitContext).router;
+}
+/** @return the texts of the locale chosen in the `KitProvider` */
+function useKitMessages() {
+	return useContext(KitContext).messages;
+}
+/**
+* Builds the browser tab title of a page: the page title followed by the app name, if any.
+* @param pageTitle title of the page
+* @return the title, such as "Regions - My System"
+*/
+function useDocumentTitle(pageTitle) {
+	const { appName } = useKitConfig();
+	return appName ? `${pageTitle} - ${appName}` : pageTitle;
+}
+export { useDocumentTitle, useKitConfig, useKitMessages, useKitRouter };
+
+//# sourceMappingURL=useKit.js.map

package/dist/provider/useKit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKit.js","names":[],"sources":["../../src/provider/useKit.ts"],"sourcesContent":["import { useContext } from 'react';\n\nimport { KitMessages } from '../i18n/KitMessages';\nimport { RouterAdapter } from '../router/RouterAdapter';\nimport { KitConfig } from './KitConfig';\nimport { KitContext } from './KitContext';\n\n/** @return the configuration of the app, given to the `KitProvider` */\nexport function useKitConfig(): KitConfig {\n    return useContext(KitContext);\n}\n\n/** @return the router of the app, given to the `KitProvider` */\nexport function useKitRouter(): RouterAdapter {\n    return useContext(KitContext).router;\n}\n\n/** @return the texts of the locale chosen in the `KitProvider` */\nexport function useKitMessages(): KitMessages {\n    return useContext(KitContext).messages;\n}\n\n/**\n * Builds the browser tab title of a page: the page title followed by the app name, if any.\n * @param pageTitle title of the page\n * @return the title, such as \"Regions - My System\"\n */\nexport function useDocumentTitle(pageTitle: string): string {\n    const { appName } = useKitConfig();\n\n    return appName ? `${pageTitle} - ${appName}` : pageTitle;\n}\n"],"mappings":";;;;;AAQA,SAAgB,eAA0B;CACtC,OAAO,WAAW,UAAU;AAChC;;AAGA,SAAgB,eAA8B;CAC1C,OAAO,WAAW,UAAU,CAAC,CAAC;AAClC;;AAGA,SAAgB,iBAA8B;CAC1C,OAAO,WAAW,UAAU,CAAC,CAAC;AAClC;;;;;;AAOA,SAAgB,iBAAiB,WAA2B;CACxD,MAAM,EAAE,YAAY,aAAa;CAEjC,OAAO,UAAU,GAAG,UAAU,KAAK,YAAY;AACnD"}

package/dist/router/FormRouteSegments.d.ts

@@ -0,0 +1,16 @@
+/**
+ * URL segments of the CRUD form pages, after the base path of a feature (e.g. `/region/edit/5`). They are not
+ * translated with the locale, since a URL should not change with the user's language: the app chooses them once, in
+ * the `formRouteSegments` option of the `KitProvider`, from the presets below or with its own words.
+ */
+export type FormRouteSegments = {
+    create: string;
+    edit: string;
+    view: string;
+};
+/** English segments: `create`, `edit/:id` and `view/:id`. */
+export declare const ENGLISH_FORM_ROUTE_SEGMENTS: FormRouteSegments;
+/** Portuguese segments: `criar`, `editar/:id` and `visualizar/:id`. */
+export declare const PORTUGUESE_FORM_ROUTE_SEGMENTS: FormRouteSegments;
+/** Segments used when the app chooses none: {@link ENGLISH_FORM_ROUTE_SEGMENTS}. */
+export declare const DEFAULT_FORM_ROUTE_SEGMENTS: FormRouteSegments;

package/dist/router/FormRouteSegments.js

@@ -0,0 +1,19 @@
+"use client";
+// src/router/FormRouteSegments.ts
+/** English segments: `create`, `edit/:id` and `view/:id`. */
+var ENGLISH_FORM_ROUTE_SEGMENTS = {
+	create: "create",
+	edit: "edit",
+	view: "view"
+};
+/** Portuguese segments: `criar`, `editar/:id` and `visualizar/:id`. */
+var PORTUGUESE_FORM_ROUTE_SEGMENTS = {
+	create: "criar",
+	edit: "editar",
+	view: "visualizar"
+};
+/** Segments used when the app chooses none: {@link ENGLISH_FORM_ROUTE_SEGMENTS}. */
+var DEFAULT_FORM_ROUTE_SEGMENTS = ENGLISH_FORM_ROUTE_SEGMENTS;
+export { DEFAULT_FORM_ROUTE_SEGMENTS, ENGLISH_FORM_ROUTE_SEGMENTS, PORTUGUESE_FORM_ROUTE_SEGMENTS };
+
+//# sourceMappingURL=FormRouteSegments.js.map

package/dist/router/FormRouteSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormRouteSegments.js","names":[],"sources":["../../src/router/FormRouteSegments.ts"],"sourcesContent":["/**\n * URL segments of the CRUD form pages, after the base path of a feature (e.g. `/region/edit/5`). They are not\n * translated with the locale, since a URL should not change with the user's language: the app chooses them once, in\n * the `formRouteSegments` option of the `KitProvider`, from the presets below or with its own words.\n */\nexport type FormRouteSegments = {\n    create: string;\n    edit: string;\n    view: string;\n};\n\n/** English segments: `create`, `edit/:id` and `view/:id`. */\nexport const ENGLISH_FORM_ROUTE_SEGMENTS: FormRouteSegments = { create: 'create', edit: 'edit', view: 'view' };\n\n/** Portuguese segments: `criar`, `editar/:id` and `visualizar/:id`. */\nexport const PORTUGUESE_FORM_ROUTE_SEGMENTS: FormRouteSegments = {\n    create: 'criar',\n    edit: 'editar',\n    view: 'visualizar'\n};\n\n/** Segments used when the app chooses none: {@link ENGLISH_FORM_ROUTE_SEGMENTS}. */\nexport const DEFAULT_FORM_ROUTE_SEGMENTS: FormRouteSegments = ENGLISH_FORM_ROUTE_SEGMENTS;\n"],"mappings":";;;AAYA,IAAa,8BAAiD;CAAE,QAAQ;CAAU,MAAM;CAAQ,MAAM;AAAO;;AAG7G,IAAa,iCAAoD;CAC7D,QAAQ;CACR,MAAM;CACN,MAAM;AACV;;AAGA,IAAa,8BAAiD"}

package/dist/router/RouterAdapter.d.ts

@@ -0,0 +1,24 @@
+import { CSSProperties, ForwardRefExoticComponent, MouseEventHandler, ReactNode, RefAttributes } from 'react';
+/** Props the library components pass to the link component of the router. */
+export interface RouterLinkProps {
+    href: string;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    onClick?: MouseEventHandler<HTMLAnchorElement>;
+}
+/**
+ * Bridge between the library and the router of the app (Next.js, React Router or another one). The components import
+ * no router: they navigate and build links only through this contract, given to the `KitProvider`.
+ */
+export interface RouterAdapter {
+    /**
+     * Link component of the router. It receives the destination in `href` (the adapter converts it, e.g. to the `to`
+     * of React Router) and forwards the `ref` to the `<a>`, which Mantine uses to place tooltips.
+     */
+    Link: ForwardRefExoticComponent<RouterLinkProps & RefAttributes<HTMLAnchorElement>>;
+    /** Hook that returns the path of the current page (e.g. `/region`), without the query string. */
+    usePathname: () => string;
+    /** Hook that returns the function that navigates to a URL. */
+    useNavigate: () => (url: string) => void;
+}

package/dist/router/RouterAdapter.js

@@ -0,0 +1 @@
+"use client";

package/dist/router/anchorRouter.d.ts

@@ -0,0 +1,7 @@
+import { RouterAdapter } from './RouterAdapter';
+/**
+ * Default router, used when the app gives none to the `KitProvider`: plain links (`<a>`) and navigation through
+ * `window.location`. It works in any app, but reloads the page on every navigation; apps with a router (Next.js,
+ * React Router) should give their own adapter.
+ */
+export declare const anchorRouter: RouterAdapter;

package/dist/router/anchorRouter.js

@@ -0,0 +1,23 @@
+"use client";
+import { forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+// src/router/anchorRouter.tsx
+/** Plain HTML link: reloads the page when navigating. */
+var AnchorLink = forwardRef((props, ref) => /* @__PURE__ */ jsx("a", {
+	ref,
+	...props
+}));
+AnchorLink.displayName = "AnchorLink";
+/**
+* Default router, used when the app gives none to the `KitProvider`: plain links (`<a>`) and navigation through
+* `window.location`. It works in any app, but reloads the page on every navigation; apps with a router (Next.js,
+* React Router) should give their own adapter.
+*/
+var anchorRouter = {
+	Link: AnchorLink,
+	usePathname: () => typeof window === "undefined" ? "/" : window.location.pathname,
+	useNavigate: () => (url) => window.location.assign(url)
+};
+export { anchorRouter };
+
+//# sourceMappingURL=anchorRouter.js.map

package/dist/router/anchorRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorRouter.js","names":[],"sources":["../../src/router/anchorRouter.tsx"],"sourcesContent":["import { forwardRef } from 'react';\n\nimport { RouterAdapter, RouterLinkProps } from './RouterAdapter';\n\n/** Plain HTML link: reloads the page when navigating. */\nconst AnchorLink = forwardRef<HTMLAnchorElement, RouterLinkProps>((props, ref) => <a ref={ref} {...props} />);\nAnchorLink.displayName = 'AnchorLink';\n\n/**\n * Default router, used when the app gives none to the `KitProvider`: plain links (`<a>`) and navigation through\n * `window.location`. It works in any app, but reloads the page on every navigation; apps with a router (Next.js,\n * React Router) should give their own adapter.\n */\nexport const anchorRouter: RouterAdapter = {\n    Link: AnchorLink,\n    usePathname: () => (typeof window === 'undefined' ? '/' : window.location.pathname),\n    useNavigate: () => (url: string) => window.location.assign(url)\n};\n"],"mappings":";;;;;AAKA,IAAM,aAAa,YAAgD,OAAO,QAAQ,oBAAC,KAAD;CAAQ;CAAK,GAAI;AAAQ,CAAA,CAAC;AAC5G,WAAW,cAAc;;;;;;AAOzB,IAAa,eAA8B;CACvC,MAAM;CACN,mBAAoB,OAAO,WAAW,cAAc,MAAM,OAAO,SAAS;CAC1E,oBAAoB,QAAgB,OAAO,SAAS,OAAO,GAAG;AAClE"}

package/dist/styles/print.css

@@ -0,0 +1,93 @@
+/*
+Print rules of the whole app, mainly used by the reports (PrintPage): the user prints the page or saves it as PDF with
+the browser itself.
+*/
+
+/*
+Named pages of the reports: the paper size, the margins and the page number in the margin (only Chrome/Edge 131+ show
+the page margins) apply only to the PrintPage, which uses one of them according to the orientation. Outside the
+reports, the user chooses the paper and the orientation in the print dialog. Both pages repeat the margins, since a
+named page does not inherit from another one. The page number is language neutral ("3 / 10"), since CSS cannot read
+the locale of the app. CSS cannot read the name of the system either: an app that wants the footer text (`footer` of
+the export texts) in the margin adds a `@bottom-left` to the `report` and `report-landscape` pages in its own CSS.
+*/
+@page report {
+    size: A4;
+    margin: 15mm 12mm 18mm;
+
+    @bottom-right {
+        content: counter(page) ' / ' counter(pages);
+        font-size: 8pt;
+        color: #5f6b7a;
+    }
+}
+
+/* Wide tables (e.g. a year per column). */
+@page report-landscape {
+    size: A4 landscape;
+    margin: 15mm 12mm 18mm;
+
+    @bottom-right {
+        content: counter(page) ' / ' counter(pages);
+        font-size: 8pt;
+        color: #5f6b7a;
+    }
+}
+
+[data-print-orientation='portrait'] {
+    page: report;
+}
+
+[data-print-orientation='landscape'] {
+    page: report-landscape;
+}
+
+@media print {
+    /* The header and the menu of the app are not part of the printed document. */
+    .mantine-AppShell-header,
+    .mantine-AppShell-navbar,
+    [data-print-hidden] {
+        display: none !important;
+    }
+
+    .mantine-AppShell-main {
+        padding: 0 !important;
+        min-height: 0 !important;
+    }
+
+    /* Only in the reports, colors and backgrounds are printed as on screen (e.g. the table header), without the user
+       having to check "Background graphics". In the other pages, the choice of the user in the print dialog applies. */
+    [data-print-orientation] {
+        print-color-adjust: exact;
+        -webkit-print-color-adjust: exact;
+    }
+
+    /* Repeats the table header on every page and does not cut a row in half. */
+    thead {
+        display: table-header-group;
+    }
+
+    tfoot {
+        display: table-footer-group;
+    }
+
+    tr,
+    [data-print-block] {
+        break-inside: avoid;
+    }
+
+    [data-print-new-page] {
+        break-before: page;
+    }
+
+    [data-print-keep-with-next] {
+        break-after: avoid;
+    }
+
+    /* A scroll container would make the browser cut the table, instead of splitting it across pages. */
+    .mantine-Table-scrollContainer,
+    .mantine-ScrollArea-root,
+    .mantine-ScrollArea-viewport {
+        overflow: visible !important;
+    }
+}