@kayelaa/canvas 0.1.13 → 0.2.0

package/docs/@kayelaa/namespaces/Kayla/functions/createRenderer.md

@@ -1,38 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / createRenderer
-
-# Function: createRenderer()
-
-> **createRenderer**(`canvas`): [`KaylaRenderer`](../interfaces/KaylaRenderer.md)
-
-Defined in: [kayla-internals.ts:101](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L101)
-
-Creates a renderer that drives the canvas draw loop and handles pointer tracking.
-
-The renderer automatically clears the canvas each frame and emits a `"draw"` event
-where scenes can paint. Call `renderer.start()` to begin the RAF loop.
-
-## Parameters
-
-### canvas
-
-`HTMLCanvasElement`
-
-The target `<canvas>` element
-
-## Returns
-
-[`KaylaRenderer`](../interfaces/KaylaRenderer.md)
-
-A `KaylaRenderer` instance
-
-## Example
-
-```ts
-const canvas = document.getElementById("game") as HTMLCanvasElement;
-const renderer = createRenderer(canvas);
-renderer.start();
-```

package/docs/@kayelaa/namespaces/Kayla/functions/createScene.md

@@ -1,37 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / createScene
-
-# Function: createScene()
-
-> **createScene**(`name`): [`KaylaScene`](../namespaces/KaylaInternals/classes/KaylaScene.md)
-
-Defined in: [kayla-internals.ts:82](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L82)
-
-Creates a scene that manages a collection of entities and their update/draw lifecycle.
-
-Scenes handle z-sorted drawing, paused state, and entity addition/removal.
-Use `scene.spawn()` to mount a root component tree.
-
-## Parameters
-
-### name
-
-`string`
-
-Unique identifier for the scene
-
-## Returns
-
-[`KaylaScene`](../namespaces/KaylaInternals/classes/KaylaScene.md)
-
-A `KaylaScene` wrapper with `.spawn()` and other methods
-
-## Example
-
-```ts
-const scene = createScene("main");
-scene.spawn(<GameWorld />);
-```

package/docs/@kayelaa/namespaces/Kayla/functions/createUseHook.md

@@ -1,83 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / createUseHook
-
-# Function: createUseHook()
-
-> **createUseHook**\<`Return`, `Params`\>(`config`): (`params?`) => `Return`
-
-Defined in: [kayla-internals.ts:1989](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1989)
-
-Factory to create custom, reusable hooks for Kayla that can accept runtime parameters.
-
-The returned hook can be called with optional params that are passed to `onUse`.
-By default, the result is memoized (runs `onUse` only once per entity).
-
-## Type Parameters
-
-### Return
-
-`Return`
-
-The type of value the hook returns
-
-### Params
-
-`Params` = `void`
-
-= void Optional type of runtime params passed to the hook
-
-## Parameters
-
-### config
-
-[`KaylaCustomHookConfig`](../interfaces/KaylaCustomHookConfig.md)\<`Return`, `Params`\>
-
-Configuration with onUse + optional memoize/name
-
-## Returns
-
-A hook function you can call in components, optionally with params
-
-> (`params?`): `Return`
-
-### Parameters
-
-#### params?
-
-`Params`
-
-### Returns
-
-`Return`
-
-## Examples
-
-```ts
-Basic memoized hook with no params
-const useMyTimer = createUseHook({
-  name: "useMyTimer",
-  onUse: () => {
-    const elapsed = useRef(0);
-    useTick(dt => { elapsed.current += dt; });
-    return { getElapsed: () => elapsed.current };
-  }
-});
-```
-
-```ts
-Hook that accepts runtime params
-const useMoveSpeed = createUseHook<number, { baseSpeed: number }>({
-  name: "useMoveSpeed",
-  onUse: (fiber, global, { baseSpeed }) => {
-    const speed = useRef(baseSpeed);
-    useTick(dt => { speed.current += 0.1 * dt; });
-    return speed.current;
-  }
-});
-
-// usage
-const speed = useMoveSpeed({ baseSpeed: 200 });
-```

package/docs/@kayelaa/namespaces/Kayla/functions/setLogLevel.md

