@askrjs/askr 0.0.1 → 0.0.2

package/README.md

@@ -57,7 +57,7 @@ function Home() {
     <div>
       <h1>Home</h1>
       <p>Count: {count()}</p>
-      <button onClick={() => count.set(count() + 1)}>Increment</button>
+      <button onClick={() => count.set(prev => prev + 1)}>Increment</button>
       <p>
         <Link href="/users/42">User 42</Link>
       </p>
@@ -65,6 +65,9 @@ function Home() {
   );
 }
 
+
+**Tip:** Prefer functional updates when updating based on previous state: `count.set(prev => prev + 1)`.
+
 function User({ id }: { id: string }) {
   return (
     <div>
@@ -123,19 +126,24 @@ We believe the best frameworks are the ones you stop thinking about.
 
 ## Cancellation is not a feature
 
-Askr doesn’t introduce a new cancellation concept.
-When work becomes stale (unmount, route replacement), the runtime aborts an `AbortController`.
-You forward the provided `signal` into normal APIs:
+Askr doesn’t introduce a new cancellation concept. When work becomes stale (unmount, route replacement), the runtime aborts an `AbortController` and you should forward a cancellable `signal` into normal APIs. **Important:** route handlers are executed synchronously during navigation and must return a VNode — they must not be `async` functions that return a Promise. For async data use runtime helpers like `resource()` or perform async work inside component mount operations and use `getSignal()` for cancellation.
+
+Example (recommended pattern):
 
 ```ts
-import { route } from '@askrjs/askr';
+import { route, resource, getSignal } from '@askrjs/askr';
+
+function User({ id }: { id: string }) {
+  const user = resource(async () => {
+    const res = await fetch(`/api/users/${id}`, { signal: getSignal() });
+    return res.json();
+  }, [id]);
 
-route('/user/{id}', async (params, ctx) => {
-  const user = await fetch(`/api/users/${params.id}`, {
-    signal: ctx?.signal,
-  }).then((r) => r.json());
+  if (!user) return <div>Loading...</div>;
   return <pre>{JSON.stringify(user, null, 2)}</pre>;
-});
+}
+
+route('/user/{id}', ({ id }) => <User id={id} />);
 ```
 
 ## Principles

package/dist/chunk-KR6HG7HF.js

@@ -0,0 +1,38 @@
+import {
+  __esm,
+  init_types
+} from "./chunk-QECQ2TF6.js";
+
+// src/jsx/jsx-runtime.ts
+function jsxDEV(type, props, key) {
+  return {
+    $$typeof: ELEMENT_TYPE,
+    type,
+    props: props ?? {},
+    key: key ?? null
+  };
+}
+function jsx(type, props, key) {
+  return jsxDEV(type, props, key);
+}
+function jsxs(type, props, key) {
+  return jsxDEV(type, props, key);
+}
+var ELEMENT_TYPE, Fragment;
+var init_jsx_runtime = __esm({
+  "src/jsx/jsx-runtime.ts"() {
+    init_types();
+    ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("askr.element");
+    Fragment = /* @__PURE__ */ Symbol.for("askr.fragment");
+  }
+});
+
+export {
+  ELEMENT_TYPE,
+  Fragment,
+  jsxDEV,
+  jsx,
+  jsxs,
+  init_jsx_runtime
+};
+//# sourceMappingURL=chunk-KR6HG7HF.js.map

package/dist/chunk-KR6HG7HF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsx/jsx-runtime.ts"],"sourcesContent":["/**\n * JSX dev runtime\n * Same shape as production runtime, with room for dev warnings.\n */\n\nimport './types';\n\nexport const ELEMENT_TYPE = Symbol.for('askr.element');\nexport const Fragment = Symbol.for('askr.fragment');\n\nexport interface JSXElement {\n  $$typeof: symbol;\n  type: unknown;\n  props: Record<string, unknown>;\n  key: string | number | null;\n}\n\nexport function jsxDEV(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n): JSXElement {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type,\n    props: props ?? {},\n    key: key ?? null,\n  };\n}\n\n// Production-style helpers: alias to the DEV factory for now\nexport function jsx(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n) {\n  return jsxDEV(type, props, key);\n}\n\nexport function jsxs(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n) {\n  return jsxDEV(type, props, key);\n}\n\n// `Fragment` is already exported above.\n"],"mappings":";;;;;;AAiBO,SAAS,OACd,MACA,OACA,KACY;AACZ,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO,SAAS,CAAC;AAAA,IACjB,KAAK,OAAO;AAAA,EACd;AACF;AAGO,SAAS,IACd,MACA,OACA,KACA;AACA,SAAO,OAAO,MAAM,OAAO,GAAG;AAChC;AAEO,SAAS,KACd,MACA,OACA,KACA;AACA,SAAO,OAAO,MAAM,OAAO,GAAG;AAChC;AA7CA,IAOa,cACA;AARb;AAAA;AAKA;AAEO,IAAM,eAAe,uBAAO,IAAI,cAAc;AAC9C,IAAM,WAAW,uBAAO,IAAI,eAAe;AAAA;AAAA;","names":[]}