@sharadox/web-library 0.0.0-stage → 0.1.0

package/distribution/form/rate-limit/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/form/rate-limit/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/form/rate-limit/type.ts"],"names":[],"mappings":""}

package/distribution/html/escape/index.d.ts

@@ -0,0 +1,3 @@
+/** Escapes text for safe use inside html (for example in email bodies). */
+export declare function escapeHtml(text: string): string;
+//# sourceMappingURL=index.d.ts.map

package/distribution/html/escape/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/html/escape/index.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/distribution/html/escape/index.js

@@ -0,0 +1,6 @@
+const ENTITIES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" };
+/** Escapes text for safe use inside html (for example in email bodies). */
+export function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, (character) => ENTITIES[character] ?? character);
+}
+//# sourceMappingURL=index.js.map

package/distribution/html/escape/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/html/escape/index.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAA2B,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAEjH,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,CAAC;AACnF,CAAC"}

package/distribution/internationalization/locale/index.d.ts

@@ -0,0 +1,7 @@
+/** Narrows an untrusted value (a route segment, a form field) to one of the published locales. */
+export declare function isLocale<Locale extends string>(value: string, locales: readonly Locale[]): value is Locale;
+/** The BCP 47 tag for `<html lang>`: European Portuguese is `pt-PT`; other languages keep their code. */
+export declare function languageTag(locale: string): string;
+/** The Open Graph locale (`og:locale`), for example `pt_PT` or `en_GB`. */
+export declare function openGraphLocale(locale: string): string;
+//# sourceMappingURL=index.d.ts.map

package/distribution/internationalization/locale/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/internationalization/locale/index.ts"],"names":[],"mappings":"AAKA,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,IAAI,MAAM,CAE1G;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/distribution/internationalization/locale/index.js

@@ -0,0 +1,17 @@
+/** Language tags for `<html lang>` and structured data's `inLanguage`, where the region matters. */
+const LANGUAGE_TAG = { pt: "pt-PT", en: "en" };
+/** Open Graph locales (`og:locale`). */
+const OPEN_GRAPH_LOCALE = { pt: "pt_PT", en: "en_GB", es: "es_ES", fr: "fr_FR", de: "de_DE" };
+/** Narrows an untrusted value (a route segment, a form field) to one of the published locales. */
+export function isLocale(value, locales) {
+    return locales.includes(value);
+}
+/** The BCP 47 tag for `<html lang>`: European Portuguese is `pt-PT`; other languages keep their code. */
+export function languageTag(locale) {
+    return LANGUAGE_TAG[locale] ?? locale;
+}
+/** The Open Graph locale (`og:locale`), for example `pt_PT` or `en_GB`. */
+export function openGraphLocale(locale) {
+    return OPEN_GRAPH_LOCALE[locale] ?? locale;
+}
+//# sourceMappingURL=index.js.map

package/distribution/internationalization/locale/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/internationalization/locale/index.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,YAAY,GAA2B,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACvE,wCAAwC;AACxC,MAAM,iBAAiB,GAA2B,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAEtH,kGAAkG;AAClG,MAAM,UAAU,QAAQ,CAAwB,KAAa,EAAE,OAA0B;IACvF,OAAQ,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AACxC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AAC7C,CAAC"}

package/distribution/internationalization/locale/type.d.ts

@@ -0,0 +1,3 @@
+/** A piece of copy written in every published language, for example `{ en: "Hello", pt: "Olá" }`. */
+export type Translated<Locale extends string = string> = Record<Locale, string>;
+//# sourceMappingURL=type.d.ts.map

package/distribution/internationalization/locale/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/internationalization/locale/type.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,MAAM,UAAU,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/distribution/internationalization/locale/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/internationalization/locale/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/internationalization/locale/type.ts"],"names":[],"mappings":""}

package/distribution/internationalization/locale-redirect/index.d.ts

@@ -0,0 +1,7 @@
+import type { LocaleRedirect } from "@sharadox/web-library/internationalization/locale-redirect/type";
+/**
+ * Redirects for next.config `redirects()`: `/` goes to the visitor's language when their browser asks for one of
+ * the published locales first (Accept-Language), otherwise to `/<defaultLocale>`.
+ */
+export declare function localeRedirects(locales: readonly string[], defaultLocale: string): LocaleRedirect[];
+//# sourceMappingURL=index.d.ts.map

