@mindees/core 0.1.0 → 0.2.0

package/README.md

@@ -13,17 +13,12 @@ frameworks), written in strict TypeScript.
 
 ## Install
 
-> ⚠️ **Not published to npm yet.** `@mindees/core` is pre-1.0 and not on the npm
-> registry. The command below is what you'll use **once it's published** (Phase
-> 12). For now, work with it from the monorepo via the
-> [contributor quick-start](../../README.md#-quickstart-contributors):
-> `corepack enable && pnpm install && pnpm verify`.
-
 ```bash
-# coming soon (not yet published):
 pnpm add @mindees/core
 ```
 
+> 🧪 APIs are experimental (pre-1.0) and may change before `1.0`.
+
 ## Quick start
 
 ```ts

package/dist/index.d.ts

@@ -10,7 +10,7 @@ import { ThreadPool, WorkerLike, WorkerPoolOptions, createInlineThreadPool, crea
 /** The npm package name. */
 declare const name = "@mindees/core";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.1.0";
+declare const VERSION = "0.2.0";
 /**
  * Current maturity of this package. See the repository `STATUS.md`.
  *

package/dist/index.js

@@ -8,7 +8,7 @@ import { createInlineThreadPool, createNativeThreadPool, createWorkerPool } from
 /** The npm package name. */
 const name = "@mindees/core";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.1.0";
+const VERSION = "0.2.0";
 /**
 * Current maturity of this package. See the repository `STATUS.md`.
 *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from './types'\n\n/**\n * Component model: a renderer-agnostic element tree plus selector-based,\n * re-render-isolated context. (Phase 2)\n */\nexport {\n  type Component,\n  type Context,\n  type ContextProvider,\n  createContext,\n  createElement,\n  createProvider,\n  ELEMENT_TYPE,\n  type ElementType,\n  Fragment,\n  hasOwner,\n  isElement,\n  type MindeesElement,\n  type MindeesNode,\n  renderComponent,\n  type SelectorEquals,\n} from './component'\nexport { NotImplementedError } from './errors'\nexport { notImplemented } from './not-implemented'\n/**\n * Fine-grained reactivity: signals, computed values, effects, batching, and\n * disposal scopes. This is the reactive core of MindeesNative.\n */\nexport {\n  type Accessor,\n  batch,\n  type ComputedOptions,\n  computed,\n  createRoot,\n  type EqualsFn,\n  effect,\n  getOwner,\n  type Memo,\n  memo,\n  type Owner,\n  onCleanup,\n  runWithOwner,\n  type Signal,\n  type SignalOptions,\n  signal,\n  untrack,\n} from './reactive'\n/**\n * Priority scheduler: two-lane (sync/normal), microtask-batched, with\n * cancellable and dedupable tasks. (Phase 2)\n */\nexport {\n  createScheduler,\n  type Priority,\n  type ScheduledTask,\n  type ScheduleOptions,\n  Scheduler,\n  type SchedulerOptions,\n  type Task,\n} from './scheduler'\n/**\n * Threading abstraction: a {@link ThreadPool} contract with a working Web Worker\n * backend and an inline fallback. Native multi-threading is a research track. (Phase 2)\n */\nexport {\n  createInlineThreadPool,\n  createNativeThreadPool,\n  createWorkerPool,\n  type ThreadPool,\n  type WorkerLike,\n  type WorkerPoolOptions,\n} from './threading'\nexport type { Maturity, PackageInfo } from './types'\n\n/** The npm package name. */\nexport const name = '@mindees/core'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.1.0'\n\n/**\n * Current maturity of this package. See the repository `STATUS.md`.\n *\n * The reactivity layer (signals/computed/effect/batch), the component model with\n * selector-isolated context, the priority scheduler, and the thread-pool\n * abstraction (Web Worker + inline) are all implemented and tested. Native\n * multi-threading remains a research track (throws `NotImplementedError`).\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n"],"mappings":";;;;;;;;AA4EA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;;;AAUvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from './types'\n\n/**\n * Component model: a renderer-agnostic element tree plus selector-based,\n * re-render-isolated context. (Phase 2)\n */\nexport {\n  type Component,\n  type Context,\n  type ContextProvider,\n  createContext,\n  createElement,\n  createProvider,\n  ELEMENT_TYPE,\n  type ElementType,\n  Fragment,\n  hasOwner,\n  isElement,\n  type MindeesElement,\n  type MindeesNode,\n  renderComponent,\n  type SelectorEquals,\n} from './component'\nexport { NotImplementedError } from './errors'\nexport { notImplemented } from './not-implemented'\n/**\n * Fine-grained reactivity: signals, computed values, effects, batching, and\n * disposal scopes. This is the reactive core of MindeesNative.\n */\nexport {\n  type Accessor,\n  batch,\n  type ComputedOptions,\n  computed,\n  createRoot,\n  type EqualsFn,\n  effect,\n  getOwner,\n  type Memo,\n  memo,\n  type Owner,\n  onCleanup,\n  runWithOwner,\n  type Signal,\n  type SignalOptions,\n  signal,\n  untrack,\n} from './reactive'\n/**\n * Priority scheduler: two-lane (sync/normal), microtask-batched, with\n * cancellable and dedupable tasks. (Phase 2)\n */\nexport {\n  createScheduler,\n  type Priority,\n  type ScheduledTask,\n  type ScheduleOptions,\n  Scheduler,\n  type SchedulerOptions,\n  type Task,\n} from './scheduler'\n/**\n * Threading abstraction: a {@link ThreadPool} contract with a working Web Worker\n * backend and an inline fallback. Native multi-threading is a research track. (Phase 2)\n */\nexport {\n  createInlineThreadPool,\n  createNativeThreadPool,\n  createWorkerPool,\n  type ThreadPool,\n  type WorkerLike,\n  type WorkerPoolOptions,\n} from './threading'\nexport type { Maturity, PackageInfo } from './types'\n\n/** The npm package name. */\nexport const name = '@mindees/core'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.2.0'\n\n/**\n * Current maturity of this package. See the repository `STATUS.md`.\n *\n * The reactivity layer (signals/computed/effect/batch), the component model with\n * selector-isolated context, the priority scheduler, and the thread-pool\n * abstraction (Web Worker + inline) are all implemented and tested. Native\n * multi-threading remains a research track (throws `NotImplementedError`).\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n"],"mappings":";;;;;;;;AA4EA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;;;AAUvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,11 @@
+import { Fragment, MindeesElement, MindeesNode } from "./component/component.js";
+import { JSX } from "./jsx-runtime.js";
+
+//#region src/jsx-dev-runtime.d.ts
+/** Dev JSX factory; the trailing debug args (`isStaticChildren`, `source`, `self`) are ignored. */
+declare function jsxDEV(type: string | ((props: never) => MindeesNode) | symbol, props: (Record<string, unknown> & {
+  children?: MindeesNode;
+}) | null | undefined, key?: string | number): MindeesElement;
+//#endregion
+export { Fragment, type JSX, jsxDEV };
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","names":[],"sources":["../src/jsx-dev-runtime.ts"],"mappings":";;;;;iBAgBgB,MAAA,CACd,IAAA,aAAiB,KAAA,YAAiB,WAAA,YAClC,KAAA,GAAQ,MAAA;EAA4B,QAAA,GAAW,WAAA;AAAA,uBAC/C,GAAA,qBACC,cAAA"}

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,11 @@
+import { Fragment } from "./component/component.js";
+import { jsx } from "./jsx-runtime.js";
+//#region src/jsx-dev-runtime.ts
+/** Dev JSX factory; the trailing debug args (`isStaticChildren`, `source`, `self`) are ignored. */
+function jsxDEV(type, props, key) {
+	return jsx(type, props, key);
+}
+//#endregion
+export { Fragment, jsxDEV };
+
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","names":[],"sources":["../src/jsx-dev-runtime.ts"],"sourcesContent":["/**\n * Automatic JSX **dev** runtime — the target of TypeScript's `react-jsxdev` transform\n * (used by dev/HMR builds). It carries the same `jsxImportSource: \"@mindees/core\"`\n * setup as {@link import('./jsx-runtime')}; the dev factory receives extra debug\n * arguments (source location, self), which we ignore and delegate to the same impl.\n *\n * @module\n */\n\nimport type { MindeesElement, MindeesNode } from './component'\nimport { jsx } from './jsx-runtime'\n\nexport { Fragment } from './component'\nexport type { JSX } from './jsx-runtime'\n\n/** Dev JSX factory; the trailing debug args (`isStaticChildren`, `source`, `self`) are ignored. */\nexport function jsxDEV(\n  type: string | ((props: never) => MindeesNode) | symbol,\n  props: (Record<string, unknown> & { children?: MindeesNode }) | null | undefined,\n  key?: string | number,\n): MindeesElement {\n  return jsx(type, props, key)\n}\n"],"mappings":";;;;AAgBA,SAAgB,OACd,MACA,OACA,KACgB;CAChB,OAAO,IAAI,MAAM,OAAO,GAAG;AAC7B"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,35 @@
+import { Fragment, MindeesElement, MindeesNode } from "./component/component.js";
+
+//#region src/jsx-runtime.d.ts
+/** Props as the automatic runtime delivers them: regular props plus `children`. */
+type JsxProps = (Record<string, unknown> & {
+  children?: MindeesNode;
+}) | null | undefined;
+declare function jsxImpl(type: string | ((props: never) => MindeesNode) | symbol, props: JsxProps, key?: string | number): MindeesElement;
+/** JSX factory for an element with zero or one child (automatic runtime). */
+declare const jsx: typeof jsxImpl;
+/** JSX factory for an element with static multiple children (automatic runtime). */
+declare const jsxs: typeof jsxImpl;
+/**
+ * The JSX type environment TypeScript resolves from `jsxImportSource`. Host tags are
+ * intentionally permissive for v1 (any lowercase tag with arbitrary props); component
+ * elements are checked against their own props by TS. `Element`/`ElementType` tie JSX
+ * back to the MindeesNative node model.
+ */
+declare namespace JSX {
+  /** The type of a JSX expression. */
+  type Element = MindeesElement;
+  /** Valid JSX element tags: host strings or component functions. */
+  type ElementType = string | ((props: never) => MindeesNode);
+  /** Host intrinsic tags (`<view>`, `<text>`, …) — permissive prop bags for v1. */
+  interface IntrinsicElements {
+    [tag: string]: Record<string, unknown>;
+  }
+  /** Tells TS which prop carries children (so `<X>child</X>` type-checks). */
+  interface ElementChildrenAttribute {
+    children: Record<string, never>;
+  }
+}
+//#endregion
+export { Fragment, JSX, jsx, jsxs };
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","names":[],"sources":["../src/jsx-runtime.ts"],"mappings":";;;;KAwBK,QAAA,IAAY,MAAA;EAA4B,QAAA,GAAW,WAAW;AAAA;AAAA,iBAE1D,OAAA,CACP,IAAA,aAAiB,KAAA,YAAiB,WAAA,YAClC,KAAA,EAAO,QAAA,EACP,GAAA,qBACC,cAAA;;cAWU,GAAA,SAAG,OAAU;;cAEb,IAAA,SAAI,OAAU;AAF3B;;;;AAA0B;AAE1B;AAFA,kBAWiB,GAAA;;OAEH,OAAA,GAAU,cAAA;EAXG;EAAA,KAab,WAAA,cAAyB,KAAA,YAAiB,WAAA;EAJpC;EAAA,UAMD,iBAAA;IAAA,CACd,GAAA,WAAc,MAAA;EAAA;EAAA;EAAA,UAGA,wBAAA;IACf,QAAA,EAAU,MAAA;EAAA;AAAA"}

