rei-kit 0.1.0

package/dist/i18n/runtime.d.ts

@@ -0,0 +1,53 @@
+/** What the user picked. `system` re-reads the browser on every launch. */
+export type LocalePreference<L extends string> = 'system' | L;
+export interface I18nRuntimeOptions<L extends string, Schema> {
+    /** Languages the app ships, in no particular order. */
+    locales: readonly L[];
+    /** The one that is always loaded, and the fallback when a load fails. */
+    fallback: L;
+    /**
+     * BCP 47 tag per locale, for `Intl`.
+     *
+     * Message lookup only needs the base language, but dates and numbers need a
+     * region to be right — `zh` alone would leave the formatter to guess.
+     */
+    intlTags: Record<L, string>;
+    /** The fallback's messages, bundled. */
+    messages: Schema;
+    /** The rest, fetched only when they are the one in use. */
+    loaders?: Partial<Record<L, () => Promise<{
+        default: Schema;
+    }>>>;
+    /** Where the choice is stored. Namespace it per app. */
+    storageKey?: string;
+}
+/**
+ * Builds an i18n runtime around an app's own catalogue.
+ *
+ * A factory rather than a module singleton because the schema is the app's:
+ * typing every locale as `typeof en` is what makes a missing key a build error,
+ * and this package has no `en` of its own to type against.
+ *
+ * @example
+ * ```ts
+ * export const { i18n, t, useLocalePreference, loadActiveLocale } =
+ *   createI18nRuntime({
+ *     locales: ['en', 'tr'] as const,
+ *     fallback: 'en',
+ *     intlTags: { en: 'en-GB', tr: 'tr-TR' },
+ *     messages: en,
+ *     loaders: { tr: () => import('./locales/tr') },
+ *     storageKey: 'myapp-locale',
+ *   })
+ * ```
+ */
+export declare function createI18nRuntime<L extends string, Schema extends Record<string, unknown>>(options: I18nRuntimeOptions<L, Schema>): {
+    i18n: import('vue-i18n').I18n<{}, {}, {}, string, true>;
+    /** `t` for code outside a component. Tracks the locale inside a computed. */
+    t: (key: string, named?: Record<string, unknown>) => string;
+    activeLocale: import('vue').ComputedRef<L>;
+    intlLocale: import('vue').ComputedRef<Record<L, string>[L]>;
+    ensureMessages: (locale: L) => Promise<void>;
+    loadActiveLocale: () => Promise<void>;
+    useLocalePreference: () => import('vue').WritableComputedRef<LocalePreference<L>, LocalePreference<L>>;
+};

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * rei-kit — the layer every app starts from.
+ *
+ * Everything here is free of any backend, router or i18n choice. Components
+ * take strings rather than calling a translator, and utilities take the clock
+ * rather than reading it, so nothing in this package can force a decision on
+ * the app that installs it.
+ *
+ * @see https://github.com/ramazandogna/rei-kit
+ */
+export declare const VERSION = "0.0.0";
+export { addDays, eachDayOfYear, fromDateKey, lastNDays, leadingBlanks, startOfWeek, toDateKey, todayKey, } from './utils/date';
+export type { WeekStart } from './utils/date';
+export { formatDate, setFormatLocale } from './utils/format';
+export { relativeDayLabel } from './utils/day-label';
+export type { DayLabels } from './utils/day-label';
+export { downloadJson } from './utils/download';
+export { safeRedirect } from './utils/redirect';
+export type { QueryValue } from './utils/redirect';
+export { tapFeedback } from './utils/haptics';
+export { isApplePortable, isInstalled, needsIosInstall } from './utils/platform';
+export { AppError, registerErrorMapper, toAppError } from './utils/app-error';
+export type { AppErrorKind, ErrorMapper } from './utils/app-error';
+export { applyTheme, isThemePreference, readStoredTheme, setThemeStorageKey, useTheme, } from './composables/use-theme';
+export type { ThemePreference } from './composables/use-theme';
+export { useToday } from './composables/use-today';
+export { useOnline } from './composables/use-online';
+export { useDebouncedCallback } from './composables/use-debounced-callback';
+export { useDragScroll } from './composables/use-drag-scroll';
+export { useVisualViewport } from './composables/use-visual-viewport';
+export type { VisualViewportRect } from './composables/use-visual-viewport';
+export { default as BaseButton } from './components/BaseButton.vue';
+export { default as BaseInput } from './components/BaseInput.vue';
+export { default as BaseSheet } from './components/BaseSheet.vue';
+export { default as EmptyState } from './components/EmptyState.vue';
+export { default as PageHeader } from './components/PageHeader.vue';
+export { default as SectionHeading } from './components/SectionHeading.vue';
+export { default as SegmentedControl } from './components/SegmentedControl.vue';
+export { default as SettingsGroup } from './components/SettingsGroup.vue';
+export { default as SettingsRow } from './components/SettingsRow.vue';
+export { default as SkeletonList } from './components/SkeletonList.vue';
+export { default as StatCard } from './components/StatCard.vue';
+export { default as ToneDot } from './components/ToneDot.vue';
+export type { Tone } from './components/SectionHeading.vue';
+export { default as LocaleLinks } from './components/LocaleLinks.vue';
+export { createI18nRuntime } from './i18n/runtime';
+export type { I18nRuntimeOptions, LocalePreference } from './i18n/runtime';