package/distribution/internationalization/locale-redirect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/internationalization/locale-redirect/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AAEtG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc,EAAE,CAUnG"}

package/distribution/internationalization/locale-redirect/index.js

@@ -0,0 +1,16 @@
+/**
+ * Redirects for next.config `redirects()`: `/` goes to the visitor's language when their browser asks for one of
+ * the published locales first (Accept-Language), otherwise to `/<defaultLocale>`.
+ */
+export function localeRedirects(locales, defaultLocale) {
+    const preferred = locales
+        .filter((locale) => locale !== defaultLocale)
+        .map((locale) => ({
+        source: "/",
+        has: [{ type: "header", key: "accept-language", value: `${locale}.*` }],
+        destination: `/${locale}`,
+        permanent: false,
+    }));
+    return [...preferred, { source: "/", destination: `/${defaultLocale}`, permanent: false }];
+}
+//# sourceMappingURL=index.js.map

package/distribution/internationalization/locale-redirect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/internationalization/locale-redirect/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA0B,EAAE,aAAqB;IAC/E,MAAM,SAAS,GAAqB,OAAO;SACxC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,aAAa,CAAC;SAC5C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,MAAM,EAAE,GAAG;QACX,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACvE,WAAW,EAAE,IAAI,MAAM,EAAE;QACzB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC,CAAC;IACN,OAAO,CAAC,GAAG,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7F,CAAC"}

package/distribution/internationalization/locale-redirect/type.d.ts

