@ecopages/radiant 0.1.8 → 0.3.0-alpha.0

package/dist/decorators/standard/event.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "44A9F99057647C9664756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/on-event.d.ts

@@ -0,0 +1,17 @@
+import type { OnEventConfig } from '../on-event';
+import type { Method } from '../../types';
+/**
+ * A decorator to subscribe to an event on the target element.
+ * The event listener will be automatically unsubscribed when the element is disconnected.
+ *
+ * Note: This decorator uses event delegation, which means it relies on event bubbling.
+ * Therefore, it will not work with events that do not bubble, such as `focus`, `blur`, `load`, `unload`, `scroll`, etc.
+ * For focus and blur events, consider using `focusin` and `focusout` which are similar but do bubble.
+ *
+ * @param eventConfig The event configuration.
+ * @param eventConfig.selectors The CSS selector(s) of the target element(s).
+ * @param eventConfig.ref The data-ref attribute of the target element.
+ * @param eventConfig.type The type of the event to listen for.
+ * @param eventConfig.options Optional. An options object that specifies characteristics about the event listener.
+ */
+export declare function onEvent(eventConfig: OnEventConfig): <T extends Method>(originalMethod: T, context: ClassMethodDecoratorContext) => void;

package/dist/decorators/standard/on-event.js

@@ -0,0 +1,3 @@
+import{Ka as a}from"../../chunk-aajhkdmn.js";import"../../chunk-nw171z6m.js";import"../../chunk-8xy18qmz.js";export{a as onEvent};
+
+//# debugId=1CE0D0BAC2B43DEF64756E2164756E21

package/dist/decorators/standard/on-event.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "1CE0D0BAC2B43DEF64756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/on-updated.d.ts

@@ -0,0 +1,2 @@
+import type { Method } from '../../types';
+export declare function onUpdated(keyOrKeys: string | string[]): <T extends Method>(_: T, context: ClassMethodDecoratorContext) => void;

package/dist/decorators/standard/on-updated.js

@@ -0,0 +1,3 @@
+import{Ea as a}from"../../chunk-qdj6r8jn.js";import"../../chunk-8xy18qmz.js";export{a as onUpdated};
+
+//# debugId=6E66A90072456F1164756E2164756E21

package/dist/decorators/standard/on-updated.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "6E66A90072456F1164756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/query-slot.d.ts

@@ -0,0 +1,8 @@
+import type { QuerySlotConfig } from '../query-slot';
+type SlotQueryHost = HTMLElement & {
+    getSlotElement<T extends Element = Element>(name?: string): T | null;
+    getSlotElements<T extends Element = Element>(name?: string): T[];
+    slotProjectionVersion?: number;
+};
+export declare function querySlot(options?: QuerySlotConfig): <T extends SlotQueryHost, V extends Element | Element[]>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;
+export {};

package/dist/decorators/standard/query-slot.js

@@ -0,0 +1,3 @@
+import{ba as a}from"../../chunk-bmhn4nbp.js";import"../../chunk-qd28hvdx.js";import"../../chunk-8xy18qmz.js";export{a as querySlot};
+
+//# debugId=ECBF886B4487E02764756E2164756E21

package/dist/decorators/standard/query-slot.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "ECBF886B4487E02764756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/query.d.ts

@@ -0,0 +1,2 @@
+import type { QueryConfig } from '../query';
+export declare function query(options: QueryConfig): <T extends HTMLElement, V extends Element | Element[]>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;

package/dist/decorators/standard/query.js

@@ -0,0 +1,3 @@
+import{ja as a}from"../../chunk-scfk041e.js";import"../../chunk-g0gz7ypq.js";import"../../chunk-8xy18qmz.js";export{a as query};
+
+//# debugId=6E6550A38865ECFB64756E2164756E21

package/dist/decorators/standard/query.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "6E6550A38865ECFB64756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/reactive-field.d.ts

@@ -0,0 +1,2 @@
+import type { RadiantElement } from '../../core/radiant-element';
+export declare function reactiveField<T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>): (this: T, value: V) => V;

package/dist/decorators/standard/reactive-field.js

@@ -0,0 +1,3 @@
+import{va as a}from"../../chunk-paehjz94.js";import"../../chunk-8xy18qmz.js";export{a as reactiveField};
+
+//# debugId=60DDF85D2820FBCB64756E2164756E21

