Skip to main content

Search

Items tagged with: statefulComponents

And here’s a real-world example of the lifecycle of an action performed on a local copy of the Gaza Verified web site¹ showing the event from the toggle button on the client being automatically mapped to the relevant event handler on the SignUpsSwitch Kitten component instance on the server and that handler setting a boolean on a JavaScript object in memory, which is automatically persisted to disk via Kitten’s default JSDB² database.

Note that Kitten is smart enough to automatically redact fields in the log output that look like they might be secrets.

All this is in the stateful-components-api-breaking-change branch³ at the moment and will be in the next release.

¹ gaza-verified.org
² codeberg.org/small-tech/jsdb
³ codeberg.org/kitten/app/src/br…

#SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #GazaVerified

Screenshot of the Gaza Verified admin interface (Interviews section) running on https://localhost/admin/interviews/ showing the Sign-ups are open checkbox And the Team Schedule section with a table of volunteers to days with checkmarks for which day a volunteer is active this week. The main navigation shows Home, People, Donate, Guide, Team, دليل, and انضم إلنا! as well as a تسجيل الدخول button.
Screenshot of Kitten’s Interactive Shell (REPL), showing an action performed in the browser (client event) automatically triggering a server-side event handler that then updates a boolean value in a JavaScript object in memory that is automatically persisted to disk using Kitten’s built-in JSDB (JavaScript Database): 📄 → 🐱: Client event « signUpSwitch » SignUpsSwitch (KittenComponent) sign-up-switch { _componentId: 'sign-up-switch' } 💾 Settings updated in memory. Settings { id: '7832e729-1996-4ac4-b7d0-db3b6ba294d9', allowSignUps: true, mastodonAccessToken: '**** [REDACTED]' } => allowSignUps = false 🐱 → 📄: Streaming HTML <div hx-swap-oob="morph" data-kitten-component id="sign-up-switch" class="signUpSwitch off"> <div class="Switch"> <label for="switch-53fb247e-5681-44c1-b8a0-f3f5bac6521d" class="Switch">Sign-ups are closed.</label> <input id="switch-53fb247e-5681-44c1-b8a0-f3f5bac6521d" name="signUpSwitch" type="checkbox" role="switch" ws-send hx-ext="ws,morph" hx-swap-oob="morph"> </div> </div> 💾 Settings persisted to disk. kitten.db.settings.allowSignUps = false Persisted as: '_[[`allowSignUps`]] = false;\n' 🐱 💬

app

A web development kit that’s small, purrs, and loves you.
Codeberg.org
#dev #web #SmallWeb #kitten #gazaverified #statefulcomponents #streaminghtml #hypertext

You also have some helpful new error messages to look forward to :)

#SmallWeb #Kitten #NodeJS #JavaScript #web #dev #statefulComponents #streamingHTML #hypertext #errorMessages

Screenshot of error message in Kitten (terminal output): ❌ Error: Cannot stream component update as component does not have a single root DOM node. What your component update looks like currently: <div id="counter" aria-live="assertive">3</div> <style inline>#counter { color: green; }</style> <style>#counter { font-size: 3em; margin: 0.25em 0; }</style> What it would look like with a single root DOM node (e.g., a <div>): <div> <div id="counter" aria-live="assertive">3</div> <style inline>#counter { color: green; }</style> <style>#counter { font-size: 3em; margin: 0.25em 0; }</style> </div>
#dev #web #javascript #nodejs #SmallWeb #kitten #statefulcomponents #streaminghtml #hypertext #errorMessages

PS. The updated component render you’re seeing streamed to the browser in the previous screenshot is the code rendered by Kitten (showing the underlying HTMX internals, etc.)

The code you write in Kitten is considerably less complicated.

The attached screenshot is all the code in the simple counter example (all in one file, index.page.ts). To run it, you’d just run `kitten` in the directory that file is in and then hit https://localhost.

#SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #webSockets

Screenshot of Helix Editor showing all the code (52 lines) for the stateful counter example, split across two panes so it can be shown at a larger font size: /** Type-safe counter example using stateful Kitten components. */ import kitten from '@small-web/kitten' // Declare database schema and initialise, if necessary. type Schema = { counter?: { count: number } } const database = (kitten.db as Schema).counter ??= { count: 0 } export default class CounterPage extends kitten.Page { counter constructor () { super() this.counter = this.addChild(new Counter()) } override html () { return kitten.html` <page css> <h1>Counter</h1> <${this.counter} /> ` } } class Counter extends kitten.Component { override html () { return kitten.html` <div morph> <div aria-live='assertive'> ${database.count} </div> <button name='update' connect data='{value: -1}' aria-label='decrement'>-</button> <button name='update' connect data='{value: 1}' aria-label='increment'>+</button> <style inline> @scope { div { font-size: 3em; margin: 0.25em 0; } } </style> </div> ` } onUpdate (data: { value: number } ) { database.count += data.value this.update() } }
#dev #web #SmallWeb #kitten #statefulcomponents #streaminghtml #hypertext #websockets

Very excited about the new stateful components model in Kitten¹ that I’m looking forward to releasing this week (finally) and the amount of visibility you can now get into the flow of your Kitten apps in the Kitten Interactive Shell (REPL)².

Since the new model is a breaking change (Kitten is prerelease) I’m in the middle of updating our own apps/sites and I still need to document everything. So it will take me a few days to do all that but then I’m very much looking forward to focussing on finishing up Catalyst and Yarn³ for launch this year.

It’s been a six year trek to reach what will essentially be the starting point of the Small Web :)

💕

PS. If you want to support our work, please see small-tech.org/fund-us/

¹ kitten.small-web.org
² kitten.small-web.org/tutorials…
³ ar.al/2024/06/24/small-web-com…

#SmallWeb #Kitten #web #dev #statefulComponents #streamingHTML #hypertext #webSockets

Screenshot of the Kitten REPL running in WezTerm: 🐢 Kitten Interactive Shell (REPL) ctrl-d to exit; .help for assistance. Key 🐱 Kitten 📄 Page 🛜 Server event 🧩 Component ◉━◉ Connected ◉╌◌ Disconnected 🐱 💬 kitten.$showEventsOnTable('counter') undefined 🐱 💬 📄 → 🐱: Client event « update » Counter (KittenComponent) c9333a86 { update: '', value: 1, _componentId: 'kid-c9333a86-208f-468a-93f6-c6c706a13148' } 💾 Counter updated in memory. { count: 41 } => count = 42 🐱 → 📄: Streaming HTML <div data-kitten-component id="kid-c9333a86-208f-468a-93f6-c6c706a13148" hx-swap-oob="morph" hx-ext="morph"> <div aria-live="assertive">42</div> <button name="update" aria-label="decrement" ws-send hx-ext="ws" hx-vals="js:{value: -1}">-</button> <button name="update" aria-label="increment" ws-send hx-ext="ws" hx-vals="js:{value: 1}">+</button> <style inline>@scope { div { font-size: 3em; margin: 0.25em 0; } }</style> </div> 💾 Counter table update. kitten.db.counter.count = 42 Persisted as: '_[[`count`]] = 42;\n'

Small Web: computer science colloquium at University of Groningen

Download the video and watch it with your favourite video player. Recording1 of the live stream of a computer science colloquium on the Small Web I presented at the University of Groningen on June 11th, 2024.
Aral Balkan
#dev #web #SmallWeb #kitten #statefulcomponents #streaminghtml #hypertext #websockets

⇧