@@ -0,0 +1,12 @@
+/** One Next.js redirect, as returned from `redirects()` in next.config. */
+export interface LocaleRedirect {
+    source: string;
+    destination: string;
+    permanent: false;
+    has?: {
+        type: "header";
+        key: string;
+        value: string;
+    }[];
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/internationalization/locale-redirect/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/internationalization/locale-redirect/type.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxD"}

package/distribution/internationalization/locale-redirect/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/internationalization/locale-redirect/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/internationalization/locale-redirect/type.ts"],"names":[],"mappings":""}

package/distribution/internationalization/translate/index.d.ts

@@ -0,0 +1,4 @@
+import type { Translated } from "@sharadox/web-library/internationalization/locale/type";
+/** Picks the copy for a locale. */
+export declare function translate<Locale extends string>(value: Translated<Locale>, locale: NoInfer<Locale>): string;
+//# sourceMappingURL=index.d.ts.map

package/distribution/internationalization/translate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/internationalization/translate/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;AAEzF,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAE3G"}

package/distribution/internationalization/translate/index.js

@@ -0,0 +1,5 @@
+/** Picks the copy for a locale. */
+export function translate(value, locale) {
+    return value[locale];
+}
+//# sourceMappingURL=index.js.map

package/distribution/internationalization/translate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/internationalization/translate/index.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAwB,KAAyB,EAAE,MAAuB;IACjG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC"}

package/distribution/math/clamp/index.d.ts

@@ -0,0 +1,3 @@
+/** Keeps a value between a minimum and a maximum. */
+export declare function clamp(value: number, minimum: number, maximum: number): number;
+//# sourceMappingURL=index.d.ts.map

package/distribution/math/clamp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/math/clamp/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/distribution/math/clamp/index.js

@@ -0,0 +1,5 @@
+/** Keeps a value between a minimum and a maximum. */
+export function clamp(value, minimum, maximum) {
+    return Math.min(maximum, Math.max(minimum, value));
+}
+//# sourceMappingURL=index.js.map

package/distribution/math/clamp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/math/clamp/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,OAAe,EAAE,OAAe;IACnE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/distribution/math/pseudo-random/index.d.ts

@@ -0,0 +1,3 @@
+/** A deterministic number in [0, 1) for a seed: the same seed always gives the same value (stable renders). */
+export declare function pseudoRandom(seed: number): number;
+//# sourceMappingURL=index.d.ts.map

package/distribution/math/pseudo-random/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/math/pseudo-random/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/distribution/math/pseudo-random/index.js

@@ -0,0 +1,6 @@
+/** A deterministic number in [0, 1) for a seed: the same seed always gives the same value (stable renders). */
+export function pseudoRandom(seed) {
+    const value = Math.sin(seed * 12.9898) * 43758.5453;
+    return value - Math.floor(value);
+}
+//# sourceMappingURL=index.js.map

package/distribution/math/pseudo-random/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/math/pseudo-random/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC;IACpD,OAAO,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/distribution/math/radians/index.d.ts

@@ -0,0 +1,3 @@
+/** Degrees to radians. */
+export declare function radians(degrees: number): number;
+//# sourceMappingURL=index.d.ts.map

package/distribution/math/radians/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/math/radians/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/distribution/math/radians/index.js

@@ -0,0 +1,5 @@
+/** Degrees to radians. */
+export function radians(degrees) {
+    return (degrees * Math.PI) / 180;
+}
+//# sourceMappingURL=index.js.map

package/distribution/math/radians/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/math/radians/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC"}

package/distribution/pointer/spotlight/index.d.ts

@@ -0,0 +1,3 @@
+/** Tracks the pointer inside an element as `--pointer-x`/`--pointer-y`, for lights that follow the cursor. */
+export declare function useSpotlight<Target extends HTMLElement>(): import("react").RefObject<Target | null>;
+//# sourceMappingURL=index.d.ts.map

package/distribution/pointer/spotlight/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/pointer/spotlight/index.ts"],"names":[],"mappings":"AAGA,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,MAAM,SAAS,WAAW,8CActD"}

package/distribution/pointer/spotlight/index.js

@@ -0,0 +1,20 @@
+"use client";
+import { useEffect, useRef } from "react";
+/** Tracks the pointer inside an element as `--pointer-x`/`--pointer-y`, for lights that follow the cursor. */
+export function useSpotlight() {
+    const reference = useRef(null);
+    useEffect(() => {
+        const element = reference.current;
+        if (!element)
+            return;
+        const move = (event) => {
+            const bounds = element.getBoundingClientRect();
+            element.style.setProperty("--pointer-x", `${event.clientX - bounds.left}px`);
+            element.style.setProperty("--pointer-y", `${event.clientY - bounds.top}px`);
+        };
+        element.addEventListener("pointermove", move);
+        return () => element.removeEventListener("pointermove", move);
+    }, []);
+    return reference;
+}
+//# sourceMappingURL=index.js.map

package/distribution/pointer/spotlight/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/pointer/spotlight/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,8GAA8G;AAC9G,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAS,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,IAAI,GAAG,CAAC,KAAmB,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;YAC7E,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9E,CAAC,CAAC;QACF,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/distribution/search-engine/robots/index.d.ts

@@ -0,0 +1,4 @@
+import type { RobotsOptions, RobotsRules } from "@sharadox/web-library/search-engine/robots/type";
+/** robots.txt rules: everything allowed with the sitemap and host, or everything disallowed while not indexable. */
+export declare function robots({ url, indexable }: RobotsOptions): RobotsRules;
+//# sourceMappingURL=index.d.ts.map

package/distribution/search-engine/robots/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/search-engine/robots/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAElG,oHAAoH;AACpH,wBAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,aAAa,GAAG,WAAW,CAIrE"}

package/distribution/search-engine/robots/index.js

@@ -0,0 +1,7 @@
+/** robots.txt rules: everything allowed with the sitemap and host, or everything disallowed while not indexable. */
+export function robots({ url, indexable }) {
+    return indexable
+        ? { rules: { userAgent: "*", allow: "/" }, sitemap: `${url}/sitemap.xml`, host: url }
+        : { rules: { userAgent: "*", disallow: "/" } };
+}
+//# sourceMappingURL=index.js.map

package/distribution/search-engine/robots/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/search-engine/robots/index.ts"],"names":[],"mappings":"AAEA,oHAAoH;AACpH,MAAM,UAAU,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAiB;IACtD,OAAO,SAAS;QACd,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE;QACrF,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC"}

package/distribution/search-engine/robots/type.d.ts

@@ -0,0 +1,17 @@
+export interface RobotsOptions {
+    /** The site's public url without a trailing slash. */
+    url: string;
+    /** False keeps the whole site out of search engines (previews before a client launches). */
+    indexable: boolean;
+}
+/** The rules Next.js's `robots()` returns. */
+export interface RobotsRules {
+    rules: {
+        userAgent: string;
+        allow?: string;
+        disallow?: string;
+    };
+    sitemap?: string;
+    host?: string;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/search-engine/robots/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/search-engine/robots/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,4FAA4F;IAC5F,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/distribution/search-engine/robots/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/search-engine/robots/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/search-engine/robots/type.ts"],"names":[],"mappings":""}

package/distribution/search-engine/sitemap/index.d.ts

@@ -0,0 +1,4 @@
+import type { LocalizedSitemapOptions, SitemapEntry } from "@sharadox/web-library/search-engine/sitemap/type";
+/** A sitemap with one entry per locale (`/<locale>`), each listing every language version as an alternate. */
+export declare function localizedSitemap({ url, locales, primaryLocale, otherPriority, changeFrequency, lastModified, }: LocalizedSitemapOptions): SitemapEntry[];
+//# sourceMappingURL=index.d.ts.map

package/distribution/search-engine/sitemap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/search-engine/sitemap/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AAE9G,8GAA8G;AAC9G,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,OAAO,EACP,aAA0B,EAC1B,aAAiB,EACjB,eAA2B,EAC3B,YAAyB,GAC1B,EAAE,uBAAuB,GAAG,YAAY,EAAE,CAS1C"}

package/distribution/search-engine/sitemap/index.js

@@ -0,0 +1,12 @@
+/** A sitemap with one entry per locale (`/<locale>`), each listing every language version as an alternate. */
+export function localizedSitemap({ url, locales, primaryLocale = locales[0], otherPriority = 1, changeFrequency = "monthly", lastModified = new Date(), }) {
+    const languages = Object.fromEntries(locales.map((locale) => [locale, `${url}/${locale}`]));
+    return locales.map((locale) => ({
+        url: `${url}/${locale}`,
+        lastModified,
+        changeFrequency,
+        priority: locale === primaryLocale ? 1 : otherPriority,
+        alternates: { languages },
+    }));
+}
+//# sourceMappingURL=index.js.map

package/distribution/search-engine/sitemap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/search-engine/sitemap/index.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,MAAM,UAAU,gBAAgB,CAAC,EAC/B,GAAG,EACH,OAAO,EACP,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,EAC1B,aAAa,GAAG,CAAC,EACjB,eAAe,GAAG,SAAS,EAC3B,YAAY,GAAG,IAAI,IAAI,EAAE,GACD;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,GAAG,EAAE,GAAG,GAAG,IAAI,MAAM,EAAE;QACvB,YAAY;QACZ,eAAe;QACf,QAAQ,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;QACtD,UAAU,EAAE,EAAE,SAAS,EAAE;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/distribution/search-engine/sitemap/type.d.ts

@@ -0,0 +1,22 @@
+export interface LocalizedSitemapOptions {
+    /** The site's public url without a trailing slash, for example "https://sharadox.com". */
+    url: string;
+    locales: readonly string[];
+    /** Gets priority 1; the other locales get `otherPriority`. Defaults to the first locale. */
+    primaryLocale?: string;
+    otherPriority?: number;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    /** Defaults to now. */
+    lastModified?: Date;
+}
+/** One sitemap entry, in the shape Next.js's `sitemap()` returns. */
+export interface SitemapEntry {
+    url: string;
+    lastModified: Date;
+    changeFrequency: NonNullable<LocalizedSitemapOptions["changeFrequency"]>;
+    priority: number;
+    alternates: {
+        languages: Record<string, string>;
+    };
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/search-engine/sitemap/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/search-engine/sitemap/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5F,uBAAuB;IACvB,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,IAAI,CAAC;IACnB,eAAe,EAAE,WAAW,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACnD"}

package/distribution/search-engine/sitemap/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/search-engine/sitemap/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/search-engine/sitemap/type.ts"],"names":[],"mappings":""}

package/distribution/search-engine/structured-data/index.d.ts

@@ -0,0 +1,4 @@
+import type { StructuredDataProperties } from "@sharadox/web-library/search-engine/structured-data/type";
+/** Renders JSON-LD for search engines. `<` is escaped so the data can never close the script tag early. */
+export declare function StructuredData({ data }: StructuredDataProperties): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/distribution/search-engine/structured-data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/search-engine/structured-data/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AAEzG,2GAA2G;AAC3G,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,wBAAwB,+BAOhE"}

package/distribution/search-engine/structured-data/index.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Renders JSON-LD for search engines. `<` is escaped so the data can never close the script tag early. */
+export function StructuredData({ data }) {
+    return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(data).replace(/</g, "\\u003c") } }));
+}
+//# sourceMappingURL=index.js.map

