@decocms/apps-website 7.2.0

package/src/types.ts

@@ -0,0 +1,125 @@
+/**
+ * Core types for the website app.
+ *
+ * Defines the matcher/flag system types locally so we don't depend on
+ * @deco/deco/blocks — everything is self-contained in @decocms/apps.
+ */
+
+// -------------------------------------------------------------------------
+// Script
+// -------------------------------------------------------------------------
+
+export type Script = { src: string | ((req: Request) => string) };
+
+// -------------------------------------------------------------------------
+// Matcher system
+// -------------------------------------------------------------------------
+
+/**
+ * Context passed to matchers at request time.
+ * The framework populates this from the incoming request.
+ */
+export interface MatchContext {
+	request: Request;
+	device: "mobile" | "tablet" | "desktop";
+	siteId: number;
+}
+
+/**
+ * A matcher is a function that evaluates request context and returns a boolean.
+ */
+export type Matcher = (ctx: MatchContext) => boolean;
+
+// -------------------------------------------------------------------------
+// Flag system
+// -------------------------------------------------------------------------
+
+/**
+ * A feature flag with a matcher and two branches.
+ * The framework evaluates the matcher at request time and selects the
+ * appropriate branch value.
+ */
+export interface FlagObj<T> {
+	matcher: Matcher;
+	true: T;
+	false: T;
+	name: string;
+}
+
+/**
+ * A multivariate flag with multiple variants, each with its own matcher.
+ */
+export interface MultivariateFlag<T> {
+	variants: Variant<T>[];
+}
+
+/**
+ * A single variant in a multivariate flag.
+ */
+export interface Variant<T> {
+	matcher?: Matcher;
+	value: T;
+	weight?: number;
+}
+
+// -------------------------------------------------------------------------
+// Theme / Font types
+// -------------------------------------------------------------------------
+
+export interface Variable {
+	name: string;
+	value: string;
+}
+
+export type Font = {
+	family: string;
+	styleSheet: string;
+};
+
+// -------------------------------------------------------------------------
+// SEO types
+// -------------------------------------------------------------------------
+
+/** @description Recommended: 1200 x 630 px (up to 5MB) */
+export type ImageWidget = string;
+
+export type OGType = "website" | "article";
+
+export interface SeoConfig {
+	title?: string;
+	/**
+	 * @title Title template
+	 * @description add a %s whenever you want it to be replaced with the product name, category name or search term
+	 * @default %s
+	 */
+	titleTemplate?: string;
+	description?: string;
+	/**
+	 * @title Description template
+	 * @description add a %s whenever you want it to be replaced with the product name, category name or search term
+	 * @default %s
+	 */
+	descriptionTemplate?: string;
+	/** @default website */
+	type?: OGType;
+	/** @description Recommended: 1200 x 630 px (up to 5MB) */
+	image?: ImageWidget;
+	/** @description Recommended: 16 x 16 px */
+	favicon?: ImageWidget;
+	/** @description Suggested color that browsers should use to customize the display */
+	themeColor?: string;
+	/**
+	 * @title Disable indexing
+	 * @description In testing, you can use this to prevent search engines from indexing your site
+	 */
+	noIndexing?: boolean;
+}
+
+// -------------------------------------------------------------------------
+// Website app config
+// -------------------------------------------------------------------------
+
+export interface WebsiteConfig {
+	/** @title Seo */
+	seo?: SeoConfig;
+}

package/src/utils/html.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { stripHTML } from "./html";
+
+describe("stripHTML", () => {
+	it("strips HTML tags from string", () => {
+		expect(stripHTML("<p>Hello <strong>World</strong></p>")).toBe("Hello World");
+	});
+
+	it("returns plain text unchanged", () => {
+		expect(stripHTML("no tags here")).toBe("no tags here");
+	});
+
+	it("handles empty string", () => {
+		expect(stripHTML("")).toBe("");
+	});
+
+	it("strips self-closing tags", () => {
+		expect(stripHTML("Hello<br/>World")).toBe("HelloWorld");
+	});
+
+	it("strips nested tags", () => {
+		expect(stripHTML("<div><p><span>text</span></p></div>")).toBe("text");
+	});
+});

package/src/utils/html.ts

@@ -0,0 +1 @@
+export const stripHTML = (str: string) => str.replace(/(<([^>]+)>)/gi, "");

package/src/utils/location.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { haversine, toRadians } from "./location";
+
+describe("toRadians", () => {
+	it("converts 0 degrees to 0 radians", () => {
+		expect(toRadians(0)).toBe(0);
+	});
+
+	it("converts 180 degrees to PI radians", () => {
+		expect(toRadians(180)).toBeCloseTo(Math.PI);
+	});
+
+	it("converts 90 degrees to PI/2 radians", () => {
+		expect(toRadians(90)).toBeCloseTo(Math.PI / 2);
+	});
+});
+
+describe("haversine", () => {
+	it("returns 0 for same coordinates", () => {
+		expect(haversine("-23.5505,-46.6333", "-23.5505,-46.6333")).toBeCloseTo(0, 0);
+	});
+
+	it("calculates distance between São Paulo and Rio (~360km)", () => {
+		const sp = "-23.5505,-46.6333";
+		const rj = "-22.9068,-43.1729";
+		const distance = haversine(sp, rj);
+		// ~360km
+		expect(distance).toBeGreaterThan(350000);
+		expect(distance).toBeLessThan(380000);
+	});
+
+	it("calculates distance between New York and London (~5570km)", () => {
+		const ny = "40.7128,-74.0060";
+		const london = "51.5074,-0.1278";
+		const distance = haversine(ny, london);
+		// ~5570km
+		expect(distance).toBeGreaterThan(5500000);
+		expect(distance).toBeLessThan(5700000);
+	});
+});

package/src/utils/location.ts

@@ -0,0 +1,20 @@
+export const toRadians = (degrees: number): number => {
+	return degrees * (Math.PI / 180);
+};
+
+export const haversine = (coordinate1: string, coordinate2: string): number => {
+	const [lat1, lng1] = coordinate1.split(",").map((value) => Number(value));
+	const [lat2, lng2] = coordinate2.split(",").map((value) => Number(value));
+
+	const earthRadius = 6371000; // Earth radius in meters
+	const dLat = toRadians(lat1 - lat2);
+	const dLon = toRadians(lng1 - lng2);
+
+	const halfChordLengthSquared =
+		Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+		Math.sin(dLon / 2) * Math.sin(dLon / 2) * Math.cos(toRadians(lat1)) * Math.cos(toRadians(lat2));
+
+	const angularDistance =
+		2 * Math.atan2(Math.sqrt(halfChordLengthSquared), Math.sqrt(1 - halfChordLengthSquared));
+	return earthRadius * angularDistance;
+};

package/src/utils/multivariate.ts

@@ -0,0 +1,20 @@
+import type { MultivariateFlag, Variant } from "../types";
+
+/**
+ * @title Multivariate
+ */
+export interface MultivariateProps<T> {
+	/**
+	 * @minItems 1
+	 * @addBehavior 1
+	 */
+	variants: Variant<T>[];
+}
+
+/**
+ * @title Variant
+ * @label hidden
+ */
+export default function multivariate<T>(props: MultivariateProps<T>): MultivariateFlag<T> {
+	return props;
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}