chore(api): Move runtime constant definitions from @commontools/api to @commontools/runner

Changed ID, ID_FIELD, TYPE, NAME, and UI from concrete exports to ambient declarations in @commontools/api, getting it closer to being a pure TypeScript interface package. The actual runtime values are now defined in @commontools/runner/src/builder/types.ts, where the runtime environment is created. Type compatibility is maintained by having the runner reference the API's declared types using typeof, ensuring both locations share the same TypeScript symbol types.

Non-pattern code like tests or Lit components should import the types from @commontools/runner instead of @commontools/api

Author: seefeldb

packages/api/index.ts

@@ -5,16 +5,16 @@
  * Workspace code should import these types via `@commontools/builder`.
  */
 
-export const ID: unique symbol = Symbol("ID, unique to the context");
-export const ID_FIELD: unique symbol = Symbol(
-  "ID_FIELD, name of sibling that contains id",
-);
+// Runtime constants - defined by @commontools/runner/src/builder/types.ts
+// These are ambient declarations since the actual values are provided by the runtime environment
+export declare const ID: unique symbol;
+export declare const ID_FIELD: unique symbol;
 
 // Should be Symbol("UI") or so, but this makes repeat() use these when
 // iterating over recipes.
-export const TYPE = "$TYPE";
-export const NAME = "$NAME";
-export const UI = "$UI";
+export declare const TYPE: "$TYPE";
+export declare const NAME: "$NAME";
+export declare const UI: "$UI";
 
 // ============================================================================
 // Cell Brand System

packages/html/test/render.test.ts

@@ -1,5 +1,5 @@
 import { beforeEach, describe, it } from "@std/testing/bdd";
-import { h, UI, VNode } from "@commontools/api";
+import { h, UI, VNode } from "@commontools/runner";
 import { render, renderImpl } from "../src/render.ts";
 import * as assert from "./assert.ts";
 import { serializableEvent } from "../src/render.ts";

packages/runner/src/builder/types.ts

@@ -14,6 +14,8 @@ import type {
   GenerateObjectFunction,
   GetRecipeEnvironmentFunction,
   HandlerFunction,
+  ID as IDSymbol,
+  ID_FIELD as IDFieldSymbol,
   IfElseFunction,
   JSONSchema,
   JSONSchemaObj,
@@ -36,29 +38,23 @@ import type {
   StrFunction,
   WishFunction,
 } from "@commontools/api";
-import {
-  h,
-  ID,
-  ID_FIELD,
-  NAME,
-  schema,
-  toSchema,
-  TYPE,
-  UI,
-} from "@commontools/api";
+import { h, schema, toSchema } from "@commontools/api";
 import { AuthSchema } from "./schema-lib.ts";
+
+// Define runtime constants here - actual runtime values
+export const ID: typeof IDSymbol = Symbol("ID, unique to the context") as any;
+export const ID_FIELD: typeof IDFieldSymbol = Symbol(
+  "ID_FIELD, name of sibling that contains id",
+) as any;
+
+// Should be Symbol("UI") or so, but this makes repeat() use these when
+// iterating over recipes.
+export const TYPE = "$TYPE";
+export const NAME = "$NAME";
+export const UI = "$UI";
+
 export { AuthSchema } from "./schema-lib.ts";
-export {
-  h,
-  ID,
-  ID_FIELD,
-  NAME,
-  type Schema,
-  schema,
-  toSchema,
-  TYPE,
-  UI,
-} from "@commontools/api";
+export { h, type Schema, schema, toSchema } from "@commontools/api";
 export type {
   AnyCell,
   Cell,

packages/ui/src/v2/components/ct-render/ct-render.ts

@@ -3,7 +3,7 @@ import { BaseElement } from "../../core/base-element.ts";
 import { render } from "@commontools/html";
 import type { Cell } from "@commontools/runner";
 import { getRecipeIdFromCharm } from "@commontools/charm";
-import { UI, type VNode } from "@commontools/api";
+import { UI, type VNode } from "@commontools/runner";
 
 // Set to true to enable debug logging
 const DEBUG_LOGGING = false;