@octanejs/octane-is 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominic Gannaway
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE.upstream

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @octanejs/octane-is
+
+The `react-is` 19.2.7 predicates for Octane elements. Replace `react-is` imports
+with `@octanejs/octane-is` when porting source to Octane.
+
+This binding requires the coordinated Octane core release containing the
+behavioral-audit fixes, planned for **Octane 0.2.3**. Its predicates depend on that
+release's `StrictMode` export and owner-bound component-kind metadata. Release
+and install the binding together with that core version or a later compatible
+release. The repository's shared beta peer range is broader than this capability
+requirement; it does not establish compatibility with older core releases.
+
+Install it alongside the required Octane release:
+
+```sh
+npm install @octanejs/octane-is octane@^0.2.3
+pnpm add @octanejs/octane-is octane@^0.2.3
+```
+
+```ts
+import { createElement, Fragment, memo } from 'octane';
+import { isFragment, isMemo, typeOf } from '@octanejs/octane-is';
+
+isFragment(createElement(Fragment, null)); // true
+isMemo(createElement(memo(() => null), null)); // true
+```
+
+All 26 upstream exports are available. Kind labels use Octane symbols; React
+elements are not Octane elements. Component functions themselves are valid
+element types, while `isMemo` and `isLazy` inspect element descriptors, as in
+`react-is`. Inspection never renders components or starts lazy loaders.
+
+Octane has no Context.Consumer, forwardRef, Profiler, or SuspenseList. Their
+predicates return false and their exported kind labels are not valid element
+types. Refs are ordinary props; read context with `use` or `useContext`.
+StrictMode is the Octane pass-through wrapper and does not double invoke.
+`StrictMode` and `Suspense` exported here are classifier labels. Construct
+elements with the corresponding functions from `octane`; the labels themselves
+are not valid element types. The shared `Fragment` symbol is also Octane's
+fragment element type.
+
+See [UPSTREAM.md](./UPSTREAM.md) for the immutable source pin and test crosswalk.

package/UPSTREAM.md

@@ -0,0 +1,57 @@
+# Upstream boundary
+
+- Package: `react-is@19.2.7`.
+- Source: https://github.com/facebook/react/tree/6117d7cca4906492c51fe6a03381e35adfd86e7d/packages/react-is
+- Immutable commit: `6117d7cca4906492c51fe6a03381e35adfd86e7d`.
+- License: MIT. `LICENSE.upstream` retains the exact Meta notice and permission.
+- npm integrity: `sha512-kZFnouyVv7eP/Phmrlo9FK+zcAdriZJvzxXHF1Sl1P377WSGe2G/JxVolhTrB/jeV47lKImhNUsijjHAAbcl/A==`.
+
+`audit/upstream.lock.json` pins every pristine source and test blob. `src/ReactIs.ts`
+adapts `src/ReactIs.js`; `src/index.ts` mirrors `index.stable.js`. Runtime ownership
+is Octane's `$$kind`, callable context, memo marker and lazy marker. No React
+runtime dependency or React element branding ships.
+
+## Octane release requirement
+
+Publish this binding with the coordinated Octane core release containing the
+behavioral-audit fixes, planned for **0.2.3**. Earlier releases do not supply the
+required `StrictMode` export and owner-bound component-kind metadata. Validation
+uses the current workspace core containing those changes. The shared beta peer
+range is mandated by repository source and tarball validation; it is not a claim
+that earlier core releases implement these capabilities. Shipping this binding
+before the coordinated core release would expose an unresolved runtime dependency.
+
+## Source boundary
+
+The two authored TypeScript source modules adapt only the pinned `react-is`
+package's `src/ReactIs.js` and `index.stable.js`. The pinned npm artifact supplies
+the pristine runtime oracle. The copied upstream source, tests and npm artifact
+stay outside published files; their exact licenses and hashes are retained.
+
+The complete published surface is accounted for: `typeOf`, `isValidElementType`,
+`ContextConsumer`, `ContextProvider`, `Element`, `ForwardRef`, `Fragment`, `Lazy`,
+`Memo`, `Portal`, `Profiler`, `StrictMode`, `Suspense`, `SuspenseList`,
+`isContextConsumer`, `isContextProvider`, `isElement`, `isForwardRef`, `isFragment`,
+`isLazy`, `isMemo`, `isPortal`, `isProfiler`, `isStrictMode`, `isSuspense`, and
+`isSuspenseList`.
+
+Consumer, ForwardRef, Profiler and SuspenseList labels/predicates remain exported,
+but cannot identify a supported Octane kind: those predicates return false and
+their labels are not valid element types. Octane function refs need no forwarding
+wrapper. StrictMode identifies the pass-through wrapper without promising double
+invocation. React Server Component references and arbitrary `getModuleId` objects
+are not valid Octane types. These are deliberate differences, covered by tests.
+The exported StrictMode and Suspense symbols label the corresponding Octane
+wrapper functions; use those functions from `octane` to construct elements.
+Classifier symbols do not grant rendering support. Fragment is the shared
+exception: its symbol is also Octane's fragment element type.
+
+The pinned package ships no TypeScript declaration files or type tests. Strict
+authored/public/packed-source type consumers validate this binding's declarations.
+The pinned Flow implementation informs the authored signature crosswalk; no
+separate upstream TypeScript suite is invented. The full public type consumer
+asserts all 26 exports and rejects invalid calls and return assignments.
+The upstream runtime inventory has 14 cases; its experimental SuspenseList case
+is inapplicable to the pinned stable package. Supported cases run against the
+pinned original and the adapted Octane suite; unsupported kinds retain explicit
+negative controls. See the machine crosswalk in `audit/`.

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@octanejs/octane-is",
+  "version": "0.0.1",
+  "description": "Element-kind predicates for Octane, matching react-is 19.2.7's public surface.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.22.2"
+  },
+  "author": {
+    "name": "Dominic Gannaway",
+    "email": "dg@domgan.com"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/octanejs/octane.git",
+    "directory": "packages/octane-is"
+  },
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "UPSTREAM.md",
+    "LICENSE",
+    "LICENSE.upstream"
+  ],
+  "peerDependencies": {
+    "octane": "^0.1.51 || ^0.2.0"
+  },
+  "devDependencies": {
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "vitest": "^4.1.10",
+    "octane": "0.2.3"
+  },
+  "scripts": {
+    "test": "vitest run --root ../.. --project octane-is --project octane-is-pristine --project octane-is-differential --maxWorkers=2",
+    "upstream:verify": "node ../../scripts/react-parity/verify-provenance.mjs",
+    "upstream:test": "node ../../scripts/react-parity/run-pristine.mjs octane-is"
+  }
+}

