@the-w1zard/the-cloud 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+
+<div align="left" style="position: relative;">
+<img src="./icons/gandalf.png" align="right" width="30%" style="margin: -20px 0 0 20px;">
+
+<h3>THE-CLOUD: <span style="font-size:18px;">I don't know how it works... it's just... like, you know... the cloud... fuck off.</span></h3>
+
+<p align="left"><em>The most opinionated platform... ever.</em></p>
+<p align="left"><em>Trust me... I'm a fucking wizard... 🧙</em></p>ON USER USAGE PATH!-95ED27?style=flat">
+<p align="left">VSCode ext:</p>
+<p align="left">
+<img src="https://img.shields.io/badge/THEMES- 251-95ED27?style=flat">
+<img src="https://img.shields.io/badge/SIDEBARS- 160+-95ED27?style=flat">
+<img src="https://img.shields.io/badge/PRODUCT ICONS- 651-95ED27?style=flat">
+<img src="https://img.shields.io/badge/FILE ICONS- 454-95ED27?style=flat">
+<img src="https://img.shields.io/badge/VSCode Extentions- 82+-95ED27?style=flat">
+<img src="https://img.shields.io/badge/FEATURES- SHIT TONNE-95ED27?style=flat">
+</p>
+<p align="left">Small but powerful repos worth checking out:</p>
+<p align="left">
+
+<a href="https://github.com/the-w1zard/app_store"><img src="https://img.shields.io/badge/Store / Maelstrom-000000.svg?style=flat&logo=JetBrains&logoColor=white" alt="JetBrains"></a>
+<a href="https://github.com/the-w1zard/dx"><img src="https://img.shields.io/badge/UX /DX-34A853.svg?style=flat&logo=Android&logoColor=white" alt="Android"></a>
+<a href="https://github.com/the-w1zard/temporal_shift"><img src="https://img.shields.io/badge/Temporal Shift-77AA99.svg?style=flat&logo=Org&logoColor=white" alt="Org"></a>
+<a href="https://github.com/the-w1zard/the_cloud"><img src="https://img.shields.io/badge/The Cloud-02303A.svg?style=flat&logo=Gradle&logoColor=white" alt="Gradle"></a>
+<a href="https://github.com/the-w1zard/signals"><img src="https://img.shields.io/badge/Signals-02303A.svg?style=flat&logo=Gradle&logoColor=white" alt="Gradle"></a>
+<img src="https://img.shields.io/badge/Sometimes, my genius... It generates gravity.-4285F4.svg?style=flat&logo=🧙&logoColor=white" alt="Google">
+<a href="https://github.com/the-w1zard"><img src="https://img.shields.io/badge/Coming Soon: The Wizard Platform-7F52FF.svg?style=flat&logo=Kotlin&logoColor=white" alt="Kotlin"></a>
+<a href="https://github.com/the-w1zard"><img src="https://img.shields.io/badge/Coming Soon: Hadron Particle Disruptor-%23ED8B00.svg?style=flat&logo=openjdk&logoColor=white" alt="java"></a>
+</p>
+<p align="left">The goal? To remove all friction, from everything.</p>
+
+</div>
+<br clear="right">
+
+> [!NOTE]
+> 
+

package/dist/hooks/callback.d.ts

@@ -0,0 +1 @@
+export declare function useCallback<T extends (...args: A[]) => A>(callback: T, deps?: A[], __sauron_id__?: string): T;

package/dist/hooks/callback.js

@@ -0,0 +1,13 @@
+export function useCallback(callback, deps, __sauron_id__ = _sid()) {
+    return createHook('useCallback', __sauron_id__, () => ({ value: undefined, callback, deps: deps ?? [] }), (s) => {
+        const state = s;
+        const hasChanged = !deps ||
+            deps.length !== state.deps.length ||
+            deps.some((d, i) => d !== state.deps[i]);
+        if (hasChanged) {
+            state.callback = callback;
+            state.deps = deps ?? [];
+        }
+        return state.callback;
+    });
+}

package/dist/hooks/compose-event-handlers.d.ts

@@ -0,0 +1,10 @@
+export {};
+/**
+
+export function composeEventHandlers1(theirHandler, ourHandler) {
+  return (event) => {
+    theirHandler?.(event);
+    if (!event.defaultPrevented) ourHandler(event);
+  };
+}
+ */

package/dist/hooks/compose-event-handlers.js

@@ -0,0 +1,10 @@
+export {};
+/**
+
+export function composeEventHandlers1(theirHandler, ourHandler) {
+  return (event) => {
+    theirHandler?.(event);
+    if (!event.defaultPrevented) ourHandler(event);
+  };
+}
+ */

package/dist/hooks/core/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/core/index.js

@@ -0,0 +1 @@
+export {};

package/dist/hooks/core/use-id.d.ts

@@ -0,0 +1 @@
+export declare function useId(__sauron_id__?: string): string;

package/dist/hooks/core/use-id.js

@@ -0,0 +1,4 @@
+import { createHook, getCurrentComponent, subscribeToHook, notifyHook } from '#the-cloud';
+export function useId(__sauron_id__ = _sid()) {
+    return createHook('useId', __sauron_id__, () => ({ value: `sid-${__sauron_id__}` }), (state) => state.value);
+}