@@ -1,21 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / setLogLevel
-
-# Function: setLogLevel()
-
-> **setLogLevel**(`level`): `void`
-
-Defined in: [kayla-internals.ts:1910](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1910)
-
-## Parameters
-
-### level
-
-`"silent"` | `"warn"` | `"info"` | `"debug"`
-
-## Returns
-
-`void`

package/docs/@kayelaa/namespaces/Kayla/functions/useDisposableRef.md

@@ -1,45 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / useDisposableRef
-
-# Function: useDisposableRef()
-
-> **useDisposableRef**\<`T`\>(`initialValue`): [`KaylaRef`](../interfaces/KaylaRef.md)\<`T`\>
-
-Defined in: [kayla-internals.ts:1850](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1850)
-
-Creates a temporary ref object **outside** of component context.
-
-Unlike `useRef`, this ref **does not persist** across entity refreshes — it is recreated
-every time the component function runs. Use for one-off values or render-pass temporaries.
-
-## Type Parameters
-
-### T
-
-`T`
-
-Type of the ref's value
-
-## Parameters
-
-### initialValue
-
-`T`
-
-Initial value for `.current`
-
-## Returns
-
-[`KaylaRef`](../interfaces/KaylaRef.md)\<`T`\>
-
-A fresh `KaylaRef` instance
-
-## Example
-
-```ts
-const temp = useDisposableRef({ count: 0 });
-// temp.current is only valid for this render
-```

package/docs/@kayelaa/namespaces/Kayla/functions/useNextStack.md

@@ -1,28 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / useNextStack
-
-# Function: useNextStack()
-
-> **useNextStack**(`callback`): `void`
-
-Defined in: [kayla-internals.ts:1773](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1773)
-
-Schedules a callback to run in the next microtask (via `Promise.resolve().then`).
-
-Used internally to defer entity refreshes safely and prevent synchronous re-entrancy.
-Rarely needed directly by users.
-
-## Parameters
-
-### callback
-
-() => `void`
-
-The function to schedule
-
-## Returns
-
-`void`

package/docs/@kayelaa/namespaces/Kayla/interfaces/FC.md

@@ -1,41 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / FC
-
-# Interface: FC()\<Props, Exports\>
-
-Defined in: [kayla-internals.ts:22](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L22)
-
-## Type Parameters
-
-### Props
-
-`Props` *extends* [`FCProps`](../type-aliases/FCProps.md) = [`FCProps`](../type-aliases/FCProps.md)
-
-### Exports
-
-`Exports` *extends* [`FCExports`](../type-aliases/FCExports.md) = [`FCExports`](../type-aliases/FCExports.md)
-
-> **FC**(`props`): `void` \| [`KaylaElement`](KaylaElement.md)\<`any`\> \| [`KaylaElement`](KaylaElement.md)\<`any`\>[]
-
-Defined in: [kayla-internals.ts:26](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L26)
-
-## Parameters
-
-### props
-
-`Props` & `object`
-
-## Returns
-
-`void` \| [`KaylaElement`](KaylaElement.md)\<`any`\> \| [`KaylaElement`](KaylaElement.md)\<`any`\>[]
-
-## Properties
-
-### displayName?
-
-> `optional` **displayName**: `string`
-
-Defined in: [kayla-internals.ts:32](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L32)

package/docs/@kayelaa/namespaces/Kayla/interfaces/KaylaCustomHookConfig.md

@@ -1,86 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / KaylaCustomHookConfig
-
-# Interface: KaylaCustomHookConfig\<Return, Params\>
-
-Defined in: [kayla-internals.ts:1924](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1924)
-
-Configuration for a custom Kayla hook created via `createUseHook`.
-
-## Type Parameters
-
-### Return
-
-`Return`
-
-### Params
-
-`Params` = `void`
-
-## Properties
-
-### onUse()
-
-> **onUse**: (`unsafeFiber`, `global`, `params`) => `Return`
-
-Defined in: [kayla-internals.ts:1934](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1934)
-
-Called when the hook is used (once if memoized, every render if not).
-Receives the current fiber, global context, and any runtime params passed to the hook.
-
-#### Parameters
-
-##### unsafeFiber
-
-[`UnsafeKaylaFiber`](UnsafeKaylaFiber.md)
-
-Direct reference to the internal fiber (use with caution!)
-
-##### global
-
-[`GlobalKayla`](../namespaces/KaylaInternals/classes/GlobalKayla.md)
-
-The GlobalKayla instance (for logger, etc.)
-
-##### params
-
-`Params`
-
-Optional runtime parameters passed when calling the hook
-
-#### Returns
-
-`Return`
-
-The value that the hook will return
-
-***
-
-### memoize?
-
-> `optional` **memoize**: `boolean`
-
-Defined in: [kayla-internals.ts:1947](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1947)
-
-Whether to memoize (cache) the result of onUse across component refreshes.
-- `true` (default): runs onUse only once per entity lifetime → most common & performant
-- `false`: runs onUse on every render → useful for hooks that must recompute frequently
-
-#### Default
-
-```ts
-true
-```
-
-***
-
-### name
-
-> **name**: `string`
-
-Defined in: [kayla-internals.ts:1952](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1952)
-
-Required name for this custom hook — used in dev-mode logs/warnings to identify it.