package/distribution/search-engine/structured-data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/search-engine/structured-data/index.tsx"],"names":[],"mappings":";AAEA,2GAA2G;AAC3G,MAAM,UAAU,cAAc,CAAC,EAAE,IAAI,EAA4B;IAC/D,OAAO,CACL,iBACE,IAAI,EAAC,qBAAqB,EAC1B,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAClF,CACH,CAAC;AACJ,CAAC"}

package/distribution/search-engine/structured-data/type.d.ts

@@ -0,0 +1,5 @@
+export interface StructuredDataProperties {
+    /** A schema.org JSON-LD object, for example `{ "@context": "https://schema.org", "@type": "Restaurant", … }`. */
+    data: Record<string, unknown>;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/search-engine/structured-data/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/search-engine/structured-data/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,iHAAiH;IACjH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

package/distribution/search-engine/structured-data/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/search-engine/structured-data/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/search-engine/structured-data/type.ts"],"names":[],"mappings":""}

package/distribution/test/visual-snapshot/index.d.ts

@@ -0,0 +1,8 @@
+import type { Page } from "@playwright/test";
+import type { VisualSnapshotOptions } from "@sharadox/web-library/test/visual-snapshot/type";
+/**
+ * Prepares a page for a deterministic full-page screenshot: freezes the clock, opens the url, waits for fonts,
+ * scrolls through so every reveal-on-scroll fires, then returns to the top and lets animations finish.
+ */
+export declare function prepareVisualSnapshot(page: Page, url: string, { time, step }?: VisualSnapshotOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/distribution/test/visual-snapshot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/test/visual-snapshot/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAE7F;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,EAAE,IAAuC,EAAE,IAAU,EAAE,GAAE,qBAA0B,GAClF,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/distribution/test/visual-snapshot/index.js

@@ -0,0 +1,20 @@
+/**
+ * Prepares a page for a deterministic full-page screenshot: freezes the clock, opens the url, waits for fonts,
+ * scrolls through so every reveal-on-scroll fires, then returns to the top and lets animations finish.
+ */
+export async function prepareVisualSnapshot(page, url, { time = new Date("2026-11-08T12:00:00Z"), step = 400 } = {}) {
+    await page.clock.install({ time });
+    await page.clock.pauseAt(new Date(time.getTime() + 1000));
+    await page.goto(url);
+    await page.evaluate(() => document.fonts.ready);
+    const height = await page.evaluate(() => document.documentElement.scrollHeight);
+    for (let y = 0; y <= height; y += step) {
+        await page.evaluate((top) => window.scrollTo(0, top), y);
+        await page.waitForTimeout(60);
+        await page.clock.runFor(400);
+    }
+    await page.evaluate(() => window.scrollTo(0, 0));
+    await page.waitForTimeout(60);
+    await page.clock.runFor(4000);
+}
+//# sourceMappingURL=index.js.map

package/distribution/test/visual-snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/test/visual-snapshot/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAU,EACV,GAAW,EACX,EAAE,IAAI,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE,IAAI,GAAG,GAAG,KAA4B,EAAE;IAEnF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/distribution/test/visual-snapshot/type.d.ts

@@ -0,0 +1,7 @@
+export interface VisualSnapshotOptions {
+    /** The moment the page believes it is; animations and timers only move when the test advances the clock. */
+    time?: Date;
+    /** Pixels per scroll step while settling. Defaults to 400. */
+    step?: number;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/test/visual-snapshot/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/test/visual-snapshot/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,4GAA4G;IAC5G,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/distribution/test/visual-snapshot/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/test/visual-snapshot/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/test/visual-snapshot/type.ts"],"names":[],"mappings":""}

package/distribution/time/format-time/index.d.ts

@@ -0,0 +1,3 @@
+/** "HH:MM" on a 24-hour clock in a time zone, for example "17:28". */
+export declare function formatTime(date: Date, timeZone: string): string;
+//# sourceMappingURL=index.d.ts.map

package/distribution/time/format-time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/time/format-time/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI/D"}

package/distribution/time/format-time/index.js

@@ -0,0 +1,5 @@
+/** "HH:MM" on a 24-hour clock in a time zone, for example "17:28". */
+export function formatTime(date, timeZone) {
+    return new Intl.DateTimeFormat("en-GB", { timeZone, hour: "2-digit", minute: "2-digit", hourCycle: "h23" }).format(date);
+}
+//# sourceMappingURL=index.js.map

package/distribution/time/format-time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/time/format-time/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,QAAgB;IACrD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAChH,IAAI,CACL,CAAC;AACJ,CAAC"}

package/distribution/time/open-state/index.d.ts

@@ -0,0 +1,4 @@
+import type { OpenState, TimeOfDay } from "@sharadox/web-library/time/open-state/type";
+/** Whether a place with daily hours `from`–`to` is open at `now`, in the place's time zone. */
+export declare function openState(now: Date, from: TimeOfDay, to: TimeOfDay, timeZone: string): OpenState;
+//# sourceMappingURL=index.d.ts.map

package/distribution/time/open-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/time/open-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAGvF,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAKhG"}

package/distribution/time/open-state/index.js

@@ -0,0 +1,11 @@
+import { minutesInZone } from "@sharadox/web-library/time/zone-minute";
+/** Whether a place with daily hours `from`–`to` is open at `now`, in the place's time zone. */
+export function openState(now, from, to, timeZone) {
+    const minutes = minutesInZone(now, timeZone);
+    if (minutes < from[0] * 60 + from[1])
+        return "before";
+    if (minutes >= to[0] * 60 + to[1])
+        return "after";
+    return "open";
+}
+//# sourceMappingURL=index.js.map

package/distribution/time/open-state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/time/open-state/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,GAAS,EAAE,IAAe,EAAE,EAAa,EAAE,QAAgB;IACnF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtD,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/distribution/time/open-state/type.d.ts

@@ -0,0 +1,5 @@
+/** Before opening, open, or after closing — today, in the place's time zone. */
+export type OpenState = "open" | "before" | "after";
+/** A time of day as [hours, minutes]. */
+export type TimeOfDay = readonly [number, number];
+//# sourceMappingURL=type.d.ts.map

package/distribution/time/open-state/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../source/time/open-state/type.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/distribution/time/open-state/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/time/open-state/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../source/time/open-state/type.ts"],"names":[],"mappings":""}

package/distribution/time/sun-time/index.d.ts

@@ -0,0 +1,4 @@
+import type { SunTimes } from "@sharadox/web-library/time/sun-time/type";
+/** Sunrise and sunset for a date and place (NOAA solar position approximation, ±1–2 minutes). */
+export declare function sunTimes(date: Date, latitude: number, longitude: number): SunTimes;
+//# sourceMappingURL=index.d.ts.map

package/distribution/time/sun-time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/time/sun-time/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAIzE,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CA4BlF"}

package/distribution/time/sun-time/index.js

@@ -0,0 +1,27 @@
+const RADIANS_PER_DEGREE = Math.PI / 180;
+/** Sunrise and sunset for a date and place (NOAA solar position approximation, ±1–2 minutes). */
+export function sunTimes(date, latitude, longitude) {
+    const year = date.getUTCFullYear();
+    const midnight = Date.UTC(year, date.getUTCMonth(), date.getUTCDate());
+    const day = Math.floor((midnight - Date.UTC(year, 0, 0)) / 864e5);
+    const yearAngle = ((2 * Math.PI) / 365) * (day - 1 + 0.5);
+    const equationOfTime = 229.18 *
+        (0.000075 +
+            0.001868 * Math.cos(yearAngle) -
+            0.032077 * Math.sin(yearAngle) -
+            0.014615 * Math.cos(2 * yearAngle) -
+            0.040849 * Math.sin(2 * yearAngle));
+    const declination = 0.006918 -
+        0.399912 * Math.cos(yearAngle) +
+        0.070257 * Math.sin(yearAngle) -
+        0.006758 * Math.cos(2 * yearAngle) +
+        0.000907 * Math.sin(2 * yearAngle) -
+        0.002697 * Math.cos(3 * yearAngle) +
+        0.00148 * Math.sin(3 * yearAngle);
+    const hourAngle = Math.acos(Math.cos(90.833 * RADIANS_PER_DEGREE) / (Math.cos(latitude * RADIANS_PER_DEGREE) * Math.cos(declination)) -
+        Math.tan(latitude * RADIANS_PER_DEGREE) * Math.tan(declination)) / RADIANS_PER_DEGREE;
+    const riseMinutes = 720 - 4 * (longitude + hourAngle) - equationOfTime;
+    const setMinutes = 720 - 4 * (longitude - hourAngle) - equationOfTime;
+    return { rise: new Date(midnight + riseMinutes * 6e4), set: new Date(midnight + setMinutes * 6e4) };
+}
+//# sourceMappingURL=index.js.map