package/dist/hooks/core/use-reducer.d.ts

@@ -0,0 +1 @@
+export declare function useReducer<S, A>(reducer: (state: S, action: A) => S, initial: S, __sauron_id__?: string): [S, (action: A) => void];

package/dist/hooks/core/use-reducer.js

@@ -0,0 +1,14 @@
+import { createHook, getCurrentComponent, subscribeToHook, notifyHook } from '#the-cloud';
+export function useReducer(reducer, initial, __sauron_id__ = _sid()) {
+    return createHook('useReducer', __sauron_id__, () => ({ value: initial }), (state, key, notify) => {
+        const dispatch = (action) => {
+            const next = reducer(state.value, action);
+            if (Object.is(state.value, next))
+                return;
+            state.value = next;
+            notify(key);
+            return next;
+        };
+        return [state.value, dispatch];
+    });
+}

package/dist/hooks/core/use-ref.d.ts

@@ -0,0 +1,92 @@
+export interface RefHandle<T = any> {
+    current: T;
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (callback: (value: T) => void) => () => void;
+    isAttached: boolean;
+    waitForAttach: (timeout?: number) => Promise<T>;
+}
+export interface MutableRefObject<T = any> {
+    current: T;
+}
+export type RefCallback<T = any> = (instance: T) => void;
+export type ForwardedRef<T = any> = ((instance: T) => void) | MutableRefObject<T>;
+export type FowardRef<T = any> = ((instance: T) => void) | {
+    current: T;
+};
+export interface RefHandle<T = any> {
+    current: T;
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (callback: (value: T) => void) => () => void;
+    isAttached: boolean;
+    waitForAttach: (timeout?: number) => Promise<T>;
+    toReact: () => MutableRefObject<T>;
+    toCallback: () => RefCallback<T>;
+}
+export type AnyRef<T = any> = RefHandle<T> | ForwardedRef<T> | MutableRefObject<T> | RefCallback<T> | {
+    current: T;
+} | ((instance: T) => void);
+export declare function useRef<T = any>(initialValue?: T, __sauron_id__?: string): RefHandle<T>;
+export type Ref<T> = RefHandle<T>;
+export type PossibleRef<T> = Ref<T> | undefined;
+export declare function useComposedRefs<T = any>(...refs: PossibleRef<T>[]): RefCallback<T>;
+export declare function composeRefs1<T = any>(...refs: (RefHandle<T> | ((instance: T) => void))[]): (instance: T) => void;
+export declare function composeRefs<T = any>(...refs: PossibleRef<T>[]): RefCallback<T>;
+export interface RefForwardingOptions {
+    autoAttach?: boolean;
+    validate?: (target: any) => boolean;
+    transform?: <T, R>(value: T) => R;
+}
+export declare function createRefForwarder<T = any, P extends object = {}>(render: (props: P, ref: RefHandle<T>) => any, options?: RefForwardingOptions): (props: P & {
+    ref?: RefHandle<T> | ((instance: T) => void) | {
+        current: T;
+    };
+}) => any;
+export declare function useDomRef<T extends HTMLElement = HTMLElement>(): {
+    measure: () => {
+        width: number;
+        height: number;
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+        scrollWidth: number;
+        scrollHeight: number;
+        scrollTop: number;
+        scrollLeft: number;
+    } | null;
+    focus: (options?: FocusOptions) => void;
+    blur: () => void;
+    click: () => void;
+    scrollIntoView: (options?: ScrollIntoViewOptions) => void;
+    useMeasure: () => void;
+    current: T;
+    get: () => T;
+    set: (value: T) => void;
+    subscribe: (callback: (value: T) => void) => () => void;
+    isAttached: boolean;
+    waitForAttach: (timeout?: number) => Promise<T>;
+    toReact: () => MutableRefObject<T>;
+    toCallback: () => RefCallback<T>;
+};
+export declare function forwardRef<T = any, P = {}>(render: (props: P, ref: ForwardedRef<T>) => any): ((props: P & {
+    ref?: ForwardedRef<T>;
+}) => any) & {
+    displayName?: string;
+};
+export declare function mergeAnyRefs<T = any>(...refs: Array<AnyRef<T> | undefined>): RefCallback<T>;
+export declare function useReactRef<T = any>(ref: ForwardedRef<T>): RefHandle<T>;
+export declare function toReactRef<T = any>(handle: RefHandle<T>): MutableRefObject<T>;
+export declare function mergeForwardRefs<T = any>(...refs: (FowardRef<T> | undefined)[]): (instance: T) => void;
+export declare function useForwardedRef<T = any>(forwardedRef: FowardRef<T>): {
+    current: T;
+};
+export declare function createForwardRef<T = any>(): {
+    current: T | null;
+};
+export declare function isForwardRefObject(ref: any): ref is {
+    current: any;
+};
+export declare function isForwardRefCallback(ref: any): ref is (instance: any) => void;
+export declare const UNDEFINED_VOID_ONLY: symbol;