package/docs/@kayelaa/namespaces/Kayla/interfaces/KaylaElement.md

@@ -1,31 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / KaylaElement
-
-# Interface: KaylaElement\<Props\>
-
-Defined in: [kayla-internals.ts:131](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L131)
-
-## Type Parameters
-
-### Props
-
-`Props` *extends* [`FCProps`](../type-aliases/FCProps.md)
-
-## Properties
-
-### type
-
-> **type**: [`FC`](FC.md)\<`Props`\>
-
-Defined in: [kayla-internals.ts:132](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L132)
-
-***
-
-### props
-
-> **props**: `Props`
-
-Defined in: [kayla-internals.ts:133](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L133)

package/docs/@kayelaa/namespaces/Kayla/interfaces/KaylaFiberControl.md

@@ -1,102 +0,0 @@
-[**@kayelaa/canvas**](../../../../README.md)
-
-***
-
-[@kayelaa/canvas](../../../../README.md) / [Kayla](../README.md) / KaylaFiberControl
-
-# Interface: KaylaFiberControl
-
-Defined in: [kayla-internals.ts:1919](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L1919)
-
-## Extends
-
-- [`KaylaFiberControl`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md)
-
-## Properties
-
-### maxSafeChildren
-
-> **maxSafeChildren**: `number`
-
-Defined in: [kayla-internals.ts:841](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L841)
-
-Advisory maximum number of direct children allowed before warning or enforcement.
-Default: 40.
-
-Can be changed via `setMaxChildren()`.
-
-Enforcement is **soft** by default (logs warning + removes excess oldest children).
-Set to `Infinity` to disable limit.
-
-#### Inherited from
-
-[`KaylaFiberControl`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md).[`maxSafeChildren`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md#maxsafechildren)
-
-## Accessors
-
-### childrenCount
-
-#### Get Signature
-
-> **get** **childrenCount**(): `number`
-
-Defined in: [kayla-internals.ts:829](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L829)
-
-Current number of direct child fibers (readonly).
-Reflects the length of `lastChildren` after the last reconciliation.
-
-##### Returns
-
-`number`
-
-#### Inherited from
-
-[`KaylaFiberControl`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md).[`childrenCount`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md#childrencount)
-
-## Methods
-
-### setMaxChildren()
-
-> **setMaxChildren**(`max`): `void`
-
-Defined in: [kayla-internals.ts:850](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L850)
-
-Sets the maximum allowed number of direct children for this fiber.
-
-If current child count exceeds the new limit, **excess oldest children are immediately unmounted**.
-
-#### Parameters
-
-##### max
-
-`number`
-
-New maximum (must be >= 0). Use `Infinity` to remove limit.
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-[`KaylaFiberControl`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md).[`setMaxChildren`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md#setmaxchildren)
-
-***
-
-### getMaxChildren()
-
-> **getMaxChildren**(): `number`
-
-Defined in: [kayla-internals.ts:857](https://github.com/lianecagara/kaye-tanks-v2/blob/4a28d0500ea6e343627b34fac908efa8113674cc/kayla/src/kayla-internals.ts#L857)
-
-Returns the current maximum allowed number of direct children.
-
-#### Returns
-
-`number`
-
-The limit (Infinity if no limit set)
-
-#### Inherited from
-
-[`KaylaFiberControl`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md).[`getMaxChildren`](../namespaces/KaylaInternals/interfaces/KaylaFiberControl.md#getmaxchildren)