@jfdevelops/react-layout-adapters 0.0.0-stub.0 → 0.1.0

package/README.md

@@ -1,4 +1,34 @@
-# @jfdevelops/react-layout-adapters
-
-Temporary placeholder for an upcoming React Layout adapter package.
-This prerelease contains no implementation and is published under the `stub` tag.
+# @jfdevelops/react-layout-adapters
+
+Create native React schemas for any Standard Schema library. This package
+provides a named `createAdapter` export and depends on no schema library.
+
+```sh
+pnpm add @jfdevelops/react-layout-adapters
+```
+
+```ts
+import { createAdapter } from '@jfdevelops/react-layout-adapters';
+import { z } from 'zod';
+import type { ReactElement, ReactNode } from 'react';
+
+export const { reactNode, reactElement } = createAdapter({
+  node: (check) => z.custom<ReactNode>(check).optional(),
+  element: (check) => z.custom<ReactElement>(check),
+});
+```
+
+The callbacks receive type guards for `ReactNode` and `ReactElement`. Return
+your library's corresponding Standard Schema from each callback. Both helpers
+preserve the exact returned schema type and create a fresh schema on every
+call; callbacks run when a helper is called, not when the adapter is created.
+Use the native library to configure messages, optionality, and other behavior.
+
+React node checks include empty nodes and reusable collections. One-shot
+iterators must be materialized into arrays before validation. Element checks
+use `React.isValidElement`; they accept `<Icon />`, not `Icon`.
+
+Ready-made adapters are available separately as
+`@jfdevelops/react-layout-adapter-zod`,
+`@jfdevelops/react-layout-adapter-valibot`, and
+`@jfdevelops/react-layout-adapter-arktype`.

