@musecat/functionkit 1.1.0 → 1.2.0

package/CONTRIBUTING.md

@@ -1,39 +0,0 @@
-# Contributing to @musecat/functionkit
-
-Thank you for your interest in contributing! We welcome bug reports, feature suggestions, and pull requests.
-
-## Development Setup
-
-```bash
-git clone https://github.com/TheTechclip/FunctionKit.git
-cd FunctionKit
-npm install
-```
-
-## Available Scripts
-
-| Command | Description |
-|---|---|
-| `npm test` | Run all tests with Vitest |
-| `npm run test:coverage` | Run tests with coverage report |
-| `npm run lint` | Lint all files with Biome |
-| `npm run format` | Format all files with Prettier + Biome |
-
-## Code Standards
-
-- TypeScript strict mode is enabled — ensure your code compiles without errors.
-- All new features must include corresponding tests.
-- Hooks must start with `"use client"` directive. Pure utility functions must NOT.
-- Barrel exports (`index.ts`) must be updated for new public APIs.
-- Follow the existing code style (tabs, double quotes, semicolons).
-
-## Pull Request Process
-
-1. Create a feature branch from `master`.
-2. Write tests for your changes.
-3. Ensure `npm run lint && npm test` passes.
-4. Open a pull request describing the change and its motivation.
-
-## Questions?
-
-Feel free to open a discussion or issue for any questions.

package/biome.json

@@ -1,25 +0,0 @@
-{
-	"$schema": "https://biomejs.dev/schemas/2.5.4/schema.json",
-	"assist": { "actions": { "source": { "organizeImports": "on" } } },
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"preset": "recommended"
-		}
-	},
-	"formatter": {
-		"enabled": true,
-		"indentStyle": "tab",
-		"indentWidth": 2,
-		"lineWidth": 100
-	},
-	"javascript": {
-		"formatter": {
-			"quoteStyle": "double",
-			"semicolons": "always"
-		}
-	},
-	"files": {
-		"includes": ["**", "!**/dist", "!**/coverage", "!**/node_modules"]
-	}
-}

package/tests/components/ScrolltoTop.test.tsx

@@ -1,15 +0,0 @@
-import { render } from "@testing-library/react";
-import { describe, expect, test, vi } from "vitest";
-import { ScrolltoTop } from "@/packages/components/ScrolltoTop";
-
-describe("ScrolltoTop", () => {
-	test("calls window.scrollTo(0, 0) on mount", () => {
-		const originalScrollTo = window.scrollTo;
-		window.scrollTo = vi.fn();
-
-		render(<ScrolltoTop />);
-		expect(window.scrollTo).toHaveBeenCalledWith(0, 0);
-
-		window.scrollTo = originalScrollTo;
-	});
-});

package/tests/components/SwitchCase.test.tsx

@@ -1,33 +0,0 @@
-import { render } from "@testing-library/react";
-import { describe, expect, test } from "vitest";
-import { SwitchCase } from "@/packages/components/SwitchCase";
-
-describe("SwitchCase", () => {
-	const cases = {
-		1: <div>Case 1</div>,
-		2: <div>Case 2</div>,
-		three: <div>Case Three</div>,
-	};
-
-	test("renders correctly matching case", () => {
-		const { container } = render(<SwitchCase value={1} cases={cases} />);
-		expect(container.textContent).toBe("Case 1");
-	});
-
-	test("renders another case", () => {
-		const { container } = render(<SwitchCase value="three" cases={cases} />);
-		expect(container.textContent).toBe("Case Three");
-	});
-
-	test("renders otherwise when case does not exist", () => {
-		const { container } = render(
-			<SwitchCase value={99} cases={cases} otherwise={<div>Fallback</div>} />,
-		);
-		expect(container.textContent).toBe("Fallback");
-	});
-
-	test("renders null when case does not exist and otherwise is not provided", () => {
-		const { container } = render(<SwitchCase value={99} cases={cases} />);
-		expect(container.innerHTML).toBe("");
-	});
-});

package/tests/components/ViewportPortal.test.tsx

