@damian-buho/support-ukraine 1.0.0 → 1.0.2

package/README.md

@@ -35,7 +35,7 @@ npm install @damian-buho/support-ukraine
 ```html
 
 <script type="module">
-  import {supportUkraineBlock} from 'https://cdn.jsdelivr.net/npm/@damian-buho/support-ukraine'
+  import {supportUkraineBlock} from 'https://cdn.jsdelivr.net/npm/@damian-buho/support-ukraine@1/+esm'
 
   await supportUkraineBlock()
 </script>

package/dist/en-GV4YJRAZ.js

@@ -0,0 +1,5 @@
+// src/locales/en.yaml
+var en_default = { "supportUkraine": "Support Ukraine", "allCharities": "All charities", "donate": "Donate", "charities": { "united24": { "tagline": "Official fundraising platform of Ukraine" }, "come-back-alive": { "tagline": "Supporting the Ukrainian Armed Forces since 2014" }, "razom-for-ukraine": { "tagline": "Emergency response and humanitarian aid" }, "ukrainian-red-cross": { "tagline": "Humanitarian assistance in conflict zones" }, "nova-ukraine": { "tagline": "Humanitarian aid and advocacy" }, "voices-of-children": { "tagline": "Psychological support for children affected by war" }, "prytula-foundation": { "tagline": "Defence technology and equipment for Ukraine" }, "army-of-drones": { "tagline": "Reconnaissance drones for the frontline" }, "world-central-kitchen": { "tagline": "Fresh meals for people in conflict zones" }, "cats-of-kyiv": { "tagline": "Cat shelter rescuing and rehoming cats in Kyiv" }, "uanimals": { "tagline": "Animal rescue and advocacy organization in Ukraine" }, "hospitallers": { "tagline": "Ukrainian voluntary paramedics providing first aid and evacuation" }, "sternenko-fund": { "tagline": "FPV drone supply for Ukrainian defence forces" }, "life-robots-ukraine": { "tagline": "Robots for demining Ukraine" }, "sirius-shelter": { "tagline": "Ukraine's largest animal shelter for dogs and cats" } } };
+export {
+  en_default as default
+};

package/dist/i18n.d.ts

@@ -0,0 +1,38 @@
+import type { Charity, LocaleMessages } from './types.js';
+import { type SupportedLocale } from './locales/index.js';
+export type { SupportedLocale } from './locales/index.js';
+/**
+ * Detect the user's preferred locale from browser APIs.
+ *
+ * Resolution order:
+ * 1. Explicit `locale` option
+ * 2. First match from `navigator.languages[]` (user-ordered preference list)
+ * 3. `navigator.language` base tag (e.g. "es" from "es-MX")
+ * 4. Fallback: "en"
+ */
+export declare function detectLocale(preferred?: string): SupportedLocale;
+/**
+ * Load locale messages for the given language code.
+ * Returns cached result on repeat calls. Falls back to 'en' on error.
+ */
+export declare function loadLocale(lang: string): Promise<LocaleMessages>;
+/**
+ * Merge base charities with locale-specific translations.
+ *
+ * For each charity: use the locale tagline if available, otherwise keep
+ * the English default from the base data.
+ */
+export declare function mergeCharities(base: readonly Charity[], locale: LocaleMessages): Charity[];
+/** Returns true if the locale uses right-to-left script. */
+export declare function isRTL(lang: string): boolean;
+/**
+ * Build a translated banner text line for a charity.
+ *
+ * @returns The formatted string "UA_FLAG supportUkraine: name: tagline"
+ */
+export declare function formatBannerText(charity: Charity, messages: LocaleMessages): string;
+/**
+ * Eagerly pre-load the English locale so it is always available synchronously.
+ * Other locales are loaded on demand via `loadLocale()`.
+ */
+export declare function preloadDefault(): Promise<LocaleMessages>;

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { type Charity, type SupportUkraineBlockOptions } from './types.js';
+export type { Charity, CharityTag, SupportUkraineBlockOptions } from './types.js';
+export { charitySchema, charitiesSchema } from './types.js';
+export { detectLocale, loadLocale, mergeCharities, isRTL, formatBannerText } from './i18n.js';
+export { resolveLocale, RTL_LOCALES } from './locales/index.js';
+export type { SupportedLocale } from './locales/index.js';
+export declare const DEFAULT_CHARITIES: Charity[];
+/**
+ * Pick a random item from an array.
+ *
+ * @internal
+ */
+export declare function randomItem<T>(items: T[]): T;
+/**
+ * Create and mount the Ukraine-support charity banner.
+ *
+ * The banner is placed at the top of the page. It displays a randomly
+ * selected charity with the format "🇺🇦 Support Ukraine: Name: tagline" —
+ * the entire block is a clickable link. Text is translated to the user's
+ * detected locale (or the explicit `locale` option).
+ *
+ * @example
+ * ```ts
+ * import { supportUkraineBlock } from '@damian-buho/support-ukraine'
+ *
+ * // Auto-detect locale from navigator.language
+ * await supportUkraineBlock()
+ *
+ * // Force a specific locale
+ * await supportUkraineBlock({ locale: 'es' })
+ * ```
+ */
+export declare function supportUkraineBlock(options?: SupportUkraineBlockOptions): Promise<HTMLElement>;