package/dist/jsx-runtime.js

@@ -0,0 +1,35 @@
+import { Fragment, createElement } from "./component/component.js";
+//#region src/jsx-runtime.ts
+/**
+* Automatic JSX runtime for MindeesNative — the target of TypeScript's `react-jsx`
+* transform (and the same transform in esbuild/oxc/rolldown bundlers).
+*
+* Set this in `tsconfig.json` and write `<View/>` with **no manual import**:
+*
+* ```jsonc
+* { "compilerOptions": { "jsx": "react-jsx", "jsxImportSource": "@mindees/core" } }
+* ```
+*
+* The compiler then injects `jsx`/`jsxs`/`Fragment` from here automatically. Both
+* delegate to {@link createElement}; the only wrinkle is that the automatic runtime
+* delivers children inside `props.children` (a single node, or an array for static
+* multi-children) — we hand them to `createElement` as positional children so arrays
+* never nest.
+*
+* @module
+*/
+function jsxImpl(type, props, key) {
+	const { children, ...rest } = props ?? {};
+	if (key !== void 0) rest.key = key;
+	const factory = type;
+	if (children === void 0) return createElement(factory, rest);
+	return Array.isArray(children) ? createElement(factory, rest, ...children) : createElement(factory, rest, children);
+}
+/** JSX factory for an element with zero or one child (automatic runtime). */
+const jsx = jsxImpl;
+/** JSX factory for an element with static multiple children (automatic runtime). */
+const jsxs = jsxImpl;
+//#endregion
+export { Fragment, jsx, jsxs };
+
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","names":[],"sources":["../src/jsx-runtime.ts"],"sourcesContent":["/**\n * Automatic JSX runtime for MindeesNative — the target of TypeScript's `react-jsx`\n * transform (and the same transform in esbuild/oxc/rolldown bundlers).\n *\n * Set this in `tsconfig.json` and write `<View/>` with **no manual import**:\n *\n * ```jsonc\n * { \"compilerOptions\": { \"jsx\": \"react-jsx\", \"jsxImportSource\": \"@mindees/core\" } }\n * ```\n *\n * The compiler then injects `jsx`/`jsxs`/`Fragment` from here automatically. Both\n * delegate to {@link createElement}; the only wrinkle is that the automatic runtime\n * delivers children inside `props.children` (a single node, or an array for static\n * multi-children) — we hand them to `createElement` as positional children so arrays\n * never nest.\n *\n * @module\n */\n\nimport { createElement, type MindeesElement, type MindeesNode } from './component'\n\nexport { Fragment } from './component'\n\n/** Props as the automatic runtime delivers them: regular props plus `children`. */\ntype JsxProps = (Record<string, unknown> & { children?: MindeesNode }) | null | undefined\n\nfunction jsxImpl(\n  type: string | ((props: never) => MindeesNode) | symbol,\n  props: JsxProps,\n  key?: string | number,\n): MindeesElement {\n  const { children, ...rest } = props ?? {}\n  if (key !== undefined) rest.key = key\n  const factory = type as Parameters<typeof createElement>[0]\n  if (children === undefined) return createElement(factory, rest)\n  return Array.isArray(children)\n    ? createElement(factory, rest, ...children)\n    : createElement(factory, rest, children)\n}\n\n/** JSX factory for an element with zero or one child (automatic runtime). */\nexport const jsx = jsxImpl\n/** JSX factory for an element with static multiple children (automatic runtime). */\nexport const jsxs = jsxImpl\n\n/**\n * The JSX type environment TypeScript resolves from `jsxImportSource`. Host tags are\n * intentionally permissive for v1 (any lowercase tag with arbitrary props); component\n * elements are checked against their own props by TS. `Element`/`ElementType` tie JSX\n * back to the MindeesNative node model.\n */\n// biome-ignore lint/style/noNamespace: TypeScript resolves JSX typings only from a `JSX` namespace.\nexport namespace JSX {\n  /** The type of a JSX expression. */\n  export type Element = MindeesElement\n  /** Valid JSX element tags: host strings or component functions. */\n  export type ElementType = string | ((props: never) => MindeesNode)\n  /** Host intrinsic tags (`<view>`, `<text>`, …) — permissive prop bags for v1. */\n  export interface IntrinsicElements {\n    [tag: string]: Record<string, unknown>\n  }\n  /** Tells TS which prop carries children (so `<X>child</X>` type-checks). */\n  export interface ElementChildrenAttribute {\n    children: Record<string, never>\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0BA,SAAS,QACP,MACA,OACA,KACgB;CAChB,MAAM,EAAE,UAAU,GAAG,SAAS,SAAS,CAAC;CACxC,IAAI,QAAQ,KAAA,GAAW,KAAK,MAAM;CAClC,MAAM,UAAU;CAChB,IAAI,aAAa,KAAA,GAAW,OAAO,cAAc,SAAS,IAAI;CAC9D,OAAO,MAAM,QAAQ,QAAQ,IACzB,cAAc,SAAS,MAAM,GAAG,QAAQ,IACxC,cAAc,SAAS,MAAM,QAAQ;AAC3C;;AAGA,MAAa,MAAM;;AAEnB,MAAa,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MindeesNative core — fine-grained reactivity (signals/computed/effect/batch), component model with selector-isolated context, priority scheduler, and a thread-pool abstraction (Web Worker + inline; native is a research track).",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -12,6 +12,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-dev-runtime.d.ts",
+      "import": "./dist/jsx-dev-runtime.js"
     }
   },
   "publishConfig": {