package/src/ReactIs.ts

@@ -0,0 +1,97 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ * Adapted for Octane from react-is 19.2.7 under the MIT license.
+ * See LICENSE.upstream and UPSTREAM.md.
+ */
+import { Activity, StrictMode as OctaneStrictMode } from 'octane';
+import type { ElementDescriptor } from 'octane';
+
+export const ContextConsumer: symbol = Symbol.for('octane.consumer');
+export const ContextProvider: symbol = Symbol.for('octane.context');
+export const Element: symbol = Symbol.for('octane.element');
+export const ForwardRef: symbol = Symbol.for('octane.forward_ref');
+export const Fragment: symbol = Symbol.for('octane.Fragment');
+export const Lazy: symbol = Symbol.for('octane.lazy');
+export const Memo: symbol = Symbol.for('octane.memo');
+export const Portal: symbol = Symbol.for('octane.portal');
+export const Profiler: symbol = Symbol.for('octane.profiler');
+export const StrictMode: symbol = Symbol.for('octane.strict_mode');
+export const Suspense: symbol = Symbol.for('octane.suspense');
+export const SuspenseList: symbol = Symbol.for('octane.suspense_list');
+
+interface BrandedValue {
+	$$kind?: unknown;
+	type?: unknown;
+}
+interface ComponentMetadata extends Function {
+	$$kind?: unknown;
+	Provider?: unknown;
+	__memo?: unknown;
+	[key: symbol]: unknown;
+}
+
+/** Return an Octane kind label without executing a component or lazy loader. */
+export function typeOf(value: unknown): symbol | undefined {
+	if (typeof value !== 'object' || value === null) return undefined;
+	const descriptor = value as BrandedValue;
+	if (descriptor.$$kind === Portal) return Portal;
+	if (descriptor.$$kind !== Element) return undefined;
+	const type = descriptor.type;
+	if (type === Fragment) return Fragment;
+	if (type === OctaneStrictMode) return StrictMode;
+	if (typeof type === 'function') {
+		const component = type as ComponentMetadata;
+		if (component[Suspense] === true) return Suspense;
+		if (component.$$kind === ContextProvider && component.Provider === component)
+			return ContextProvider;
+		// Lazy may acquire memo bailout metadata after resolving a memo wrapper.
+		// Its public kind remains Lazy, and inspecting it never starts the load.
+		if (component[Lazy] === true) return Lazy;
+		if (component.__memo === true) return Memo;
+	}
+	return Element;
+}
+
+export function isValidElementType(type: unknown): boolean {
+	return (
+		typeof type === 'string' || typeof type === 'function' || type === Fragment || type === Activity
+	);
+}
+// OCTANE DIVERGENCE[unsupported-renderer-kinds][runtime:50faf032d93f99c2]
+// Unsupported renderer kinds remain negative feature probes.
+export function isContextConsumer(_value: unknown): boolean {
+	return false;
+}
+export function isContextProvider(value: unknown): boolean {
+	return typeOf(value) === ContextProvider;
+}
+export function isElement(value: unknown): value is ElementDescriptor<unknown> {
+	return typeof value === 'object' && value !== null && (value as BrandedValue).$$kind === Element;
+}
+export function isForwardRef(_value: unknown): boolean {
+	return false;
+}
+export function isFragment(value: unknown): boolean {
+	return typeOf(value) === Fragment;
+}
+export function isLazy(value: unknown): boolean {
+	return typeOf(value) === Lazy;
+}
+export function isMemo(value: unknown): boolean {
+	return typeOf(value) === Memo;
+}
+export function isPortal(value: unknown): boolean {
+	return typeOf(value) === Portal;
+}
+export function isProfiler(_value: unknown): boolean {
+	return false;
+}
+export function isStrictMode(value: unknown): boolean {
+	return typeOf(value) === StrictMode;
+}
+export function isSuspense(value: unknown): boolean {
+	return typeOf(value) === Suspense;
+}
+export function isSuspenseList(_value: unknown): boolean {
+	return false;
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+export {
+	isValidElementType,
+	typeOf,
+	ContextConsumer,
+	ContextProvider,
+	Element,
+	ForwardRef,
+	Fragment,
+	Lazy,
+	Memo,
+	Portal,
+	Profiler,
+	StrictMode,
+	Suspense,
+	SuspenseList,
+	isContextConsumer,
+	isContextProvider,
+	isElement,
+	isForwardRef,
+	isFragment,
+	isLazy,
+	isMemo,
+	isPortal,
+	isProfiler,
+	isStrictMode,
+	isSuspense,
+	isSuspenseList,
+} from './ReactIs.ts';