@@ -1,46 +0,0 @@
-import { render, screen } from "@testing-library/react";
-import { beforeEach, describe, expect, test } from "vitest";
-import { getViewportPortalRoot, ViewportPortal } from "@/packages/components/ViewportPortal";
-
-describe("ViewportPortal", () => {
-	beforeEach(() => {
-		document.body.innerHTML = "";
-	});
-
-	test("getViewportPortalRoot creates a root element if it doesn't exist", () => {
-		const root = getViewportPortalRoot();
-		expect(root).not.toBeNull();
-		expect(root?.id).toBe("viewport-portal-root");
-		expect(document.getElementById("viewport-portal-root")).toBe(root);
-	});
-
-	test("getViewportPortalRoot returns existing root element if it exists", () => {
-		const root1 = getViewportPortalRoot();
-		const root2 = getViewportPortalRoot();
-		expect(root1).toBe(root2);
-		expect(document.querySelectorAll("#viewport-portal-root").length).toBe(1);
-	});
-
-	test("getViewportPortalRoot returns null when document is undefined (SSR)", () => {
-		const origDocument = global.document;
-		// @ts-expect-error
-		delete global.document;
-		expect(getViewportPortalRoot()).toBeNull();
-		global.document = origDocument;
-	});
-
-	test("ViewportPortal renders children into the portal root", () => {
-		render(
-			<ViewportPortal>
-				<div data-testid="portal-content">Portal Content</div>
-			</ViewportPortal>,
-		);
-
-		const root = document.getElementById("viewport-portal-root");
-		expect(root).not.toBeNull();
-
-		const content = screen.getByTestId("portal-content");
-		expect(content.textContent).toBe("Portal Content");
-		expect(root?.contains(content)).toBe(true);
-	});
-});

package/tests/cookie/cookie.test.ts