package/dist/decorators/standard/reactive-field.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "60DDF85D2820FBCB64756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/reactive-prop.d.ts

@@ -0,0 +1,2 @@
+import type { RadiantElement, ReactivePropertyOptions } from '../../core/radiant-element.js';
+export declare function reactiveProp<P = unknown>({ type, attribute, reflect, defaultValue, bind, }: ReactivePropertyOptions<P>): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => (this: T, value: V) => V;

package/dist/decorators/standard/reactive-prop.js

@@ -0,0 +1,3 @@
+import{ea as a}from"../../chunk-dscj0sk9.js";import"../../chunk-8dexhy6c.js";import"../../chunk-73x7jpdd.js";import"../../chunk-8xy18qmz.js";export{a as reactiveProp};
+
+//# debugId=0EABDF8EE7B254AC64756E2164756E21

package/dist/decorators/standard/reactive-prop.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "0EABDF8EE7B254AC64756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/signal.d.ts

@@ -0,0 +1,33 @@
+import type { WritableSignal } from '@ecopages/signals';
+import type { RadiantElement, ReactiveBindingOption } from '../../core/radiant-element';
+import type { AttributeTypeConstant } from '../../utils/attribute-utils';
+/** Options for the `@signal` decorator. */
+export type SignalDecoratorOptions<Value = unknown> = {
+    /**
+     * Exposes a JSX binding companion for the decorated signal.
+     *
+     * - `true` creates a `$propertyName` accessor.
+     * - a string creates a custom accessor with that name.
+     * - `undefined` defers to the host default.
+     */
+    bind?: ReactiveBindingOption;
+    /**
+     * Optional initial value used when the field does not provide one directly.
+     *
+     * This is primarily useful with `declare field: WritableSignal<T>` syntax,
+     * which keeps the component surface clean while still letting the decorator
+     * own signal construction.
+     */
+    initial?: Value;
+    /**
+     * Connects an existing writable signal to the host instead of creating a
+     * host-owned one.
+     */
+    source?: WritableSignal<Value> | ((host: RadiantElement) => WritableSignal<Value>);
+    /**
+     * Serializes the current signal value into a keyed hydration script during
+     * SSR and restores it on the client.
+     */
+    hydrate?: AttributeTypeConstant;
+};
+export declare function signal<Value = unknown>(options?: SignalDecoratorOptions<Value>): <T extends RadiantElement, Value_1>(_: undefined, context: ClassFieldDecoratorContext<T, unknown>) => (this: T, initialValue: Value_1) => WritableSignal<Value_1>;

package/dist/decorators/standard/signal.js

@@ -0,0 +1,3 @@
+import{ma as a}from"../../chunk-5a2xez36.js";import"../../chunk-57w3vmme.js";import"../../chunk-6z34stya.js";import"../../chunk-ksv01cey.js";import"../../chunk-8n2dhx28.js";import"../../chunk-8xy18qmz.js";export{a as signal};
+
+//# debugId=58655E87B447B74864756E2164756E21

package/dist/decorators/standard/signal.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "58655E87B447B74864756E2164756E21",
+  "names": []
+}

package/dist/decorators/state.d.ts

@@ -0,0 +1,11 @@
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+/**
+ * Declares internal mutable component state.
+ *
+ * Each write triggers `notifyUpdate` so update callbacks, bindings, and
+ * `RadiantComponent` renders stay in sync. When no explicit binding option
+ * is supplied, `RadiantComponent` hosts expose a JSX companion binding
+ * accessor automatically while plain `RadiantElement` hosts keep binding
+ * opt-in.
+ */
+export declare function state(protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'], nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext']): any;

package/dist/decorators/state.js

@@ -0,0 +1,3 @@
+import{ta as a}from"../chunk-4fqkmpra.js";import"../chunk-t7a1bbxq.js";import"../chunk-paehjz94.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-8xy18qmz.js";export{a as state};
+
+//# debugId=376024D3AC8A771964756E2164756E21

package/dist/decorators/state.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "376024D3AC8A771964756E2164756E21",
+  "names": []
+}

package/dist/helpers/create-event-listener.d.ts

@@ -0,0 +1,28 @@
+import type { RadiantElement } from '../core/radiant-element';
+import type { RadiantElementEventListener } from '../core/radiant-element';
+/**
+ * Selects which DOM tree delegated event listeners should observe.
+ */
+export type OnEventScope = 'light' | 'shadow' | 'both';
+type BaseOnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & {
+    scope?: OnEventScope;
+};
+export type OnEventConfig = BaseOnEventConfig & ({
+    selector: string;
+} | {
+    ref: string;
+} | {
+    window: true;
+} | {
+    document: true;
+});
+/**
+ * Subscribes to a DOM event with delegation, window, or document targeting.
+ * Functional equivalent of the `@onEvent` decorator for vanilla JS usage.
+ * Returns a cleanup function to remove the listener.
+ * @param host The host RadiantElement.
+ * @param config The event listener configuration.
+ * @param callback The event handler function.
+ */
+export declare function createEventListener(host: RadiantElement, config: OnEventConfig, callback: (event: Event) => void): () => void;
+export {};

package/dist/helpers/create-event-listener.js

@@ -0,0 +1,3 @@
+import{tb as a}from"../chunk-nw171z6m.js";import"../chunk-8xy18qmz.js";export{a as createEventListener};
+
+//# debugId=01C2154F53A8DE8F64756E2164756E21

package/dist/helpers/create-event-listener.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "01C2154F53A8DE8F64756E2164756E21",
+  "names": []
+}

package/dist/helpers/create-event.d.ts

@@ -0,0 +1,9 @@
+import type { RadiantElement } from '../core/radiant-element';
+import { EventEmitter, type EventEmitterConfig } from '../tools/event-emitter';
+/**
+ * Creates an EventEmitter bound to a host element and registers it on the host.
+ * Functional equivalent of the `@event` decorator for vanilla JS usage.
+ * @param host The host element that will dispatch the events.
+ * @param config {@link EventEmitterConfig} The event emitter configuration.
+ */
+export declare function createEvent<T = unknown>(host: RadiantElement, config: EventEmitterConfig): EventEmitter<T>;

package/dist/helpers/create-event.js

@@ -0,0 +1,3 @@
+import{ob as a}from"../chunk-42tyhfvh.js";import"../chunk-qbnedp0y.js";import"../chunk-8xy18qmz.js";export{a as createEvent};
+
+//# debugId=1463A20FBFE4872164756E2164756E21

package/dist/helpers/create-event.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "1463A20FBFE4872164756E2164756E21",
+  "names": []
+}

package/dist/helpers/create-query-slot.d.ts

@@ -0,0 +1,20 @@
+export type QuerySlotConfig = {
+    all?: boolean;
+    cache?: boolean;
+    name?: string;
+};
+type SlotQueryHost = HTMLElement & {
+    getSlotElement<T extends Element = Element>(name?: string): T | null;
+    getSlotElements<T extends Element = Element>(name?: string): T[];
+};
+type QuerySlotResult<T extends Element | Element[]> = {
+    get value(): T | null;
+};
+/**
+ * Creates a lazy slot query accessor bound to a host element.
+ * Functional equivalent of the `@querySlot` decorator for vanilla JS usage.
+ * @param host The host element to query slots within.
+ * @param options {@link QuerySlotConfig} The slot query configuration.
+ */
+export declare function createQuerySlot<T extends Element | Element[] = Element>(host: SlotQueryHost, options?: QuerySlotConfig): QuerySlotResult<T>;
+export {};

package/dist/helpers/create-query-slot.js

@@ -0,0 +1,3 @@
+import{rb as a}from"../chunk-qd28hvdx.js";import"../chunk-8xy18qmz.js";export{a as createQuerySlot};
+
+//# debugId=B3214DFAE4E3C8F564756E2164756E21

package/dist/helpers/create-query-slot.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "B3214DFAE4E3C8F564756E2164756E21",
+  "names": []
+}

package/dist/helpers/create-query.d.ts

@@ -0,0 +1,27 @@
+type BaseQueryConfig = {
+    all?: boolean;
+    cache?: boolean;
+    scope?: QueryScope;
+};
+type QueryBySelector = {
+    selector: string;
+};
+type QueryByRef = {
+    ref: string;
+};
+/**
+ * Selects which DOM tree a query should read from.
+ */
+export type QueryScope = 'light' | 'shadow' | 'both';
+export type QueryConfig = BaseQueryConfig & (QueryBySelector | QueryByRef);
+type QueryResult<T extends Element | Element[]> = {
+    get value(): T | null;
+};
+/**
+ * Creates a lazy DOM query accessor bound to a host element.
+ * Functional equivalent of the `@query` decorator for vanilla JS usage.
+ * @param host The host element to query within.
+ * @param options {@link QueryConfig} The query configuration.
+ */
+export declare function createQuery<T extends Element | Element[] = Element>(host: HTMLElement, options: QueryConfig): QueryResult<T>;
+export {};

package/dist/helpers/create-query.js

@@ -0,0 +1,3 @@
+import{sb as a}from"../chunk-g0gz7ypq.js";import"../chunk-8xy18qmz.js";export{a as createQuery};
+
+//# debugId=3C84805D88DEA21764756E2164756E21

package/dist/helpers/create-query.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "3C84805D88DEA21764756E2164756E21",
+  "names": []
+}

package/dist/helpers/debounce.d.ts

@@ -0,0 +1,39 @@
+import type { Method } from '../types';
+/**
+ * A debounced function with imperative helpers for controlling pending work.
+ *
+ * @typeParam T The wrapped callback type.
+ */
+export interface DebouncedFunction<T extends Method> {
+    (...args: Parameters<T>): void;
+    /**
+     * Cancels the pending callback invocation, if one exists.
+     */
+    cancel(): void;
+    /**
+     * Immediately invokes the latest pending callback invocation.
+     *
+     * @returns The callback result when a call is pending, or the last completed
+     * result when no call is pending.
+     */
+    flush(): ReturnType<T> | undefined;
+    /**
+     * Reports whether the callback currently has a scheduled invocation.
+     *
+     * @returns True when a call is pending.
+     */
+    pending(): boolean;
+}
+/**
+ * Creates a debounced wrapper around a function.
+ *
+ * The returned function delays invocation until the configured timeout has
+ * elapsed since the latest call. It also exposes helpers to cancel, flush,
+ * and inspect pending work.
+ *
+ * @typeParam T The wrapped callback type.
+ * @param callback The callback to debounce.
+ * @param timeout The debounce timeout in milliseconds.
+ * @returns A debounced wrapper around the callback.
+ */
+export declare function debounce<T extends Method>(callback: T, timeout: number): DebouncedFunction<T>;

package/dist/helpers/debounce.js

@@ -0,0 +1,3 @@
+import{qb as a}from"../chunk-13ydx769.js";import"../chunk-8xy18qmz.js";export{a as debounce};
+
+//# debugId=F389D09E6FA1B23464756E2164756E21

package/dist/helpers/debounce.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "F389D09E6FA1B23464756E2164756E21",
+  "names": []
+}

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export * from './create-query';
+export * from './create-query-slot';
+export * from './create-event';
+export * from './create-event-listener';
+export * from './debounce';

package/dist/helpers/index.js

@@ -0,0 +1,3 @@
+import{ob as x}from"../chunk-42tyhfvh.js";import"../chunk-qbnedp0y.js";import{qb as t}from"../chunk-13ydx769.js";import{rb as c}from"../chunk-qd28hvdx.js";import{sb as b}from"../chunk-g0gz7ypq.js";import{tb as a}from"../chunk-nw171z6m.js";import"../chunk-8xy18qmz.js";export{t as debounce,c as createQuerySlot,b as createQuery,a as createEventListener,x as createEvent};
+
+//# debugId=1A8607ADDD869B3264756E2164756E21

package/dist/helpers/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "1A8607ADDD869B3264756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -1,6 +1,24 @@
-export * from './core';
-export * from './decorators';
-export * from './context';
-export * from './mixins';
-export * from './tools';
-export * from './utils';
+export * from './core/radiant-element';
+export * from './core/radiant-component';
+export * from './core/reactive-jsx-value';
+export * from './decorators/bound';
+export * from './decorators/custom-element';
+export * from './decorators/debounce';
+export * from './decorators/event';
+export * from './decorators/on-event';
+export * from './decorators/on-updated';
+export * from './decorators/prop';
+export * from './decorators/query';
+export * from './decorators/query-slot';
+export * from './decorators/signal';
+export * from './decorators/state';
+export * from './context/context-provider';
+export * from './context/create-context';
+export * from './context/decorators/consume-context';
+export * from './context/decorators/context-selector';
+export * from './context/decorators/on-context-update';
+export * from './context/decorators/provide-context';
+export * from './helpers/create-query';
+export * from './helpers/create-query-slot';
+export * from './helpers/create-event';
+export * from './helpers/create-event-listener';