@typed/ui 1.0.0-beta.6 → 1.0.0-beta.7

package/dist/Popover.d.ts

@@ -13,7 +13,7 @@ import type { HostResult } from "./Dom/Types.js";
  * ## Ownership and lifetime
  * Plain data retains no resources; RefSubject lifetime is Scope-owned.
  * @since 1.0.0
- * @category state
+ * @category Open state
  */
 export interface State {
     /** Whether native popover content should be open.
@@ -23,7 +23,7 @@ export interface State {
      * ## Ownership and lifetime
      * Plain state acquires no resources.
      * @since 1.0.0
-     * @category state
+     * @category Open state
      */
     readonly open: boolean;
 }
@@ -34,7 +34,7 @@ export interface State {
  * ## Ownership and lifetime
  * Configuration is inert.
  * @since 1.0.0
- * @category state
+ * @category Open state
  */
 export interface InitialState {
     /** Initial open state, defaulting to false.
@@ -44,7 +44,7 @@ export interface InitialState {
      * ## Ownership and lifetime
      * Plain data retains no resources.
      * @since 1.0.0
-     * @category state
+     * @category Open state
      */
     readonly open?: boolean;
 }
@@ -55,7 +55,7 @@ export interface InitialState {
  * ## Ownership and lifetime
  * The immutable schema acquires no resources.
  * @since 1.0.0
- * @category schemas
+ * @category Open state
  */
 export declare const StateSchema: Schema.Struct<{
     readonly open: Schema.Boolean;
@@ -76,7 +76,7 @@ export declare const StateSchema: Schema.Struct<{
  * })
  * ```
  * @since 1.0.0
- * @category constructors
+ * @category Open state
  */
 export declare function makeState(initial?: InitialState): Effect.Effect<RefSubject.HydratedRefSubject<{
     readonly open: boolean;
@@ -99,7 +99,7 @@ export declare function makeState(initial?: InitialState): Effect.Effect<RefSubj
  * })
  * ```
  * @since 1.0.0
- * @category state
+ * @category Open state
  */
 export declare function setOpen<E, R>(state: RefSubject.RefSubject<State, E, R>, open: boolean): Effect.Effect<State, E, R>;
 /** Options for the native popover trigger.
@@ -110,7 +110,7 @@ export declare function setOpen<E, R>(state: RefSubject.RefSubject<State, E, R>,
  * ## Ownership and lifetime
  * Options are inert; rendering owns listeners/subscriptions by Scope.
  * @since 1.0.0
- * @category models
+ * @category Opening controls
  */
 export interface TriggerOptions extends Dom.HostOptions<HTMLButtonElement> {
     /** Hydrated state shared with popover content.
@@ -120,7 +120,7 @@ export interface TriggerOptions extends Dom.HostOptions<HTMLButtonElement> {
      * ## Ownership and lifetime
      * The trigger borrows state; its original Scope owns it.
      * @since 1.0.0
-     * @category state
+     * @category State connection
      */
     readonly state: RefSubject.HydratedRefSubject<State, Schema.SchemaError>;
     /** Id of content targeted through native `popovertarget`.
@@ -130,7 +130,7 @@ export interface TriggerOptions extends Dom.HostOptions<HTMLButtonElement> {
      * ## Ownership and lifetime
      * The string is reflected and retains no resources.
      * @since 1.0.0
-     * @category relationships
+     * @category Identity and relationships
      */
     readonly controls?: string;
     /** Visible trigger content and accessible name.
@@ -140,7 +140,7 @@ export interface TriggerOptions extends Dom.HostOptions<HTMLButtonElement> {
      * ## Ownership and lifetime
      * Dynamic content follows the trigger Scope.
      * @since 1.0.0
-     * @category content
+     * @category Rendered content
      */
     readonly content: Renderable.Any;
 }
@@ -172,7 +172,7 @@ type TriggerInternalProps<Options extends TriggerOptions> = ReturnType<ReturnTyp
  * })
  * ```
  * @since 1.0.0
- * @category components
+ * @category Opening controls
  */
 export declare function Trigger<const Options extends TriggerOptions, const Host extends HostResult = never>(options: Options, host?: Dom.HostOverride<Dom.RenderHostProps<Options, TriggerInternalProps<Options>>, Options["content"], Host>): Fx<RenderEvent, Renderable.Error<Options | Host>, Renderable.Services<Options | Host> | Scope.Scope | RenderTemplate>;
 /** Options for manually controlled native popover content.
@@ -182,7 +182,7 @@ export declare function Trigger<const Options extends TriggerOptions, const Host
  * ## Ownership and lifetime
  * Options are inert; rendering owns the native ref and subscriptions by Scope.
  * @since 1.0.0
- * @category models
+ * @category Native content host
  */
 export interface ContentOptions extends Dom.HostOptions<HTMLDivElement> {
     /** Hydrated state synchronized with native popover visibility.
@@ -192,7 +192,7 @@ export interface ContentOptions extends Dom.HostOptions<HTMLDivElement> {
      * ## Ownership and lifetime
      * The content borrows the state; its original Scope owns it.
      * @since 1.0.0
-     * @category state
+     * @category State connection
      */
     readonly state: RefSubject.HydratedRefSubject<State, Schema.SchemaError>;
     /** Content rendered in the top layer.
@@ -202,14 +202,13 @@ export interface ContentOptions extends Dom.HostOptions<HTMLDivElement> {
      * ## Ownership and lifetime
      * Dynamic content follows the content Scope.
      * @since 1.0.0
-     * @category content
+     * @category Rendered content
      */
     readonly content: Renderable.Any;
 }
 declare function contentInternalProps<const Options extends ContentOptions>(options: Options): () => {
     readonly popover: "manual";
     readonly onkeydown: EventHandler.EventHandler<KeyboardEvent, Schema.SchemaError, never>;
-    readonly onbeforetoggle: EventHandler.EventHandler<Event, Schema.SchemaError, never>;
     readonly ontoggle: EventHandler.EventHandler<Event, Schema.SchemaError, never>;
     readonly ref: import("./Dom/Refs.js").ComposedRef<RefSubject.HydratedRefSubject<State, Schema.SchemaError, never, never>, (element: HTMLElement) => Effect.Effect<void, Schema.SchemaError, Scope.Scope>> | undefined;
 };
@@ -218,10 +217,10 @@ type ContentInternalProps<Options extends ContentOptions> = ReturnType<ReturnTyp
  * @remarks
  * ## Why
  * The component delegates top-layer lifecycle to the Popover API, synchronizes
- * real `beforetoggle`/`toggle` events, and handles Escape through native events.
+ * completed `toggle` events, and handles Escape through native events.
  * ## Ownership and lifetime
  * Running the Fx owns listeners and the NativePopover observer in its Effect
- * Scope. A custom host must preserve `popover="manual"`, toggle handlers, and
+ * Scope. A custom host must preserve `popover="manual"`, the toggle handler, and
  * the single composed hydration ref.
  * @example
  * ```ts
