cleanup

Author: mirkobrombin

docs/articles/essentials/composition.md

@@ -37,9 +37,9 @@ signal when a non-reactive value is present.
 ```go
 cmp := composition.Wrap(core.NewComponent("Counter", nil, nil))
 count := state.NewSignal(0)
-cmp.Prop("count", count) // Since: Unreleased
+cmp.Prop("count", count)
 
-other := composition.FromProp[int](cmp, "other", 1) // Since: Unreleased
+other := composition.FromProp[int](cmp, "other", 1)
 other.Set(2)
 ```
 
@@ -51,29 +51,17 @@ count := composition.FromProp[int](cmp, "count", 0) // -> 5, Props["count"] rema
 count.Set(6)
 ```
 
-Both helpers are available since *Unreleased*.
-
 ## Event Handlers
 
 Attach functions to DOM events by name. The wrapper forwards handlers to the
 `dom` package:
 
 ```go
 cmp := composition.Wrap(core.NewComponent("Counter", nil, nil))
-cmp.On("save", func() { /* handle save */ }) // Since: Unreleased
+cmp.On("save", func() { /* handle save */ })
 ```
 
-## APIs Used
-
-- `core.NewComponent(name string, templateFS []byte, props map[string]any) *core.HTMLComponent`
-- `composition.Wrap(c *core.HTMLComponent) *composition.Component`
-- `(*composition.Component).Unwrap() *core.HTMLComponent`
-- `(*composition.Component).On(name string, fn func())`
-- `(*composition.Component).Prop(key string, sig *state.Signal[T])`
-- `composition.FromProp[T any](c *composition.Component, key string, def T) *state.Signal[T]`
-- `state.NewSignal(initial T) *state.Signal[T]`
-
-## End-to-End Example
+## Example
 
 ```go
 hc := core.NewComponent("Hello", nil, nil)
@@ -206,4 +194,3 @@ Undo/redo handlers work only when the store was created with `state.WithHistory`
 
 - [State history](../api/state#history)
 - [DOM handlers](../api/dom#usage)
-

v1/composition/composition.go

@@ -35,8 +35,6 @@ func Wrap(c *core.HTMLComponent) *Component {
 func (c *Component) Unwrap() *core.HTMLComponent { return c.HTMLComponent }
 
 // On registers fn under name in the DOM handler registry.
-//
-// Since: Unreleased.
 func (c *Component) On(name string, fn func()) {
 	if name == "" {
 		panic("composition.On: empty name")
@@ -50,8 +48,6 @@ func (c *Component) On(name string, fn func()) {
 // Prop associates a reactive signal with the component under the provided key.
 // The signal is stored in the "composition" state namespace and added to the
 // component's props.
-//
-// Since: Unreleased.
 func (c *Component) Prop(key string, sig signalAny) {
 	if key == "" {
 		panic("composition.Prop: empty key")
@@ -81,8 +77,6 @@ func (c *Component) Prop(key string, sig signalAny) {
 }
 
 // OnUnmount cleans up the composition store when the component is removed.
-//
-// Since: Unreleased.
 func (c *Component) OnUnmount() {
 	for name := range c.createdStores {
 		state.GlobalStoreManager.UnregisterStore(c.ID, name)
@@ -98,8 +92,6 @@ func (c *Component) OnUnmount() {
 // holds a plain value matching T, the value is wrapped in a new signal. If the
 // value type is incompatible, FromProp panics. When the prop is missing, a new
 // signal seeded with def is created.
-//
-// Since: Unreleased.
 func FromProp[T any](c *Component, key string, def T) *state.Signal[T] {
 	if key == "" {
 		panic("composition.FromProp: empty key")

v1/composition/store.go

@@ -8,8 +8,6 @@ import (
 )
 
 // Store creates a new state store namespaced to the component's ID.
-//
-// Since: Unreleased.
 func (c *Component) Store(name string, opts ...state.StoreOption) *state.Store {
 	if name == "" {
 		panic("composition.Store: empty name")
@@ -25,8 +23,6 @@ func (c *Component) Store(name string, opts ...state.StoreOption) *state.Store {
 
 // History registers undo and redo handlers for the provided store.
 // `undo` and `redo` are the handler names used in the template.
-//
-// Since: Unreleased.
 func (c *Component) History(s *state.Store, undo, redo string) {
 	if s == nil {
 		panic("composition.History: nil store")

v1/state/store.go

@@ -119,8 +119,6 @@ func (sm *StoreManager) GetStore(module, name string) *Store {
 
 // UnregisterStore removes the store identified by module and name.
 // If the store or module does not exist, it is a no-op.
-//
-// Since: Unreleased.
 func (sm *StoreManager) UnregisterStore(module, name string) {
 	if stores, ok := sm.modules[module]; ok {
 		delete(stores, name)