@@ -1,192 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
-import {
-	clearAllClientCookies,
-	clearClientCookie,
-	getClientCookie,
-	setClientCookie,
-} from "@/packages/cookie/cookie.shared";
-import { parseClientCookieNames } from "@/packages/cookie/cookieNames.shared";
-
-describe("cookie module", () => {
-	beforeEach(() => {
-		// Reset cookies
-		Object.defineProperty(document, "cookie", {
-			writable: true,
-			value: "",
-		});
-
-		// Mock window location
-		Object.defineProperty(window, "location", {
-			writable: true,
-			value: { hostname: "example.com", pathname: "/test/path" },
-		});
-	});
-
-	afterEach(() => {
-		vi.restoreAllMocks();
-	});
-
-	describe("parseClientCookieNames", () => {
-		test("parses cookie string correctly", () => {
-			const result = parseClientCookieNames("foo=bar; baz=qux; ; empty=");
-			expect(result).toEqual(["foo", "baz", "empty"]);
-		});
-
-		test("returns empty array for empty string", () => {
-			expect(parseClientCookieNames("")).toEqual([]);
-		});
-	});
-
-	describe("getClientCookie", () => {
-		test("returns cookie value if it exists", () => {
-			document.cookie = "foo=bar; baz=qux";
-			expect(getClientCookie("foo")).toBe("bar");
-			expect(getClientCookie("baz")).toBe("qux");
-		});
-
-		test("skips cookies with empty name when parsing", () => {
-			document.cookie = "=value; foo=bar";
-			expect(getClientCookie("foo")).toBe("bar");
-		});
-
-		test("returns undefined if cookie does not exist", () => {
-			document.cookie = "foo=bar";
-			expect(getClientCookie("missing")).toBeUndefined();
-		});
-
-		test("handles undefined document", () => {
-			const originalDocument = global.document;
-			// @ts-expect-error
-			delete global.document;
-
-			expect(getClientCookie("foo")).toBeUndefined();
-
-			global.document = originalDocument;
-		});
-	});
-
-	describe("setClientCookie", () => {
-		test("handles undefined document in setClientCookie", () => {
-			const origDocument = global.document;
-			// @ts-expect-error
-			delete global.document;
-			setClientCookie("foo", "bar");
-			global.document = origDocument;
-		});
-
-		test("parseClientCookie handles malformed entries", () => {
-			const result = parseClientCookieNames("=value; key");
-			expect(result).toEqual(["key"]);
-		});
-
-		test("clearAllClientCookies handles empty cookie name", () => {
-			const mockDoc = { cookie: "=1;;" };
-			const entries = clearAllClientCookies({ documentRef: mockDoc as any });
-			expect(Array.isArray(entries)).toBe(true);
-		});
-
-		test("clearAllClientCookies skips entries with empty name", () => {
-			const mockDoc = { cookie: "a=1;;b=2" };
-			const entries = clearAllClientCookies({ documentRef: mockDoc as any });
-			// Entries with empty names should be skipped in the loop
-			expect(entries).toEqual(["a", "b"]);
-		});
-
-		test("setClientCookie with days=0 does not add expires", () => {
-			setClientCookie("foo", "bar", 0);
-			expect(document.cookie).toBe("foo=bar; path=/");
-		});
-
-		test("sets cookie with name and value", () => {
-			setClientCookie("foo", "bar");
-			expect(document.cookie).toBe("foo=bar; path=/");
-		});
-
-		test("sets cookie with days", () => {
-			vi.useFakeTimers();
-			vi.setSystemTime(new Date("2020-01-01T00:00:00Z"));
-
-			setClientCookie("foo", "bar", 7);
-
-			const expectedDate = new Date("2020-01-08T00:00:00Z").toUTCString();
-			expect(document.cookie).toBe(`foo=bar; expires=${expectedDate}; path=/`);
-
-			vi.useRealTimers();
-		});
-
-		test("encodes cookie value", () => {
-			setClientCookie("foo", "val ue;");
-			expect(document.cookie).toBe("foo=val%20ue%3B; path=/");
-		});
-	});
-
-	describe("clearClientCookie", () => {
-		test("clears cookie with default options", () => {
-			document.cookie = "foo=bar";
-			clearClientCookie("foo");
-			expect(document.cookie).toBe(
-				"foo=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/; domain=example.com;",
-			);
-		});
-
-		test("clears cookie with custom options", () => {
-			const mockDoc = { cookie: "" };
-			clearClientCookie("foo", {
-				hostname: "custom.com",
-				path: "/custom",
-				documentRef: mockDoc,
-			});
-			expect(mockDoc.cookie).toBe(
-				"foo=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/custom; domain=custom.com;",
-			);
-		});
-	});
-
-	describe("clearAllClientCookies", () => {
-		test("clears all cookies based on documentRef.cookie", () => {
-			const mockDoc = { cookie: "a=1; b=2" };
-			const entries = clearAllClientCookies({ documentRef: mockDoc });
-
-			expect(entries).toEqual(["a", "b"]);
-			expect(mockDoc.cookie).toContain(
-				"b=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/test/path; domain=com;",
-			);
-		});
-
-		test("clears cookies using cookieStore if provided", async () => {
-			const cookieStore = { delete: vi.fn().mockResolvedValue(undefined) };
-			const mockDoc = { cookie: "a=1; b=2" };
-
-			const entries = clearAllClientCookies({
-				documentRef: mockDoc,
-				cookieStore,
-			});
-
-			expect(entries).toEqual(["a", "b"]);
-			expect(cookieStore.delete).toHaveBeenCalledWith("a");
-			expect(cookieStore.delete).toHaveBeenCalledWith("b");
-		});
-
-		test("clears cookies from root path when includeRoot is true", () => {
-			const mockDoc = { cookie: "a=1" };
-			clearAllClientCookies({ documentRef: mockDoc, includeRoot: true });
-
-			// The function iterates and updates document.cookie, so it will contain the last assignment.
-			// With paths ["/", "/test/path"] and domain "example.com"
-			expect(mockDoc.cookie).toContain(
-				"a=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/test/path; domain=com;",
-			);
-		});
-
-		test("uses provided cookieString instead of documentRef.cookie", () => {
-			const mockDoc = { cookie: "a=1" };
-			const entries = clearAllClientCookies({
-				documentRef: mockDoc,
-				cookieString: "x=1; y=2",
-			});
-
-			expect(entries).toEqual(["x", "y"]);
-			expect(mockDoc.cookie).toContain("y=;");
-		});
-	});
-});