@pibbl/core 0.0.1

package/dist/lib/element/children.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/element/children.ts"],
+  "sourcesContent": ["import { isPibblElement } from './create-element.js';\nimport { isFragmentElement } from './fragment.js';\nimport {\n  getElementPolicyDefinition,\n  getPolicyPreparationSource,\n  getElementSource,\n  setPolicyPreparationSource,\n} from './metadata.js';\nimport type {\n  PibblElement,\n  PibblNodeInput,\n  PibblTextInput,\n} from './types.js';\nimport { isSignal } from '../signals/graph.js';\n\ntype ChildReceiver = string | PibblElement<any>;\n\nconst REACT_ELEMENT_TYPE = Symbol.for('react.element');\nconst REACT_TRANSITIONAL_ELEMENT_TYPE = Symbol.for(\n  'react.transitional.element',\n);\n\n/** Rejects a directly supplied foreign JSX root before Pibbl acquires resources. */\nexport function assertCompatibleRootNode(node: unknown): void {\n  if (isSignal(node)) {\n    throw new Error(\n      'Pibbl root received a signal without a component receiver. ' +\n      'Place the signal under a component or read it explicitly.',\n    );\n  }\n  if (!node || typeof node !== 'object' || isPibblElement(node)) return;\n  if (isReactElement(node)) throw reactElementError('Pibbl root');\n  if (\n    !isPromiseLike(node) &&\n    !isAsyncIterable(node) &&\n    !Array.isArray(node) &&\n    !isIterable(node) &&\n    isForeignElementLike(node)\n  ) {\n    throw foreignElementError('Pibbl root');\n  }\n}\n\n/**\n * Materializes one receiver's recursive container input into direct elements.\n * Arrays and unkeyed Fragments are transparent; keyed Fragments remain entries.\n */\nexport function materializeContainerChildren(\n  node: PibblNodeInput,\n  receiver: ChildReceiver,\n  options: Readonly<{ validateKeys?: boolean }> = {},\n): readonly PibblElement<any>[] {\n  const elements: PibblElement<any>[] = [];\n  visitContainerNode(node, receiver, elements, [], false, true, new Set());\n  if (options.validateKeys !== false) assertUniqueKeys(elements, receiver);\n  return Object.freeze(elements);\n}\n\n/** Prepares a policy descriptor for APIs that receive one element directly. */\nexport function prepareElementPolicies(\n  element: PibblElement<any>,\n  receiver: string,\n): PibblElement<any> {\n  if (!getElementPolicyDefinition(element.type)) return element;\n  const [prepared] = materializeContainerChildren(element, receiver);\n  return prepared;\n}\n\n/** Materializes Text's recursive scalar content into one reusable string. */\nexport function materializeTextChildren(\n  node: PibblTextInput,\n  receiver: ChildReceiver,\n): string {\n  const parts: string[] = [];\n  visitTextNode(node, receiver, parts, true, new Set());\n  return parts.join('');\n}\n\nfunction visitContainerNode(\n  node: unknown,\n  receiver: ChildReceiver,\n  elements: PibblElement<any>[],\n  pendingPolicies: readonly PibblElement<any>[] = [],\n  preservePolicies = false,\n  allowSignals = true,\n  ancestors: Set<object>,\n): void {\n  if (\n    node === false ||\n    node === true ||\n    node === null ||\n    node === undefined ||\n    node === '' ||\n    Object.is(node, 0) ||\n    Object.is(node, -0)\n  ) {\n    return;\n  }\n\n  if (isSignal(node)) {\n    if (receiver === 'Pibbl root') {\n      throw new Error(\n        'Pibbl root received a signal without a component receiver. ' +\n        'Place the signal under a component or read it explicitly.',\n      );\n    }\n    if (!allowSignals) throw nestedSignalChild(receiver);\n    visitContainerNode(\n      node.get(),\n      receiver,\n      elements,\n      pendingPolicies,\n      preservePolicies,\n      false,\n      ancestors,\n    );\n    return;\n  }\n\n  if (isPibblElement(node)) {\n    const policy = getElementPolicyDefinition(node.type);\n    if (policy) {\n      if (preservePolicies) {\n        elements.push(node);\n        return;\n      }\n      const policyChildren = materializeUnpreparedPolicyChildren(\n        (node.props as { readonly children?: PibblNodeInput }).children,\n        node,\n        allowSignals,\n        ancestors,\n      );\n      if (policyChildren.length !== 1) {\n        throw new Error(\n          `${describeReceiver(node)} requires exactly one Pibbl element child ` +\n          `after empty values are removed; received ${policyChildren.length}.`,\n        );\n      }\n      visitContainerNode(\n        policyChildren[0],\n        node,\n        elements,\n        [...pendingPolicies, node],\n        preservePolicies,\n        allowSignals,\n        ancestors,\n      );\n      return;\n    }\n    if (isFragmentElement(node) && node.key === undefined) {\n      visitContainerNode(\n        node.props.children,\n        receiver,\n        elements,\n        pendingPolicies,\n        preservePolicies,\n        allowSignals,\n        ancestors,\n      );\n      return;\n    }\n    let prepared = node;\n    const preparationSource = getPolicyPreparationSource(node) ?? node;\n    for (const pendingPolicy of pendingPolicies) {\n      const definition = getElementPolicyDefinition(pendingPolicy.type);\n      if (!definition) {\n        throw new Error('Pibbl policy preparation metadata was lost.');\n      }\n      prepared = definition.prepare(pendingPolicy, prepared);\n    }\n    if (prepared !== node) {\n      setPolicyPreparationSource(prepared, preparationSource);\n    }\n    elements.push(prepared);\n    return;\n  }\n\n  if (typeof node === 'string') {\n    throw invalidChild(receiver, 'a non-empty string');\n  }\n  if (typeof node === 'number') {\n    throw invalidChild(receiver, 'a nonzero number');\n  }\n  if (typeof node === 'function') {\n    throw invalidChild(receiver, 'a function');\n  }\n  if (typeof node === 'symbol') {\n    throw invalidChild(receiver, 'a symbol');\n  }\n  if (typeof node !== 'object') {\n    throw invalidChild(receiver, `an unsupported ${typeof node} value`);\n  }\n\n  if (isReactElement(node)) {\n    throw reactElementError(receiver);\n  }\n  if (isPromiseLike(node)) {\n    throw invalidChild(receiver, 'a Promise');\n  }\n  if (isAsyncIterable(node)) {\n    throw invalidChild(receiver, 'an async iterable');\n  }\n  if (Array.isArray(node)) {\n    withAcyclicContainer(node, receiver, ancestors, () => {\n      for (const child of node) {\n        visitContainerNode(\n          child,\n          receiver,\n          elements,\n          pendingPolicies,\n          preservePolicies,\n          allowSignals,\n          ancestors,\n        );\n      }\n    });\n    return;\n  }\n  if (isIterable(node)) {\n    withAcyclicContainer(node, receiver, ancestors, () => {\n      for (const child of node) {\n        visitContainerNode(\n          child,\n          receiver,\n          elements,\n          pendingPolicies,\n          preservePolicies,\n          allowSignals,\n          ancestors,\n        );\n      }\n    });\n    return;\n  }\n  if (isForeignElementLike(node)) {\n    throw foreignElementError(receiver);\n  }\n\n  throw invalidChild(receiver, 'an unsupported object');\n}\n\nfunction materializeUnpreparedPolicyChildren(\n  node: PibblNodeInput,\n  receiver: PibblElement<any>,\n  allowSignals: boolean,\n  ancestors: Set<object>,\n): readonly PibblElement<any>[] {\n  const elements: PibblElement<any>[] = [];\n  visitContainerNode(\n    node,\n    receiver,\n    elements,\n    [],\n    true,\n    allowSignals,\n    ancestors,\n  );\n  assertUniqueKeys(elements, receiver);\n  return Object.freeze(elements);\n}\n\nfunction visitTextNode(\n  node: unknown,\n  receiver: ChildReceiver,\n  parts: string[],\n  allowSignals: boolean,\n  ancestors: Set<object>,\n): void {\n  if (\n    node === false ||\n    node === true ||\n    node === null ||\n    node === undefined\n  ) {\n    return;\n  }\n  if (isSignal(node)) {\n    if (!allowSignals) throw nestedSignalChild(receiver);\n    visitTextNode(node.get(), receiver, parts, false, ancestors);\n    return;\n  }\n  if (typeof node === 'string' || typeof node === 'number') {\n    parts.push(String(node));\n    return;\n  }\n  if (isPibblElement(node)) {\n    throw invalidChild(receiver, 'a Pibbl element inside textual content');\n  }\n  if (typeof node === 'function') {\n    throw invalidChild(receiver, 'a function');\n  }\n  if (typeof node === 'symbol') {\n    throw invalidChild(receiver, 'a symbol');\n  }\n  if (typeof node !== 'object') {\n    throw invalidChild(receiver, `an unsupported ${typeof node} value`);\n  }\n  if (isReactElement(node)) {\n    throw reactElementError(receiver);\n  }\n  if (isPromiseLike(node)) {\n    throw invalidChild(receiver, 'a Promise');\n  }\n  if (isAsyncIterable(node)) {\n    throw invalidChild(receiver, 'an async iterable');\n  }\n  if (Array.isArray(node)) {\n    withAcyclicContainer(node, receiver, ancestors, () => {\n      for (const child of node) {\n        visitTextNode(child, receiver, parts, allowSignals, ancestors);\n      }\n    });\n    return;\n  }\n  if (isIterable(node)) {\n    withAcyclicContainer(node, receiver, ancestors, () => {\n      for (const child of node) {\n        visitTextNode(child, receiver, parts, allowSignals, ancestors);\n      }\n    });\n    return;\n  }\n  if (isForeignElementLike(node)) {\n    throw foreignElementError(receiver);\n  }\n  throw invalidChild(receiver, 'an unsupported object');\n}\n\nfunction assertUniqueKeys(\n  elements: readonly PibblElement<any>[],\n  receiver: ChildReceiver,\n): void {\n  const keys = new Set<string>();\n  for (const element of elements) {\n    const key = element.key;\n    if (key === undefined) continue;\n    if (keys.has(key)) {\n      throw invalidChild(receiver, `duplicate Pibbl key \"${key}\"`);\n    }\n    keys.add(key);\n  }\n}\n\nfunction invalidChild(receiver: ChildReceiver, description: string): Error {\n  return new Error(\n    `${describeReceiver(receiver)} received ${description} as a Pibbl child.`,\n  );\n}\n\nfunction nestedSignalChild(receiver: ChildReceiver): Error {\n  return invalidChild(\n    receiver,\n    'a signal inside a signal-resolved child structure',\n  );\n}\n\nfunction withAcyclicContainer<T extends object>(\n  value: T,\n  receiver: ChildReceiver,\n  ancestors: Set<object>,\n  visit: () => void,\n): void {\n  if (ancestors.has(value)) {\n    throw invalidChild(receiver, 'a cyclic child structure');\n  }\n  ancestors.add(value);\n  try {\n    visit();\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\nfunction reactElementError(receiver: ChildReceiver): Error {\n  return new Error(\n    'Pibbl received a React element. This file is using the React JSX runtime.\\n' +\n    'Set jsxImportSource to \"@pibbl/core\" or add ' +\n    '/** @jsxImportSource @pibbl/core */.\\n' +\n    `Received by ${describeReceiver(receiver)}.`,\n  );\n}\n\nfunction foreignElementError(receiver: ChildReceiver): Error {\n  return new Error(\n    `${describeReceiver(receiver)} received an element-like object that was ` +\n    'not created by @pibbl/core as a Pibbl child.\\n' +\n    'Check this file\\'s JSX runtime and set jsxImportSource to \"@pibbl/core\".',\n  );\n}\n\nfunction describeReceiver(receiver: ChildReceiver): string {\n  if (typeof receiver === 'string') return receiver;\n  const name = receiver.type.name || 'Anonymous';\n  const source = getElementSource(receiver);\n  return source ?\n      `${name} at ${source.fileName}:${source.lineNumber}:${source.columnNumber}` :\n    name;\n}\n\nfunction isReactElement(value: object): boolean {\n  const brand = (value as { $$typeof?: unknown }).$$typeof;\n  return brand === REACT_ELEMENT_TYPE ||\n    brand === REACT_TRANSITIONAL_ELEMENT_TYPE;\n}\n\nfunction isForeignElementLike(value: object): boolean {\n  if (\n    !Object.prototype.hasOwnProperty.call(value, 'type') ||\n    !Object.prototype.hasOwnProperty.call(value, 'props')\n  ) {\n    return false;\n  }\n  try {\n    const type = (value as { type?: unknown }).type;\n    const props = (value as { props?: unknown }).props;\n    return (\n      (typeof type === 'function' ||\n        typeof type === 'string' ||\n        typeof type === 'symbol') &&\n      (props === null || typeof props === 'object')\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction isPromiseLike(value: object): boolean {\n  return typeof (value as { then?: unknown }).then === 'function';\n}\n\nfunction isAsyncIterable(value: object): boolean {\n  return typeof (value as { [Symbol.asyncIterator]?: unknown })[\n    Symbol.asyncIterator\n  ] === 'function';\n}\n\nfunction isIterable(value: object): value is Iterable<unknown> {\n  return typeof (value as { [Symbol.iterator]?: unknown })[\n    Symbol.iterator\n  ] === 'function';\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/element/create-element.d.ts

@@ -0,0 +1,34 @@
+import { type PibblElementSource } from './metadata.js';
+import type { PibblElement, PibblElementType, PibblKey } from './types.js';
+type UnionKeys<T> = T extends unknown ? keyof T : never;
+type ElementInput<P> = 0 extends (1 & P) ? P & {
+    key?: PibblKey;
+} : 'key' extends UnionKeys<P> ? never : P & {
+    key?: PibblKey;
+};
+type ElementInputOrNull<P> = [ElementInput<P>] extends [never] ? never : ElementInput<P> | null;
+type ChildrenForProps<P> = P extends unknown ? 'children' extends keyof P ? P['children'] : never : never;
+type MultipleChildren<C> = C extends unknown ? C extends readonly (infer Child)[] ? Child[] extends C ? [Child, Child, ...Child[]] : never : C extends Iterable<infer Child> ? Child[] extends C ? [Child, Child, ...Child[]] : never : never : never;
+type ChildrenArguments<P> = P extends unknown ? 'children' extends keyof P ? [] | [ChildrenForProps<P>] | MultipleChildren<ChildrenForProps<P>> : [
+] : never;
+/**
+ * Public constructor used by direct element authoring.
+ *
+ * @param type - Pibbl component or fragment to instantiate. See {@link PibblElementType}.
+ * @param props - Authored props, or null when allowed by the component's input type. See
+ * {@link ElementInputOrNull} .
+ * @param children - Child nodes supplied in source order. See {@link ChildrenArguments}.
+ * @returns A branded Pibbl element descriptor; rendering occurs when it is mounted. See
+ * {@link PibblElement} .
+ *
+ * @see {@link PibblElementType}
+ * @see {@link PibblElement}
+ */
+export declare function createElement<P>(type: PibblElementType<P>, props: ElementInputOrNull<P>, ...children: ChildrenArguments<P>): PibblElement<P>;
+/** @internal Shared construction path for direct and compiler element creation. */
+export declare function createPibblElement<P>(type: PibblElementType<P>, incomingProps: P | null, compilerKey: PibblKey | null | undefined, source: PibblElementSource | undefined): PibblElement<P>;
+/** @internal */
+export declare function isPibblElement(value: unknown): value is PibblElement<any>;
+/** @internal Creates another immutable descriptor while retaining private annotations. */
+export declare function clonePibblElement<P>(element: PibblElement<P>): PibblElement<P>;
+export {};

package/dist/lib/element/create-element.js

@@ -0,0 +1,75 @@
+import {
+  copyElementCloneMetadata,
+  getElementMetadata,
+  getPrimitiveDefinition,
+  setElementMetadata
+} from "./metadata.js";
+import { isDevelopment } from "../development.js";
+import { capturePlacementHandoff } from "../style/positioning.js";
+const PIBBL_ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("@pibbl/core.element");
+function createElement(type, props, ...children) {
+  const withChildren = children.length === 0 ? props : {
+    ...props,
+    children: children.length === 1 ? children[0] : children
+  };
+  return createPibblElement(type, withChildren, void 0, void 0);
+}
+function createPibblElement(type, incomingProps, compilerKey, source) {
+  const rawProps = incomingProps ?? {};
+  const defensiveKey = Object.prototype.hasOwnProperty.call(rawProps, "key") ? rawProps.key : void 0;
+  const rawKey = compilerKey === void 0 ? defensiveKey : compilerKey;
+  const { key: _key, ...props } = rawProps;
+  const primitiveProgramProps = getPrimitiveDefinition(type) === void 0 ? void 0 : preparePrimitiveProgramProps(props);
+  const normalizedKey = rawKey === void 0 || rawKey === null ? void 0 : String(rawKey);
+  return finalizePibblElement(type, props, normalizedKey, {
+    source,
+    primitiveProgramProps
+  });
+}
+function preparePrimitiveProgramProps(props) {
+  if (!Object.prototype.hasOwnProperty.call(props, "style")) return props;
+  const { style: _style, ...programProps } = props;
+  return programProps;
+}
+function finalizePibblElement(type, props, key, metadata) {
+  const element = key === void 0 ? { type, props } : { type, props, key };
+  setElementMetadata(element, metadata);
+  Object.defineProperties(element, {
+    $$typeof: {
+      configurable: false,
+      enumerable: false,
+      value: PIBBL_ELEMENT_TYPE,
+      writable: false
+    }
+  });
+  capturePlacementHandoff(
+    element,
+    props.style
+  );
+  if (isDevelopment) {
+    Object.freeze(props);
+    Object.freeze(element);
+  }
+  return element;
+}
+function isPibblElement(value) {
+  return !!value && typeof value === "object" && value.$$typeof === PIBBL_ELEMENT_TYPE;
+}
+function clonePibblElement(element) {
+  const metadata = getElementMetadata(element);
+  const clone = finalizePibblElement(
+    element.type,
+    element.props,
+    element.key,
+    metadata ? { ...metadata } : {}
+  );
+  copyElementCloneMetadata(element, clone);
+  return clone;
+}
+export {
+  clonePibblElement,
+  createElement,
+  createPibblElement,
+  isPibblElement
+};
+//# sourceMappingURL=create-element.js.map

package/dist/lib/element/create-element.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/element/create-element.ts"],
+  "sourcesContent": ["import {\n  copyElementCloneMetadata,\n  getElementMetadata,\n  getPrimitiveDefinition,\n  setElementMetadata,\n  type PibblElementSource,\n} from './metadata.js';\nimport type {\n  PibblElement,\n  PibblElementType,\n  PibblKey,\n} from './types.js';\nimport { isDevelopment } from '../development.js';\nimport { capturePlacementHandoff } from '../style/positioning.js';\n\nconst PIBBL_ELEMENT_TYPE = Symbol.for('@pibbl/core.element');\n\ntype ElementProps = Record<PropertyKey, unknown>;\ntype UnionKeys<T> = T extends unknown ? keyof T : never;\ntype ElementInput<P> = 0 extends (1 & P) ?\n  P & { key?: PibblKey } :\n  'key' extends UnionKeys<P> ? never :\n  P & { key?: PibblKey };\ntype ElementInputOrNull<P> = [ElementInput<P>] extends [never] ?\n  never :\n  ElementInput<P> | null;\ntype ChildrenForProps<P> = P extends unknown ?\n  'children' extends keyof P ? P['children'] : never :\n  never;\ntype MultipleChildren<C> = C extends unknown ?\n  C extends readonly (infer Child)[] ?\n    Child[] extends C ? [Child, Child, ...Child[]] : never :\n  C extends Iterable<infer Child> ?\n    Child[] extends C ? [Child, Child, ...Child[]] : never :\n  never :\n  never;\ntype ChildrenArguments<P> = P extends unknown ?\n  'children' extends keyof P ?\n    | []\n    | [ChildrenForProps<P>]\n    | MultipleChildren<ChildrenForProps<P>> :\n  [] :\n  never;\n\n/**\n * Public constructor used by direct element authoring.\n *\n * @param type - Pibbl component or fragment to instantiate. See {@link PibblElementType}.\n * @param props - Authored props, or null when allowed by the component's input type. See\n * {@link ElementInputOrNull} .\n * @param children - Child nodes supplied in source order. See {@link ChildrenArguments}.\n * @returns A branded Pibbl element descriptor; rendering occurs when it is mounted. See\n * {@link PibblElement} .\n *\n * @see {@link PibblElementType}\n * @see {@link PibblElement}\n */\nexport function createElement<P>(\n  type: PibblElementType<P>,\n  props: ElementInputOrNull<P>,\n  ...children: ChildrenArguments<P>\n): PibblElement<P> {\n  const withChildren = children.length === 0 ? props : {\n    ...(props as object | null),\n    children: children.length === 1 ? children[0] : children,\n  };\n  return createPibblElement(type, withChildren as P | null, undefined, undefined);\n}\n\n/** @internal Shared construction path for direct and compiler element creation. */\nexport function createPibblElement<P>(\n  type: PibblElementType<P>,\n  incomingProps: P | null,\n  compilerKey: PibblKey | null | undefined,\n  source: PibblElementSource | undefined,\n): PibblElement<P> {\n  const rawProps = (incomingProps ?? {}) as ElementProps;\n  const defensiveKey = Object.prototype.hasOwnProperty.call(rawProps, 'key') ?\n    rawProps.key :\n    undefined;\n  const rawKey = compilerKey === undefined ? defensiveKey : compilerKey;\n  const { key: _key, ...props } = rawProps;\n  const primitiveProgramProps = getPrimitiveDefinition(type) === undefined ?\n    undefined :\n    preparePrimitiveProgramProps(props);\n  const normalizedKey = rawKey === undefined || rawKey === null ?\n    undefined :\n    String(rawKey);\n  return finalizePibblElement(type, props as P, normalizedKey, {\n    source,\n    primitiveProgramProps,\n  });\n}\n\nfunction preparePrimitiveProgramProps(\n  props: Readonly<ElementProps>,\n): Readonly<ElementProps> {\n  if (!Object.prototype.hasOwnProperty.call(props, 'style')) return props;\n  const { style: _style, ...programProps } = props;\n  return programProps;\n}\n\nfunction finalizePibblElement<P>(\n  type: PibblElementType<P>,\n  props: P,\n  key: string | undefined,\n  metadata: Parameters<typeof setElementMetadata>[1],\n): PibblElement<P> {\n  const element = (key === undefined ?\n    { type, props } :\n    { type, props, key }) as PibblElement<P>;\n\n  setElementMetadata(element, metadata);\n  Object.defineProperties(element, {\n    $$typeof: {\n      configurable: false,\n      enumerable: false,\n      value: PIBBL_ELEMENT_TYPE,\n      writable: false,\n    },\n  });\n\n  capturePlacementHandoff(\n    element,\n    (props as { readonly style?: unknown }).style,\n  );\n  if (isDevelopment) {\n    Object.freeze(props);\n    Object.freeze(element);\n  }\n  return element;\n}\n\n/** @internal */\nexport function isPibblElement(value: unknown): value is PibblElement<any> {\n  return !!value &&\n    typeof value === 'object' &&\n    (value as { $$typeof?: unknown }).$$typeof === PIBBL_ELEMENT_TYPE;\n}\n\n/** @internal Creates another immutable descriptor while retaining private annotations. */\nexport function clonePibblElement<P>(element: PibblElement<P>): PibblElement<P> {\n  const metadata = getElementMetadata(element);\n  const clone = finalizePibblElement(\n    element.type,\n    element.props,\n    element.key,\n    metadata ? { ...metadata } : {},\n  );\n  copyElementCloneMetadata(element, clone);\n  return clone;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAMP,SAAS,qBAAqB;AAC9B,SAAS,+BAA+B;AAExC,MAAM,qBAAqB,uBAAO,IAAI,qBAAqB;AA0CpD,SAAS,cACd,MACA,UACG,UACc;AACjB,QAAM,eAAe,SAAS,WAAW,IAAI,QAAQ;AAAA,IACnD,GAAI;AAAA,IACJ,UAAU,SAAS,WAAW,IAAI,SAAS,CAAC,IAAI;AAAA,EAClD;AACA,SAAO,mBAAmB,MAAM,cAA0B,QAAW,MAAS;AAChF;AAGO,SAAS,mBACd,MACA,eACA,aACA,QACiB;AACjB,QAAM,WAAY,iBAAiB,CAAC;AACpC,QAAM,eAAe,OAAO,UAAU,eAAe,KAAK,UAAU,KAAK,IACvE,SAAS,MACT;AACF,QAAM,SAAS,gBAAgB,SAAY,eAAe;AAC1D,QAAM,EAAE,KAAK,MAAM,GAAG,MAAM,IAAI;AAChC,QAAM,wBAAwB,uBAAuB,IAAI,MAAM,SAC7D,SACA,6BAA6B,KAAK;AACpC,QAAM,gBAAgB,WAAW,UAAa,WAAW,OACvD,SACA,OAAO,MAAM;AACf,SAAO,qBAAqB,MAAM,OAAY,eAAe;AAAA,IAC3D;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,SAAS,6BACP,OACwB;AACxB,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,OAAO,OAAO,EAAG,QAAO;AAClE,QAAM,EAAE,OAAO,QAAQ,GAAG,aAAa,IAAI;AAC3C,SAAO;AACT;AAEA,SAAS,qBACP,MACA,OACA,KACA,UACiB;AACjB,QAAM,UAAW,QAAQ,SACvB,EAAE,MAAM,MAAM,IACd,EAAE,MAAM,OAAO,IAAI;AAErB,qBAAmB,SAAS,QAAQ;AACpC,SAAO,iBAAiB,SAAS;AAAA,IAC/B,UAAU;AAAA,MACR,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,EACF,CAAC;AAED;AAAA,IACE;AAAA,IACC,MAAuC;AAAA,EAC1C;AACA,MAAI,eAAe;AACjB,WAAO,OAAO,KAAK;AACnB,WAAO,OAAO,OAAO;AAAA,EACvB;AACA,SAAO;AACT;AAGO,SAAS,eAAe,OAA4C;AACzE,SAAO,CAAC,CAAC,SACP,OAAO,UAAU,YAChB,MAAiC,aAAa;AACnD;AAGO,SAAS,kBAAqB,SAA2C;AAC9E,QAAM,WAAW,mBAAmB,OAAO;AAC3C,QAAM,QAAQ;AAAA,IACZ,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,WAAW,EAAE,GAAG,SAAS,IAAI,CAAC;AAAA,EAChC;AACA,2BAAyB,SAAS,KAAK;AACvC,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/element/fragment.d.ts

@@ -0,0 +1,15 @@
+import type { PibblElement, PibblNodeInput } from './types.js';
+export interface FragmentProps {
+    children?: PibblNodeInput;
+}
+/**
+ * Compiler-visible fragment value. The renderer handles its descriptor directly.
+ *
+ * @param props - Children and optional fragment identity. See {@link FragmentProps}.
+ * @returns The fragment's children, preserving their order. See {@link PibblNodeInput}.
+ *
+ * @see {@link PibblNodeInput}
+ */
+export declare function Fragment(props: FragmentProps): PibblNodeInput;
+/** @internal */
+export declare function isFragmentElement(element: PibblElement<any>): element is PibblElement<FragmentProps>;

package/dist/lib/element/fragment.js

@@ -0,0 +1,11 @@
+function Fragment(props) {
+  return props.children;
+}
+function isFragmentElement(element) {
+  return element.type === Fragment;
+}
+export {
+  Fragment,
+  isFragmentElement
+};
+//# sourceMappingURL=fragment.js.map

package/dist/lib/element/fragment.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/element/fragment.ts"],
+  "sourcesContent": ["import type { PibblElement, PibblNodeInput } from './types.js';\n\nexport interface FragmentProps {\n  children?: PibblNodeInput;\n}\n\n/**\n * Compiler-visible fragment value. The renderer handles its descriptor directly.\n *\n * @param props - Children and optional fragment identity. See {@link FragmentProps}.\n * @returns The fragment's children, preserving their order. See {@link PibblNodeInput}.\n *\n * @see {@link PibblNodeInput}\n */\nexport function Fragment(props: FragmentProps): PibblNodeInput {\n  return props.children;\n}\n\n/** @internal */\nexport function isFragmentElement(\n  element: PibblElement<any>,\n): element is PibblElement<FragmentProps> {\n  return element.type === Fragment;\n}\n"],
+  "mappings": "AAcO,SAAS,SAAS,OAAsC;AAC7D,SAAO,MAAM;AACf;AAGO,SAAS,kBACd,SACwC;AACxC,SAAO,QAAQ,SAAS;AAC1B;",
+  "names": []
+}

package/dist/lib/element/jsx-runtime.d.ts

@@ -0,0 +1,48 @@
+export { Fragment } from './fragment.js';
+import type { PibblElementSource } from './metadata.js';
+import type { PibblElement, PibblElementType, PibblKey } from './types.js';
+/**
+ * @internal Automatic JSX production constructor.
+ *
+ * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.
+ * @param props - Compiler-generated props, including children.
+ * @param key - Optional reconciliation key supplied separately by the compiler. See {@link PibblKey}
+ * .
+ * @returns A branded Pibbl element descriptor. See {@link PibblElement}.
+ *
+ * @see {@link PibblElementType}
+ * @see {@link PibblKey}
+ * @see {@link PibblElement}
+ */
+export declare function jsx<P>(type: PibblElementType<P>, props: P, key?: PibblKey): PibblElement<P>;
+/**
+ * @internal Automatic JSX production constructor for static child lists.
+ *
+ * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.
+ * @param props - Compiler-generated props, including the static child list.
+ * @param key - Optional reconciliation key. See {@link PibblKey}.
+ * @returns A branded Pibbl element descriptor. See {@link PibblElement}.
+ *
+ * @see {@link PibblElementType}
+ * @see {@link PibblKey}
+ * @see {@link PibblElement}
+ */
+export declare const jsxs: typeof jsx;
+/**
+ * @internal Automatic JSX development constructor.
+ *
+ * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.
+ * @param props - Compiler-generated props, including children.
+ * @param key - Reconciliation key, if present. See {@link PibblKey}.
+ * @param _isStaticChildren - Compiler compatibility flag; not used by Pibbl.
+ * @param source - Development source location for diagnostics. See {@link PibblElementSource}.
+ * @param _self - Compiler compatibility receiver; not used by Pibbl.
+ * @returns A branded Pibbl element descriptor with development source metadata. See
+ * {@link PibblElement} .
+ *
+ * @see {@link PibblElementType}
+ * @see {@link PibblKey}
+ * @see {@link PibblElementSource}
+ * @see {@link PibblElement}
+ */
+export declare function jsxDEV<P>(type: PibblElementType<P>, props: P, key: PibblKey | undefined, _isStaticChildren: boolean, source: PibblElementSource | undefined, _self: unknown): PibblElement<P>;

package/dist/lib/element/jsx-runtime.js

@@ -0,0 +1,16 @@
+import { createPibblElement } from "./create-element.js";
+import { Fragment } from "./fragment.js";
+function jsx(type, props, key) {
+  return createPibblElement(type, props, key, void 0);
+}
+const jsxs = jsx;
+function jsxDEV(type, props, key, _isStaticChildren, source, _self) {
+  return createPibblElement(type, props, key, source);
+}
+export {
+  Fragment,
+  jsx,
+  jsxDEV,
+  jsxs
+};
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/lib/element/jsx-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/element/jsx-runtime.ts"],
+  "sourcesContent": ["import { createPibblElement } from './create-element.js';\nexport { Fragment } from './fragment.js';\nimport type { PibblElementSource } from './metadata.js';\nimport type {\n  PibblElement,\n  PibblElementType,\n  PibblKey,\n} from './types.js';\n\n/**\n * @internal Automatic JSX production constructor.\n *\n * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.\n * @param props - Compiler-generated props, including children.\n * @param key - Optional reconciliation key supplied separately by the compiler. See {@link PibblKey}\n * .\n * @returns A branded Pibbl element descriptor. See {@link PibblElement}.\n *\n * @see {@link PibblElementType}\n * @see {@link PibblKey}\n * @see {@link PibblElement}\n */\nexport function jsx<P>(\n  type: PibblElementType<P>,\n  props: P,\n  key?: PibblKey,\n): PibblElement<P> {\n  return createPibblElement(type, props, key, undefined);\n}\n\n/**\n * @internal Automatic JSX production constructor for static child lists.\n *\n * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.\n * @param props - Compiler-generated props, including the static child list.\n * @param key - Optional reconciliation key. See {@link PibblKey}.\n * @returns A branded Pibbl element descriptor. See {@link PibblElement}.\n *\n * @see {@link PibblElementType}\n * @see {@link PibblKey}\n * @see {@link PibblElement}\n */\nexport const jsxs = jsx;\n\n/**\n * @internal Automatic JSX development constructor.\n *\n * @param type - Pibbl component or fragment emitted by the JSX compiler. See {@link PibblElementType}.\n * @param props - Compiler-generated props, including children.\n * @param key - Reconciliation key, if present. See {@link PibblKey}.\n * @param _isStaticChildren - Compiler compatibility flag; not used by Pibbl.\n * @param source - Development source location for diagnostics. See {@link PibblElementSource}.\n * @param _self - Compiler compatibility receiver; not used by Pibbl.\n * @returns A branded Pibbl element descriptor with development source metadata. See\n * {@link PibblElement} .\n *\n * @see {@link PibblElementType}\n * @see {@link PibblKey}\n * @see {@link PibblElementSource}\n * @see {@link PibblElement}\n */\nexport function jsxDEV<P>(\n  type: PibblElementType<P>,\n  props: P,\n  key: PibblKey | undefined,\n  _isStaticChildren: boolean,\n  source: PibblElementSource | undefined,\n  _self: unknown,\n): PibblElement<P> {\n  return createPibblElement(type, props, key, source);\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,gBAAgB;AAqBlB,SAAS,IACd,MACA,OACA,KACiB;AACjB,SAAO,mBAAmB,MAAM,OAAO,KAAK,MAAS;AACvD;AAcO,MAAM,OAAO;AAmBb,SAAS,OACd,MACA,OACA,KACA,mBACA,QACA,OACiB;AACjB,SAAO,mBAAmB,MAAM,OAAO,KAAK,MAAM;AACpD;",
+  "names": []
+}

package/dist/lib/element/metadata.d.ts

@@ -0,0 +1,96 @@
+import type { PibblBackendPrimitiveInput } from "../backend/types.js";
+import type { PibblInternalPrimitiveAttachmentInput } from "../element-enhancers.js";
+import type { getCurrentElementSource } from "../../internal.js";
+import type { PibblRenderTransaction, SystemStyle } from '../types.js';
+import type { PibblElement } from './types.js';
+import type { PrimitivePresentation } from '../primitive-presentation.js';
+import type { PibblBackendPrimitiveDefinition } from '../backend/types.js';
+/**
+ * Authoring source location attached to an element for diagnostics.
+ *
+ * @see {@link PibblBackendPrimitiveInput}
+ * @see {@link PibblInternalPrimitiveAttachmentInput}
+ * @see {@link getCurrentElementSource}
+ */
+export interface PibblElementSource {
+    /** Source filename recorded for diagnostics. See {@link PibblElementSource}. */
+    readonly fileName: string;
+    /** Source line recorded for diagnostics. See {@link PibblElementSource}. */
+    readonly lineNumber: number;
+    /** Source column recorded for diagnostics. See {@link PibblElementSource}. */
+    readonly columnNumber: number;
+}
+export interface InternalElementMetadata {
+    readonly source?: PibblElementSource;
+    readonly specifiedStyle?: Readonly<SystemStyle>;
+    readonly primitiveProgramProps?: Readonly<Record<PropertyKey, unknown>>;
+    readonly primitiveReceiverToken?: object;
+    readonly policyPreparationSource?: PibblElement<any>;
+    identityHint?: unknown;
+    placementConsumed?: boolean;
+    placementSignalHandoff?: Readonly<SystemStyle>;
+}
+export interface PrimitiveDefinition<P = any, S extends SystemStyle = SystemStyle, N extends SystemStyle = S, R extends SystemStyle = N> extends PibblBackendPrimitiveDefinition<P, S, N, R> {
+}
+export interface ElementPolicyDefinition {
+    readonly prepare: (policy: PibblElement<any>, child: PibblElement<any>) => PibblElement<any>;
+}
+/** @internal Registers the platform behavior for one component value. */
+export declare function setPrimitiveDefinition<P, S extends SystemStyle, N extends SystemStyle, R extends SystemStyle>(type: Function, definition: PrimitiveDefinition<P, S, N, R>): void;
+/** @internal Reads platform behavior without attaching fields to a function. */
+export declare function getPrimitiveDefinition(type: Function): PrimitiveDefinition | undefined;
+/** @internal Copies one primitive definition and presentation onto a new identity. */
+export declare function derivePrimitiveMetadata(source: Function, derived: Function): void;
+/** @internal Resolves Canvas presentation behavior from erased backend input. */
+export declare function getDefinitionPrimitivePresentation<S>(definition: PrimitiveDefinition, style: Readonly<S>): Readonly<PrimitivePresentation> | undefined;
+/** @internal Registers private presentation behavior for one primitive. */
+export declare function setPrimitivePresentation<S>(type: Function, resolve: (style: Readonly<S>) => Readonly<PrimitivePresentation> | undefined): void;
+/** @internal Resolves private presentation behavior for one primitive. */
+export declare function getPrimitivePresentation<S>(type: Function, style: Readonly<S>): Readonly<PrimitivePresentation> | undefined;
+/** @internal Registers an identity-transparent element preparation policy. */
+export declare function setElementPolicyDefinition(type: Function, definition: ElementPolicyDefinition): void;
+/** @internal Reads a policy before ordinary component identity is assigned. */
+export declare function getElementPolicyDefinition(type: Function): ElementPolicyDefinition | undefined;
+/** @internal */
+export declare function setElementMetadata(element: PibblElement<any>, metadata: InternalElementMetadata): void;
+/** @internal */
+export declare function getElementMetadata(element: PibblElement<any>): InternalElementMetadata | undefined;
+/** @internal Retains the original measurable identity behind policy clones. */
+export declare function setPolicyPreparationSource(element: PibblElement<any>, source: PibblElement<any>): void;
+/** @internal Reads the original measurable identity behind policy clones. */
+export declare function getPolicyPreparationSource(element: PibblElement<any>): PibblElement<any> | undefined;
+/** @internal Registers private WeakMap-backed annotations for immutable clones. */
+export declare function registerElementCloneMetadataHandler(handler: (source: PibblElement<any>, clone: PibblElement<any>) => void): void;
+/** @internal Copies every registered private annotation to a finalized clone. */
+export declare function copyElementCloneMetadata(source: PibblElement<any>, clone: PibblElement<any>): void;
+/** @internal */
+export declare function getElementSource(element: PibblElement<any>): PibblElementSource | undefined;
+/** @internal */
+export declare function getSpecifiedStyle<S extends SystemStyle>(element: PibblElement<{
+    style?: S;
+}>): Readonly<S> | undefined;
+/** @internal Returns program props with primitive-owned style removed. */
+export declare function getPrimitiveProgramProps<P>(element: PibblElement<any>): P;
+/** @internal Associates measurement and paint clones for one occurrence. */
+export declare function setPrimitiveReceiverToken(element: PibblElement<any>, token: object): void;
+/** @internal Reads the occurrence token carried by an internal clone. */
+export declare function getPrimitiveReceiverToken(element: PibblElement<any>): object | undefined;
+/** @internal Creates one receiver identity for a standalone measurement. */
+export declare function createPrimitiveReceiverToken(): object;
+/** @internal Reuses a direct-child occurrence across layout measurement and paint. */
+export declare function getChildPrimitiveReceiverToken(transaction: PibblRenderTransaction | undefined, parent: object | undefined, occurrence: number): object;
+/** @internal Reads the private identity override for a placed element. */
+export declare function getPlacementIdentityHint<T>(element: PibblElement<any>): T | undefined;
+/** @internal Stores the private identity override for a placed element. */
+export declare function setPlacementIdentityHint<T>(element: PibblElement<any>, value: T): void;
+/** @internal Built-in opaque payloads, without widening definePrimitive's API. */
+export declare function registerOpaquePrimitiveProps(type: Function, keys: readonly string[]): void;
+export declare function getOpaquePrimitiveProps(type: Function): readonly string[] | undefined;
+/** @internal Marks authored left/top as consumed by a parent layout wrapper. */
+export declare function setPlacementConsumed(element: PibblElement<any>): void;
+/** @internal */
+export declare function isPlacementConsumed(element: PibblElement<any>): boolean;
+/** @internal Marks an element created with a forwarded placement style signal. */
+export declare function setPlacementSignalHandoff(element: PibblElement<any>, style: Readonly<SystemStyle>): void;
+/** @internal */
+export declare function getPlacementSignalHandoffStyle(element: PibblElement<any>): Readonly<SystemStyle> | undefined;

package/dist/lib/element/metadata.js

@@ -0,0 +1,160 @@
+const elementMetadata = /* @__PURE__ */ new WeakMap();
+const elementCloneMetadataHandlers = /* @__PURE__ */ new Set();
+const primitiveDefinitions = /* @__PURE__ */ new WeakMap();
+const primitiveDefinitionTypes = /* @__PURE__ */ new WeakMap();
+const primitivePresentationResolvers = /* @__PURE__ */ new WeakMap();
+const policyDefinitions = /* @__PURE__ */ new WeakMap();
+const childPrimitiveReceiverTransactions = /* @__PURE__ */ new WeakMap();
+function setPrimitiveDefinition(type, definition) {
+  const erased = definition;
+  primitiveDefinitions.set(type, erased);
+  primitiveDefinitionTypes.set(erased, type);
+}
+function getPrimitiveDefinition(type) {
+  return primitiveDefinitions.get(type);
+}
+function derivePrimitiveMetadata(source, derived) {
+  const definition = primitiveDefinitions.get(source);
+  if (!definition) throw new TypeError("Can only derive a Pibbl primitive component.");
+  setPrimitiveDefinition(derived, { ...definition });
+  const presentation = primitivePresentationResolvers.get(source);
+  if (presentation) primitivePresentationResolvers.set(derived, presentation);
+}
+function getDefinitionPrimitivePresentation(definition, style) {
+  const type = primitiveDefinitionTypes.get(definition);
+  return type ? getPrimitivePresentation(type, style) : void 0;
+}
+function setPrimitivePresentation(type, resolve) {
+  primitivePresentationResolvers.set(type, resolve);
+}
+function getPrimitivePresentation(type, style) {
+  return primitivePresentationResolvers.get(type)?.(style);
+}
+function setElementPolicyDefinition(type, definition) {
+  policyDefinitions.set(type, definition);
+}
+function getElementPolicyDefinition(type) {
+  return policyDefinitions.get(type);
+}
+function setElementMetadata(element, metadata) {
+  elementMetadata.set(element, metadata);
+}
+function getElementMetadata(element) {
+  return elementMetadata.get(element);
+}
+function setPolicyPreparationSource(element, source) {
+  elementMetadata.set(element, {
+    ...elementMetadata.get(element),
+    policyPreparationSource: source
+  });
+}
+function getPolicyPreparationSource(element) {
+  return elementMetadata.get(element)?.policyPreparationSource;
+}
+function registerElementCloneMetadataHandler(handler) {
+  elementCloneMetadataHandlers.add(handler);
+}
+function copyElementCloneMetadata(source, clone) {
+  for (const handler of elementCloneMetadataHandlers) handler(source, clone);
+}
+function getElementSource(element) {
+  return elementMetadata.get(element)?.source;
+}
+function getSpecifiedStyle(element) {
+  return element.props.style;
+}
+function getPrimitiveProgramProps(element) {
+  const prepared = elementMetadata.get(element)?.primitiveProgramProps;
+  if (prepared !== void 0) return prepared;
+  const { style: _style, ...programProps } = element.props;
+  return programProps;
+}
+function setPrimitiveReceiverToken(element, token) {
+  const current = elementMetadata.get(element) ?? {};
+  elementMetadata.set(element, { ...current, primitiveReceiverToken: token });
+}
+function getPrimitiveReceiverToken(element) {
+  return elementMetadata.get(element)?.primitiveReceiverToken;
+}
+function createPrimitiveReceiverToken() {
+  return {};
+}
+function getChildPrimitiveReceiverToken(transaction, parent, occurrence) {
+  if (!transaction || !parent) return createPrimitiveReceiverToken();
+  let parents = childPrimitiveReceiverTransactions.get(transaction);
+  if (!parents) {
+    parents = /* @__PURE__ */ new WeakMap();
+    childPrimitiveReceiverTransactions.set(transaction, parents);
+  }
+  let children = parents.get(parent);
+  if (!children) {
+    children = /* @__PURE__ */ new Map();
+    parents.set(parent, children);
+  }
+  let token = children.get(occurrence);
+  if (!token) {
+    token = createPrimitiveReceiverToken();
+    children.set(occurrence, token);
+  }
+  return token;
+}
+function getPlacementIdentityHint(element) {
+  return elementMetadata.get(element)?.identityHint;
+}
+function setPlacementIdentityHint(element, value) {
+  const current = elementMetadata.get(element) ?? {};
+  elementMetadata.set(element, { ...current, identityHint: value });
+}
+const opaquePrimitiveProps = /* @__PURE__ */ new WeakMap();
+function registerOpaquePrimitiveProps(type, keys) {
+  opaquePrimitiveProps.set(type, keys);
+}
+function getOpaquePrimitiveProps(type) {
+  return opaquePrimitiveProps.get(type);
+}
+function setPlacementConsumed(element) {
+  const current = elementMetadata.get(element) ?? {};
+  elementMetadata.set(element, { ...current, placementConsumed: true });
+}
+function isPlacementConsumed(element) {
+  return elementMetadata.get(element)?.placementConsumed === true;
+}
+function setPlacementSignalHandoff(element, style) {
+  const current = elementMetadata.get(element) ?? {};
+  elementMetadata.set(element, { ...current, placementSignalHandoff: style });
+}
+function getPlacementSignalHandoffStyle(element) {
+  return elementMetadata.get(element)?.placementSignalHandoff;
+}
+export {
+  copyElementCloneMetadata,
+  createPrimitiveReceiverToken,
+  derivePrimitiveMetadata,
+  getChildPrimitiveReceiverToken,
+  getDefinitionPrimitivePresentation,
+  getElementMetadata,
+  getElementPolicyDefinition,
+  getElementSource,
+  getOpaquePrimitiveProps,
+  getPlacementIdentityHint,
+  getPlacementSignalHandoffStyle,
+  getPolicyPreparationSource,
+  getPrimitiveDefinition,
+  getPrimitivePresentation,
+  getPrimitiveProgramProps,
+  getPrimitiveReceiverToken,
+  getSpecifiedStyle,
+  isPlacementConsumed,
+  registerElementCloneMetadataHandler,
+  registerOpaquePrimitiveProps,
+  setElementMetadata,
+  setElementPolicyDefinition,
+  setPlacementConsumed,
+  setPlacementIdentityHint,
+  setPlacementSignalHandoff,
+  setPolicyPreparationSource,
+  setPrimitiveDefinition,
+  setPrimitivePresentation,
+  setPrimitiveReceiverToken
+};
+//# sourceMappingURL=metadata.js.map

package/dist/lib/element/metadata.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/element/metadata.ts"],
+  "sourcesContent": ["import type { PibblBackendPrimitiveInput } from '../backend/types.js';\nimport type { PibblInternalPrimitiveAttachmentInput } from '../element-enhancers.js';\nimport type { getCurrentElementSource } from '../../internal.js';\nimport type {\n  PibblRenderTransaction,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from './types.js';\nimport type { PrimitivePresentation } from '../primitive-presentation.js';\nimport type { PibblBackendPrimitiveDefinition } from '../backend/types.js';\n\n/**\n * Authoring source location attached to an element for diagnostics.\n *\n * @see {@link PibblBackendPrimitiveInput}\n * @see {@link PibblInternalPrimitiveAttachmentInput}\n * @see {@link getCurrentElementSource}\n */\nexport interface PibblElementSource {\n  /** Source filename recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly fileName: string;\n  /** Source line recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly lineNumber: number;\n  /** Source column recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly columnNumber: number;\n}\n\nexport interface InternalElementMetadata {\n  readonly source?: PibblElementSource;\n  readonly specifiedStyle?: Readonly<SystemStyle>;\n  readonly primitiveProgramProps?: Readonly<Record<PropertyKey, unknown>>;\n  readonly primitiveReceiverToken?: object;\n  readonly policyPreparationSource?: PibblElement<any>;\n  identityHint?: unknown;\n  placementConsumed?: boolean;\n  placementSignalHandoff?: Readonly<SystemStyle>;\n}\n\nconst elementMetadata = new WeakMap<PibblElement<any>, InternalElementMetadata>();\nconst elementCloneMetadataHandlers = new Set<(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n) => void>();\nconst primitiveDefinitions = new WeakMap<Function, PrimitiveDefinition>();\nconst primitiveDefinitionTypes = new WeakMap<PrimitiveDefinition, Function>();\nconst primitivePresentationResolvers = new WeakMap<\n  Function,\n  (style: Readonly<any>) => Readonly<PrimitivePresentation> | undefined\n>();\nconst policyDefinitions = new WeakMap<Function, ElementPolicyDefinition>();\nconst childPrimitiveReceiverTransactions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, Map<number, object>>\n>();\n\nexport interface PrimitiveDefinition<\n  P = any,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n> extends PibblBackendPrimitiveDefinition<P, S, N, R> {}\n\nexport interface ElementPolicyDefinition {\n  readonly prepare: (\n    policy: PibblElement<any>,\n    child: PibblElement<any>,\n  ) => PibblElement<any>;\n}\n\n/** @internal Registers the platform behavior for one component value. */\nexport function setPrimitiveDefinition<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n>(\n  type: Function,\n  definition: PrimitiveDefinition<P, S, N, R>,\n): void {\n  const erased = definition as PrimitiveDefinition;\n  primitiveDefinitions.set(type, erased);\n  primitiveDefinitionTypes.set(erased, type);\n}\n\n/** @internal Reads platform behavior without attaching fields to a function. */\nexport function getPrimitiveDefinition(\n  type: Function,\n): PrimitiveDefinition | undefined {\n  return primitiveDefinitions.get(type);\n}\n\n/** @internal Copies one primitive definition and presentation onto a new identity. */\nexport function derivePrimitiveMetadata(source: Function, derived: Function): void {\n  const definition = primitiveDefinitions.get(source);\n  if (!definition) throw new TypeError('Can only derive a Pibbl primitive component.');\n  setPrimitiveDefinition(derived, { ...definition });\n  const presentation = primitivePresentationResolvers.get(source);\n  if (presentation) primitivePresentationResolvers.set(derived, presentation);\n}\n\n/** @internal Resolves Canvas presentation behavior from erased backend input. */\nexport function getDefinitionPrimitivePresentation<S>(\n  definition: PrimitiveDefinition,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  const type = primitiveDefinitionTypes.get(definition);\n  return type ? getPrimitivePresentation(type, style) : undefined;\n}\n\n/** @internal Registers private presentation behavior for one primitive. */\nexport function setPrimitivePresentation<S>(\n  type: Function,\n  resolve: (\n    style: Readonly<S>,\n  ) => Readonly<PrimitivePresentation> | undefined,\n): void {\n  primitivePresentationResolvers.set(type, resolve);\n}\n\n/** @internal Resolves private presentation behavior for one primitive. */\nexport function getPrimitivePresentation<S>(\n  type: Function,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  return primitivePresentationResolvers.get(type)?.(style);\n}\n\n/** @internal Registers an identity-transparent element preparation policy. */\nexport function setElementPolicyDefinition(\n  type: Function,\n  definition: ElementPolicyDefinition,\n): void {\n  policyDefinitions.set(type, definition);\n}\n\n/** @internal Reads a policy before ordinary component identity is assigned. */\nexport function getElementPolicyDefinition(\n  type: Function,\n): ElementPolicyDefinition | undefined {\n  return policyDefinitions.get(type);\n}\n\n/** @internal */\nexport function setElementMetadata(\n  element: PibblElement<any>,\n  metadata: InternalElementMetadata,\n): void {\n  elementMetadata.set(element, metadata);\n}\n\n/** @internal */\nexport function getElementMetadata(\n  element: PibblElement<any>,\n): InternalElementMetadata | undefined {\n  return elementMetadata.get(element);\n}\n\n/** @internal Retains the original measurable identity behind policy clones. */\nexport function setPolicyPreparationSource(\n  element: PibblElement<any>,\n  source: PibblElement<any>,\n): void {\n  elementMetadata.set(element, {\n    ...elementMetadata.get(element),\n    policyPreparationSource: source,\n  });\n}\n\n/** @internal Reads the original measurable identity behind policy clones. */\nexport function getPolicyPreparationSource(\n  element: PibblElement<any>,\n): PibblElement<any> | undefined {\n  return elementMetadata.get(element)?.policyPreparationSource;\n}\n\n/** @internal Registers private WeakMap-backed annotations for immutable clones. */\nexport function registerElementCloneMetadataHandler(\n  handler: (source: PibblElement<any>, clone: PibblElement<any>) => void,\n): void {\n  elementCloneMetadataHandlers.add(handler);\n}\n\n/** @internal Copies every registered private annotation to a finalized clone. */\nexport function copyElementCloneMetadata(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n): void {\n  for (const handler of elementCloneMetadataHandlers) handler(source, clone);\n}\n\n/** @internal */\nexport function getElementSource(\n  element: PibblElement<any>,\n): PibblElementSource | undefined {\n  return elementMetadata.get(element)?.source;\n}\n\n/** @internal */\nexport function getSpecifiedStyle<S extends SystemStyle>(\n  element: PibblElement<{ style?: S }>,\n): Readonly<S> | undefined {\n  return element.props.style;\n}\n\n/** @internal Returns program props with primitive-owned style removed. */\nexport function getPrimitiveProgramProps<P>(element: PibblElement<any>): P {\n  const prepared = elementMetadata.get(element)?.primitiveProgramProps;\n  if (prepared !== undefined) return prepared as P;\n  const { style: _style, ...programProps } = element.props as {\n    readonly style?: unknown;\n    readonly [key: PropertyKey]: unknown;\n  };\n  return programProps as P;\n}\n\n/** @internal Associates measurement and paint clones for one occurrence. */\nexport function setPrimitiveReceiverToken(\n  element: PibblElement<any>,\n  token: object,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, primitiveReceiverToken: token });\n}\n\n/** @internal Reads the occurrence token carried by an internal clone. */\nexport function getPrimitiveReceiverToken(\n  element: PibblElement<any>,\n): object | undefined {\n  return elementMetadata.get(element)?.primitiveReceiverToken;\n}\n\n/** @internal Creates one receiver identity for a standalone measurement. */\nexport function createPrimitiveReceiverToken(): object {\n  return {};\n}\n\n/** @internal Reuses a direct-child occurrence across layout measurement and paint. */\nexport function getChildPrimitiveReceiverToken(\n  transaction: PibblRenderTransaction | undefined,\n  parent: object | undefined,\n  occurrence: number,\n): object {\n  if (!transaction || !parent) return createPrimitiveReceiverToken();\n  let parents = childPrimitiveReceiverTransactions.get(transaction);\n  if (!parents) {\n    parents = new WeakMap();\n    childPrimitiveReceiverTransactions.set(transaction, parents);\n  }\n  let children = parents.get(parent);\n  if (!children) {\n    children = new Map();\n    parents.set(parent, children);\n  }\n  let token = children.get(occurrence);\n  if (!token) {\n    token = createPrimitiveReceiverToken();\n    children.set(occurrence, token);\n  }\n  return token;\n}\n\n/** @internal Reads the private identity override for a placed element. */\nexport function getPlacementIdentityHint<T>(element: PibblElement<any>): T | undefined {\n  return elementMetadata.get(element)?.identityHint as T | undefined;\n}\n\n/** @internal Stores the private identity override for a placed element. */\nexport function setPlacementIdentityHint<T>(element: PibblElement<any>, value: T): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, identityHint: value });\n}\n\nconst opaquePrimitiveProps = new WeakMap<Function, readonly string[]>();\n/** @internal Built-in opaque payloads, without widening definePrimitive's API. */\nexport function registerOpaquePrimitiveProps(type: Function, keys: readonly string[]): void {\n  opaquePrimitiveProps.set(type, keys);\n}\nexport function getOpaquePrimitiveProps(type: Function): readonly string[] | undefined {\n  return opaquePrimitiveProps.get(type);\n}\n\n/** @internal Marks authored left/top as consumed by a parent layout wrapper. */\nexport function setPlacementConsumed(element: PibblElement<any>): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementConsumed: true });\n}\n\n/** @internal */\nexport function isPlacementConsumed(element: PibblElement<any>): boolean {\n  return elementMetadata.get(element)?.placementConsumed === true;\n}\n\n\n/** @internal Marks an element created with a forwarded placement style signal. */\nexport function setPlacementSignalHandoff(\n  element: PibblElement<any>,\n  style: Readonly<SystemStyle>,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementSignalHandoff: style });\n}\n\n/** @internal */\nexport function getPlacementSignalHandoffStyle(\n  element: PibblElement<any>,\n): Readonly<SystemStyle> | undefined {\n  return elementMetadata.get(element)?.placementSignalHandoff;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/element/resolve-primitive-inputs.d.ts

@@ -0,0 +1,12 @@
+import { type ResponsiveStylePreparation, type QueryBasis } from '../style/responsive.js';
+import { type PrimitiveDefinition } from './metadata.js';
+import type { PibblElement } from './types.js';
+export interface ResolvedPrimitiveInputs {
+    readonly props: Readonly<Record<PropertyKey, unknown>>;
+    readonly style: Readonly<Record<PropertyKey, unknown>> | undefined;
+}
+export declare function resolvePrimitiveInputs(element: PibblElement<any>, definition: PrimitiveDefinition, prepared?: {
+    style: Readonly<Record<PropertyKey, unknown>>;
+}, basis?: QueryBasis): ResolvedPrimitiveInputs;
+export declare function resolvePrimitiveStyleInput(input: unknown, element: PibblElement<any> | undefined, basis: QueryBasis | undefined, mode: 'value'): Readonly<Record<PropertyKey, unknown>> | undefined;
+export declare function resolvePrimitiveStyleInput(input: unknown, element?: PibblElement<any>, basis?: QueryBasis): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined;