aktion-runtime 0.5.7 → 0.5.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -227,6 +227,9 @@ Three equivalent ways:
227
227
  $app(Card([CardHeader("Hi")]))
228
228
  </aktion-app>
229
229
 
230
+ <!-- from an external file (linked with its imports) -->
231
+ <aktion-app src="./app.aktion"></aktion-app>
232
+
230
233
  <!-- as a property/method -->
231
234
  <script>
232
235
  const el = document.querySelector("aktion-app");
@@ -305,6 +308,7 @@ All members live on the `<aktion-app>` element.
305
308
  | `theme` | Theme name or JSON token map | Switches the theme. JSON objects are merged on top of the default `light` tokens. |
306
309
  | `streaming` | `true` / unset | Hint that text is still being appended. The error banner is suppressed while set. |
307
310
  | `response` | Aktion text | Sets the program declaratively. Re-renders whenever the attribute changes. |
311
+ | `src` | URL to an `.aktion` file | Loads the program from an external file resolved relative to the document. The file is linked through the in-browser project linker, so an entry that `import`s other modules resolves and fetches its whole graph. `response` (and any inner text) takes precedence; changing `src` reloads. |
308
312
  | `showerrors` | `true` / unset | If present and `true`, displays parse errors in the rendered UI. Defaults to off. |
309
313
  | `strict` | `true` / unset | Dev/strict mode. Surfaces silent failures as `console.warn`s — unknown identifiers that would resolve to `null`, and trailing `{...}` objects passed to a user component whose keys match no parameter (the silent named→positional flip). Off by default; enable while developing. |
310
314
  | `router-mode` | `hash` (default) / `history` | URL strategy. `history` uses the History API for clean `/about` URLs (needs an `index.html` fallback on the server); `hash` works on any static host. |
@@ -320,6 +324,7 @@ surfaces from the *generated prompt*, build it via
320
324
  | Property | Type | Description |
321
325
  | ------------- | ----------------------------- | -------------------------------------------------------------------------------------- |
322
326
  | `response` | `string` | Get or set the current program text. Setter is equivalent to `setResponse(text)`. |
327
+ | `src` | `string \| null` | Reflects the `src` attribute. Setting it loads (or reloads) the program from that URL. |
323
328
  | `streaming` | `boolean` | Reflects the `streaming` attribute. |
324
329
  | `showErrors` | `boolean` | Reflects the `showerrors` attribute. |
325
330
  | `route` | `string` (read-only) | Current path tracked by the router (e.g. `"/users/42"`). |
@@ -1498,7 +1503,8 @@ consumes from the CDN.
1498
1503
  | `index.html` | Overview, drop-in install, live theme picker. |
1499
1504
  | `get-started.html` | Step-by-step integration walkthrough. |
1500
1505
  | `frameworks.html` | Integration recipes for React, Next.js, Vue, Angular, Svelte, plain HTML. |
1501
- | `language.html` | Full Aktion language reference. |
1506
+ | `language.html` | Full Aktion language guide — the conceptual walkthrough of syntax and semantics. |
1507
+ | `language-reference.html` | Searchable reference of every language symbol — keywords, `$`-builtins & hooks, the `$util` namespace, JavaScript globals, and operators/literals, each with a one-line description and copy-paste example. Filter by category or type to jump straight to an entry. |
1502
1508
  | `http.html` | HTTP guide — the `$http({...})` primitive, config options, the reactive resource bag, `Async`, refetch/cancel patterns, and a full CRUD walkthrough. |
1503
1509
  | `components.html` | Every built-in component with a live preview, positional signatures, prop tables, and enum values. |
1504
1510
  | `actions.html` | `function name() { … }` guide — declarative state mutations, optimistic snapshot/rollback, lambda-based click handlers, navigation, and end-to-end examples. |