snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

packages/css-supports/jest.config.ts

@@ -0,0 +1,21 @@
+import client from '@rocket.chat/jest-presets/client';
+import server from '@rocket.chat/jest-presets/server';
+import type { Config } from 'jest';
+
+export default {
+	projects: [
+		{
+			displayName: 'client',
+			preset: client.preset,
+			setupFilesAfterEnv: [...client.setupFilesAfterEnv],
+			testMatch: ['<rootDir>/src/**/*.client.spec.[jt]s?(x)'],
+		},
+		{
+			displayName: 'server',
+			preset: server.preset,
+			testMatch: ['<rootDir>/src/**/*.server.spec.[jt]s?(x)'],
+		},
+	],
+	coverageProvider: 'v8',
+	collectCoverage: true,
+} satisfies Config;

packages/css-supports/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@rocket.chat/css-supports",
+	"version": "0.31.25",
+	"description": "Memoized and SSR-compatible facade of CSS.supports API",
+	"bugs": {
+		"url": "https://github.com/RocketChat/Rocket.Chat/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/RocketChat/Rocket.Chat.git",
+		"directory": "packages/css-supports"
+	},
+	"license": "MIT",
+	"author": {
+		"name": "Rocket.Chat",
+		"url": "https://rocket.chat/"
+	},
+	"main": "dist/cjs/index.js",
+	"module": "dist/esm/index.js",
+	"types": "dist/esm/index.d.ts",
+	"files": [
+		"/dist"
+	],
+	"scripts": {
+		"build": "rm -rf dist && tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"test": "jest",
+		"testunit": "jest",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@rocket.chat/memo": "workspace:~"
+	},
+	"devDependencies": {
+		"@rocket.chat/jest-presets": "workspace:~",
+		"@rocket.chat/tsconfig": "workspace:~",
+		"eslint": "~9.39.5",
+		"jest": "~30.2.0",
+		"typescript": "~5.9.3"
+	},
+	"volta": {
+		"extends": "../../package.json"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

packages/css-supports/src/index.client.spec.ts

@@ -0,0 +1,61 @@
+/**
+ * Runs in the `client` project, whose jsdom environment provides a `window` but no `CSS` object at
+ * all, so a browser's `CSS.supports` is what the stub below stands in for.
+ *
+ * `cssSupports` picks its implementation when the module is first evaluated, so every case resets
+ * the module registry and sets up `window.CSS` before importing.
+ */
+
+const stubCSSSupports = (supports: (value: string) => boolean): void => {
+	Object.defineProperty(window, 'CSS', {
+		value: { supports },
+		configurable: true,
+		writable: true,
+	});
+};
+
+beforeEach(() => {
+	jest.resetModules();
+	Reflect.deleteProperty(window, 'CSS');
+});
+
+afterEach(() => {
+	Reflect.deleteProperty(window, 'CSS');
+});
+
+describe('with no CSS.supports to delegate to', () => {
+	it('should report every query as unsupported', async () => {
+		expect(window.CSS).toBeUndefined();
+
+		const { cssSupports } = await import('./index');
+
+		expect(cssSupports('display:flex')).toBe(false);
+	});
+});
+
+describe('with CSS.supports available', () => {
+	it('should delegate the query and relay the answer', async () => {
+		const supports = jest.fn((value: string) => value === 'display:flex');
+		stubCSSSupports(supports);
+
+		const { cssSupports } = await import('./index');
+
+		expect(cssSupports('display:flex')).toBe(true);
+		expect(cssSupports('display:grid')).toBe(false);
+		expect(supports).toHaveBeenCalledWith('display:flex');
+		expect(supports).toHaveBeenCalledWith('display:grid');
+	});
+
+	it('should evaluate each distinct query only once', async () => {
+		const supports = jest.fn(() => true);
+		stubCSSSupports(supports);
+
+		const { cssSupports } = await import('./index');
+
+		cssSupports('display:flex');
+		cssSupports('display:flex');
+		cssSupports('display:grid');
+
+		expect(supports).toHaveBeenCalledTimes(2);
+	});
+});

packages/css-supports/src/index.server.spec.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs in the `server` project, whose environment has no `window` at all — the server-side
+ * rendering path `cssSupports` has to survive.
+ */
+
+it('should report every query as unsupported instead of throwing', async () => {
+	expect(typeof window).toBe('undefined');
+
+	const { cssSupports } = await import('./index');
+
+	expect(cssSupports('display:flex')).toBe(false);
+	expect(cssSupports('margin-inline-start:0')).toBe(false);
+});

packages/css-supports/src/index.ts

@@ -0,0 +1,4 @@
+import { memoize } from '@rocket.chat/memo';
+
+export const cssSupports: (value: string) => boolean =
+	typeof window !== 'undefined' && window.CSS?.supports ? memoize((value: string) => window.CSS.supports(value)) : () => false;

packages/css-supports/tsconfig.cjs.json

@@ -0,0 +1,11 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"module": "commonjs",
+		"moduleResolution": "node",
+		"outDir": "./dist/cjs",
+		"declaration": false,
+		"declarationMap": false
+	},
+	"exclude": ["**/*.spec.ts", "jest.config.*"]
+}

packages/css-supports/tsconfig.esm.json

@@ -0,0 +1,9 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"module": "esnext",
+		"moduleResolution": "bundler",
+		"outDir": "./dist/esm"
+	},
+	"exclude": ["**/*.spec.ts", "jest.config.*"]
+}

packages/css-supports/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "@rocket.chat/tsconfig/client.json",
+	"compilerOptions": {
+		"target": "es2024",
+		"rootDir": "./src"
+	},
+	"include": ["src/**/*"]
+}