package/dist/index.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/react-node.ts
+/** Check node containers without invoking components or awaiting promises. */
+function createReactNodeCheck(isValidElement, version) {
+	const supportsAsyncNodes = Number.parseInt(version, 10) >= 19;
+	function checkReactNode(value, ancestors) {
+		if (value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
+		if (typeof value === "bigint") return supportsAsyncNodes;
+		if (isValidElement(value)) return true;
+		if (typeof value !== "object") return false;
+		if ("$$typeof" in value && value.$$typeof === Symbol.for("react.portal")) return true;
+		if (supportsAsyncNodes && "then" in value && typeof value.then === "function") return true;
+		if (!(Symbol.iterator in value) || typeof value[Symbol.iterator] !== "function" || ancestors.has(value)) return false;
+		const iterator = value[Symbol.iterator]();
+		if (iterator === value) return false;
+		ancestors.add(value);
+		try {
+			let step = iterator.next();
+			while (!step.done) {
+				if (!checkReactNode(step.value, ancestors)) return false;
+				step = iterator.next();
+			}
+			return true;
+		} finally {
+			ancestors.delete(value);
+		}
+	}
+	return function isReactNode(value) {
+		return checkReactNode(value, /* @__PURE__ */ new Set());
+	};
+}
+//#endregion
+//#region src/index.ts
+const allowsReactNode = createReactNodeCheck(react.isValidElement, react.version);
+function isReactNode(value) {
+	return allowsReactNode(value);
+}
+function isReactElement(value) {
+	return (0, react.isValidElement)(value);
+}
+/** Wrap React predicates in your schema library's native schema constructors. */
+function createAdapter(options) {
+	const { node, element } = options;
+	return {
+		reactNode() {
+			return node(isReactNode);
+		},
+		reactElement() {
+			return element(isReactElement);
+		}
+	};
+}
+//#endregion
+exports.createAdapter = createAdapter;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["isValidElement","version"],"sources":["../src/react-node.ts","../src/index.ts"],"sourcesContent":["/** Check node containers without invoking components or awaiting promises. */\nexport function createReactNodeCheck(isValidElement: (value: unknown) => boolean, version: string) {\n  const supportsAsyncNodes = Number.parseInt(version, 10) >= 19;\n\n  function checkReactNode(value: unknown, ancestors: Set<object>): boolean {\n    if (value == null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return true;\n    if (typeof value === 'bigint') return supportsAsyncNodes;\n    if (isValidElement(value)) return true;\n    if (typeof value !== 'object') return false;\n    if ('$$typeof' in value && value.$$typeof === Symbol.for('react.portal')) return true;\n    if (supportsAsyncNodes && 'then' in value && typeof value.then === 'function') return true;\n    if (!(Symbol.iterator in value) || typeof value[Symbol.iterator] !== 'function' || ancestors.has(value)) return false;\n\n    const iterator = (value as Iterable<unknown>)[Symbol.iterator]();\n    // Consuming a one-shot iterator here would leave React with no children.\n    if ((iterator as unknown) === value) return false;\n\n    ancestors.add(value);\n    try {\n      let step = iterator.next();\n      while (!step.done) {\n        if (!checkReactNode(step.value, ancestors)) return false;\n        step = iterator.next();\n      }\n      return true;\n    } finally {\n      ancestors.delete(value);\n    }\n  }\n\n  return function isReactNode(value: unknown) {\n    return checkReactNode(value, new Set<object>());\n  };\n}\n","import {\n  isValidElement,\n  version,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { createReactNodeCheck } from './react-node';\n\ntype CreateAdapterOptions<\n  TNode extends StandardSchemaV1<unknown, ReactNode>,\n  TElement extends StandardSchemaV1<unknown, ReactElement>,\n> = {\n  node: (check: ReactCheck<ReactNode>) => TNode;\n  element: (check: ReactCheck<ReactElement>) => TElement;\n};\n\nconst allowsReactNode = createReactNodeCheck(isValidElement, version);\n\nexport type ReactCheck<Value> = (value: unknown) => value is Value;\n\nfunction isReactNode(value: unknown): value is ReactNode {\n  return allowsReactNode(value);\n}\n\nfunction isReactElement(value: unknown): value is ReactElement {\n  return isValidElement(value);\n}\n\n/** Wrap React predicates in your schema library's native schema constructors. */\nexport function createAdapter<\n  TNode extends StandardSchemaV1<unknown, ReactNode>,\n  TElement extends StandardSchemaV1<unknown, ReactElement>,\n>(options: CreateAdapterOptions<TNode, TElement>) {\n  const { node, element } = options;\n\n  return {\n    reactNode() {\n      return node(isReactNode);\n    },\n    reactElement() {\n      return element(isReactElement);\n    },\n  };\n}\n"],"mappings":";;;;AACA,SAAgB,qBAAqB,gBAA6C,SAAiB;CACjG,MAAM,qBAAqB,OAAO,SAAS,SAAS,EAAE,KAAK;CAE3D,SAAS,eAAe,OAAgB,WAAiC;EACvE,IAAI,SAAS,QAAQ,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO;EAClH,IAAI,OAAO,UAAU,UAAU,OAAO;EACtC,IAAI,eAAe,KAAK,GAAG,OAAO;EAClC,IAAI,OAAO,UAAU,UAAU,OAAO;EACtC,IAAI,cAAc,SAAS,MAAM,aAAa,OAAO,IAAI,cAAc,GAAG,OAAO;EACjF,IAAI,sBAAsB,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,OAAO;EACtF,IAAI,EAAE,OAAO,YAAY,UAAU,OAAO,MAAM,OAAO,cAAc,cAAc,UAAU,IAAI,KAAK,GAAG,OAAO;EAEhH,MAAM,WAAY,MAA4B,OAAO,UAAU;EAE/D,IAAK,aAAyB,OAAO,OAAO;EAE5C,UAAU,IAAI,KAAK;EACnB,IAAI;GACF,IAAI,OAAO,SAAS,KAAK;GACzB,OAAO,CAAC,KAAK,MAAM;IACjB,IAAI,CAAC,eAAe,KAAK,OAAO,SAAS,GAAG,OAAO;IACnD,OAAO,SAAS,KAAK;GACvB;GACA,OAAO;EACT,UAAU;GACR,UAAU,OAAO,KAAK;EACxB;CACF;CAEA,OAAO,SAAS,YAAY,OAAgB;EAC1C,OAAO,eAAe,uBAAO,IAAI,IAAY,CAAC;CAChD;AACF;;;AChBA,MAAM,kBAAkB,qBAAqBA,MAAAA,gBAAgBC,MAAAA,OAAO;AAIpE,SAAS,YAAY,OAAoC;CACvD,OAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,eAAe,OAAuC;CAC7D,QAAA,GAAA,MAAA,gBAAsB,KAAK;AAC7B;;AAGA,SAAgB,cAGd,SAAgD;CAChD,MAAM,EAAE,MAAM,YAAY;CAE1B,OAAO;EACL,YAAY;GACV,OAAO,KAAK,WAAW;EACzB;EACA,eAAe;GACb,OAAO,QAAQ,cAAc;EAC/B;CACF;AACF"}

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+import { ReactElement, ReactNode } from "react";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/index.d.ts
+type CreateAdapterOptions<TNode extends StandardSchemaV1<unknown, ReactNode>, TElement extends StandardSchemaV1<unknown, ReactElement>> = {
+  node: (check: ReactCheck<ReactNode>) => TNode;
+  element: (check: ReactCheck<ReactElement>) => TElement;
+};
+type ReactCheck<Value> = (value: unknown) => value is Value;
+/** Wrap React predicates in your schema library's native schema constructors. */
+declare function createAdapter<TNode extends StandardSchemaV1<unknown, ReactNode>, TElement extends StandardSchemaV1<unknown, ReactElement>>(options: CreateAdapterOptions<TNode, TElement>): {
+  reactNode(): TNode;
+  reactElement(): TElement;
+};
+//#endregion
+export { ReactCheck, createAdapter };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+import { ReactElement, ReactNode } from "react";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/index.d.ts
+type CreateAdapterOptions<TNode extends StandardSchemaV1<unknown, ReactNode>, TElement extends StandardSchemaV1<unknown, ReactElement>> = {
+  node: (check: ReactCheck<ReactNode>) => TNode;
+  element: (check: ReactCheck<ReactElement>) => TElement;
+};
+type ReactCheck<Value> = (value: unknown) => value is Value;
+/** Wrap React predicates in your schema library's native schema constructors. */
+declare function createAdapter<TNode extends StandardSchemaV1<unknown, ReactNode>, TElement extends StandardSchemaV1<unknown, ReactElement>>(options: CreateAdapterOptions<TNode, TElement>): {
+  reactNode(): TNode;
+  reactElement(): TElement;
+};
+//#endregion
+export { ReactCheck, createAdapter };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,56 @@
+import { isValidElement, version } from "react";
+//#region src/react-node.ts
+/** Check node containers without invoking components or awaiting promises. */
+function createReactNodeCheck(isValidElement, version) {
+	const supportsAsyncNodes = Number.parseInt(version, 10) >= 19;
+	function checkReactNode(value, ancestors) {
+		if (value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
+		if (typeof value === "bigint") return supportsAsyncNodes;
+		if (isValidElement(value)) return true;
+		if (typeof value !== "object") return false;
+		if ("$$typeof" in value && value.$$typeof === Symbol.for("react.portal")) return true;
+		if (supportsAsyncNodes && "then" in value && typeof value.then === "function") return true;
+		if (!(Symbol.iterator in value) || typeof value[Symbol.iterator] !== "function" || ancestors.has(value)) return false;
+		const iterator = value[Symbol.iterator]();
+		if (iterator === value) return false;
+		ancestors.add(value);
+		try {
+			let step = iterator.next();
+			while (!step.done) {
+				if (!checkReactNode(step.value, ancestors)) return false;
+				step = iterator.next();
+			}
+			return true;
+		} finally {
+			ancestors.delete(value);
+		}
+	}
+	return function isReactNode(value) {
+		return checkReactNode(value, /* @__PURE__ */ new Set());
+	};
+}
+//#endregion
+//#region src/index.ts
+const allowsReactNode = createReactNodeCheck(isValidElement, version);
+function isReactNode(value) {
+	return allowsReactNode(value);
+}
+function isReactElement(value) {
+	return isValidElement(value);
+}
+/** Wrap React predicates in your schema library's native schema constructors. */
+function createAdapter(options) {
+	const { node, element } = options;
+	return {
+		reactNode() {
+			return node(isReactNode);
+		},
+		reactElement() {
+			return element(isReactElement);
+		}
+	};
+}
+//#endregion
+export { createAdapter };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/react-node.ts","../src/index.ts"],"sourcesContent":["/** Check node containers without invoking components or awaiting promises. */\nexport function createReactNodeCheck(isValidElement: (value: unknown) => boolean, version: string) {\n  const supportsAsyncNodes = Number.parseInt(version, 10) >= 19;\n\n  function checkReactNode(value: unknown, ancestors: Set<object>): boolean {\n    if (value == null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return true;\n    if (typeof value === 'bigint') return supportsAsyncNodes;\n    if (isValidElement(value)) return true;\n    if (typeof value !== 'object') return false;\n    if ('$$typeof' in value && value.$$typeof === Symbol.for('react.portal')) return true;\n    if (supportsAsyncNodes && 'then' in value && typeof value.then === 'function') return true;\n    if (!(Symbol.iterator in value) || typeof value[Symbol.iterator] !== 'function' || ancestors.has(value)) return false;\n\n    const iterator = (value as Iterable<unknown>)[Symbol.iterator]();\n    // Consuming a one-shot iterator here would leave React with no children.\n    if ((iterator as unknown) === value) return false;\n\n    ancestors.add(value);\n    try {\n      let step = iterator.next();\n      while (!step.done) {\n        if (!checkReactNode(step.value, ancestors)) return false;\n        step = iterator.next();\n      }\n      return true;\n    } finally {\n      ancestors.delete(value);\n    }\n  }\n\n  return function isReactNode(value: unknown) {\n    return checkReactNode(value, new Set<object>());\n  };\n}\n","import {\n  isValidElement,\n  version,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { createReactNodeCheck } from './react-node';\n\ntype CreateAdapterOptions<\n  TNode extends StandardSchemaV1<unknown, ReactNode>,\n  TElement extends StandardSchemaV1<unknown, ReactElement>,\n> = {\n  node: (check: ReactCheck<ReactNode>) => TNode;\n  element: (check: ReactCheck<ReactElement>) => TElement;\n};\n\nconst allowsReactNode = createReactNodeCheck(isValidElement, version);\n\nexport type ReactCheck<Value> = (value: unknown) => value is Value;\n\nfunction isReactNode(value: unknown): value is ReactNode {\n  return allowsReactNode(value);\n}\n\nfunction isReactElement(value: unknown): value is ReactElement {\n  return isValidElement(value);\n}\n\n/** Wrap React predicates in your schema library's native schema constructors. */\nexport function createAdapter<\n  TNode extends StandardSchemaV1<unknown, ReactNode>,\n  TElement extends StandardSchemaV1<unknown, ReactElement>,\n>(options: CreateAdapterOptions<TNode, TElement>) {\n  const { node, element } = options;\n\n  return {\n    reactNode() {\n      return node(isReactNode);\n    },\n    reactElement() {\n      return element(isReactElement);\n    },\n  };\n}\n"],"mappings":";;;AACA,SAAgB,qBAAqB,gBAA6C,SAAiB;CACjG,MAAM,qBAAqB,OAAO,SAAS,SAAS,EAAE,KAAK;CAE3D,SAAS,eAAe,OAAgB,WAAiC;EACvE,IAAI,SAAS,QAAQ,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO;EAClH,IAAI,OAAO,UAAU,UAAU,OAAO;EACtC,IAAI,eAAe,KAAK,GAAG,OAAO;EAClC,IAAI,OAAO,UAAU,UAAU,OAAO;EACtC,IAAI,cAAc,SAAS,MAAM,aAAa,OAAO,IAAI,cAAc,GAAG,OAAO;EACjF,IAAI,sBAAsB,UAAU,SAAS,OAAO,MAAM,SAAS,YAAY,OAAO;EACtF,IAAI,EAAE,OAAO,YAAY,UAAU,OAAO,MAAM,OAAO,cAAc,cAAc,UAAU,IAAI,KAAK,GAAG,OAAO;EAEhH,MAAM,WAAY,MAA4B,OAAO,UAAU;EAE/D,IAAK,aAAyB,OAAO,OAAO;EAE5C,UAAU,IAAI,KAAK;EACnB,IAAI;GACF,IAAI,OAAO,SAAS,KAAK;GACzB,OAAO,CAAC,KAAK,MAAM;IACjB,IAAI,CAAC,eAAe,KAAK,OAAO,SAAS,GAAG,OAAO;IACnD,OAAO,SAAS,KAAK;GACvB;GACA,OAAO;EACT,UAAU;GACR,UAAU,OAAO,KAAK;EACxB;CACF;CAEA,OAAO,SAAS,YAAY,OAAgB;EAC1C,OAAO,eAAe,uBAAO,IAAI,IAAY,CAAC;CAChD;AACF;;;AChBA,MAAM,kBAAkB,qBAAqB,gBAAgB,OAAO;AAIpE,SAAS,YAAY,OAAoC;CACvD,OAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,eAAe,OAAuC;CAC7D,OAAO,eAAe,KAAK;AAC7B;;AAGA,SAAgB,cAGd,SAAgD;CAChD,MAAM,EAAE,MAAM,YAAY;CAE1B,OAAO;EACL,YAAY;GACV,OAAO,KAAK,WAAW;EACzB;EACA,eAAe;GACb,OAAO,QAAQ,cAAc;EAC/B;CACF;AACF"}

package/package.json

@@ -1,21 +1,52 @@
-{
-  "name": "@jfdevelops/react-layout-adapters",
-  "version": "0.0.0-stub.0",
-  "description": "Temporary placeholder for the upcoming @jfdevelops/react-layout-adapters package.",
-  "type": "module",
-  "main": "./index.js",
-  "files": [
-    "index.js",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/jfdevelops/react-layout.git",
-    "directory": "packages/adapters"
-  },
-  "publishConfig": {
-    "access": "public",
-    "tag": "stub",
-    "registry": "https://registry.npmjs.org"
-  }
-}
+{
+  "name": "@jfdevelops/react-layout-adapters",
+  "version": "0.1.0",
+  "description": "Schema-library independent React adapter factory for React Layout.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jfdevelops/react-layout.git",
+    "directory": "packages/adapters"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "react": "18.3.1",
+    "@types/react": "18.3.28",
+    "tsdown": "0.22.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.5",
+    "@types/node": "24.10.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/index.js

@@ -1 +0,0 @@
-throw new Error("@jfdevelops/react-layout-adapters is a placeholder package. The implementation has not been released yet.");