@@ -234,7 +233,7 @@ type ContentInternalProps<Options extends ContentOptions> = ReturnType<ReturnTyp
  * })
  * ```
  * @since 1.0.0
- * @category components
+ * @category Native content host
  */
 export declare function Content<const Options extends ContentOptions, const Host extends HostResult = never>(options: Options, host?: Dom.HostOverride<Dom.RenderHostProps<Options, ContentInternalProps<Options>>, Options["content"], Host>): Fx<RenderEvent, Renderable.Error<Options | Host>, Renderable.Services<Options | Host> | Scope.Scope | RenderTemplate>;
 export {};

package/dist/Popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../src/Popover.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../src/Popover.ts"],"names":[],"mappings":"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"}

package/dist/Popover.js

@@ -11,7 +11,7 @@ import * as NativePopover from "./NativePopover.js";
  * ## Ownership and lifetime
  * The immutable schema acquires no resources.
  * @since 1.0.0
- * @category schemas
+ * @category Open state
  */
 export const StateSchema = Schema.Struct({ open: Schema.Boolean });
 /** Creates hydrated popover state.
@@ -30,7 +30,7 @@ export const StateSchema = Schema.Struct({ open: Schema.Boolean });
  * })
  * ```
  * @since 1.0.0
- * @category constructors
+ * @category Open state
  */
 export function makeState(initial = {}) {
     return RefSubject.hydrate(StateSchema, { open: initial.open ?? false });
@@ -53,7 +53,7 @@ export function makeState(initial = {}) {
  * })
  * ```
  * @since 1.0.0
- * @category state
+ * @category Open state
  */
 export function setOpen(state, open) {
     return RefSubject.update(state, (current) => ({ ...current, open }));
@@ -93,7 +93,7 @@ function triggerInternalProps(options) {
  * })
  * ```
  * @since 1.0.0
- * @category components
+ * @category Opening controls
  */
 export function Trigger(options, host) {
     return Dom.renderHost()(options, host, triggerInternalProps(options), options.content, (props, content) => html `<button ...${props}>${content}</button>`);
@@ -107,7 +107,6 @@ function contentInternalProps(options) {
             event.preventDefault();
             yield* setOpen(options.state, false);
         })),
-        onbeforetoggle: EventHandler.make(Effect.fn((event) => setOpen(options.state, Dom.toggleState(event) === "open"))),
         ontoggle: EventHandler.make(Effect.fn((event) => setOpen(options.state, Dom.toggleState(event) === "open"))),
         ref: Dom.composeRefs(options.state, NativePopover.ref(options.state)),
     });
@@ -116,10 +115,10 @@ function contentInternalProps(options) {
  * @remarks
  * ## Why
  * The component delegates top-layer lifecycle to the Popover API, synchronizes
- * real `beforetoggle`/`toggle` events, and handles Escape through native events.
+ * completed `toggle` events, and handles Escape through native events.
  * ## Ownership and lifetime
  * Running the Fx owns listeners and the NativePopover observer in its Effect
- * Scope. A custom host must preserve `popover="manual"`, toggle handlers, and
+ * Scope. A custom host must preserve `popover="manual"`, the toggle handler, and
  * the single composed hydration ref.
  * @example
  * ```ts
@@ -132,7 +131,7 @@ function contentInternalProps(options) {
  * })
  * ```
  * @since 1.0.0
- * @category components
+ * @category Native content host
  */
 export function Content(options, host) {
     return Dom.renderHost()(options, host, contentInternalProps(options), options.content, (props, content) => {