refactor docs

Author: spearwolf

AGENTS.md

@@ -33,6 +33,7 @@ The **Shadow Objects Framework** is a reactive library designed to decouple busi
 - **`packages/shadow-objects/`**: The main framework library. Deployment package: `@spearwolf/shadow-objects`.
 - **`packages/shadow-objects/docs/`**: **The authoritative source of documentation.** Contains Fundamentals, Guides, and API references.
 - **`packages/shae-offscreen-canvas/`**: An offscreen canvas as custom HTML element based on shadow-objects.
+- **`packages/skills/`**: Agent Skills for AI assistants to help with shadow-objects development.
 - **`packages/shadow-objects-testing/`**: Functional tests.
 - **`packages/shadow-objects-e2e/`**: Blackbox / E2E tests.
 

README.md

@@ -50,6 +50,7 @@ This repository is a monorepo managed with [nx](https://nx.dev/) and [pnpm](http
 | :--- | :--- |
 | **[`shadow-objects`](packages/shadow-objects/)** | The heart. The core library of the framework. |
 | **[`shae-offscreen-canvas`](packages/shae-offscreen-canvas/)** | A Custom Element implementing an **Offscreen Canvas** – demonstrates the power of `shadow-objects` for graphics applications. |
+| **[`skills`](packages/skills/)** | **Agent Skills** for AI assistants to help with `shadow-objects` development. |
 
 ### Testing & Quality Assurance
 

packages/shadow-objects/docs-legacy/src-in-the-dark-ShadowObjectsGuide.md

@@ -75,7 +75,7 @@ export function MyLogic({
 
   createEffect(() => {
     // RUNTIME: Runs whenever 'title' or 'count' changes
-    console.log(`Title: ${title()}, Count: ${count()}`);
+    console.log(`Title: ${title()}, Count: ${count.get()}`);
   });
 
   // SETUP: Listen for View events

packages/shadow-objects/docs-legacy/src-view-ComponentContext.md

@@ -97,8 +97,6 @@ Events dispatched by the View Component are automatically forwarded to the corre
 Shadow Objects attached to the same Entity can communicate via events.
 
 ```typescript
-import {emit} from '@spearwolf/eventize';
-
 // Feature A
 export function FeatureA({on}: ShadowObjectCreationAPI) {
   // Listen for event from Feature B
@@ -108,9 +106,9 @@ export function FeatureA({on}: ShadowObjectCreationAPI) {
 }
 
 // Feature B
-export function FeatureB({entity}: ShadowObjectCreationAPI) {
+export function FeatureB({emit}: ShadowObjectCreationAPI) {
   // Emit event via the entity
-  emit(entity, 'data-loaded', {id: 123});
+  emit('data-loaded', {id: 123});
 }
 ```
 
@@ -119,9 +117,7 @@ export function FeatureB({entity}: ShadowObjectCreationAPI) {
 You can broadcast events to all descendant Entities using the `traverse` helper. This is useful for "global" updates like a frame tick or a resize event.
 
 ```typescript
-import {emit} from '@spearwolf/eventize';
-
-export function StageController({entity, on}: ShadowObjectCreationAPI) {
+export function StageController({emit, entity, on}: ShadowObjectCreationAPI) {
   // Example: Broadcast a 'frame-update' event to the entire subtree
   on('tick', (deltaTime) => {
     entity.traverse((e) => {

packages/shadow-objects/docs-legacy/src-view-ShadowEnv.md

@@ -127,17 +127,16 @@ Communication isn't just data syncing; it's also about events.
 
 ### Listening to View Events
 
-When the View Component dispatches an event (e.g., via `component.dispatchShadowObjectsEvent('submit', { secret: '999' })`), you receive it on the entity.
+When the View Component dispatches an event (e.g., via `component.dispatchShadowObjectsEvent('submit', { secret: '999' })`), you receive it via the `onViewEvent` callback.
 
 ```typescript
-import { onViewEvent } from '@spearwolf/shadow-objects/shadow-objects.js';
-
-// entity is used as event source by default
-on(onViewEvent, (type, data) => {
-  if (type === 'submit') {
-    submitForm(data);
-  }
-});
+export function FormLogic({ onViewEvent }: ShadowObjectCreationAPI) {
+  onViewEvent((type, data) => {
+    if (type === 'submit') {
+      submitForm(data);
+    }
+  });
+}
 ```
 
 ### Emitting Events to the View