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

package/README.md

@@ -1,3 +1,56 @@
-# 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>
+<p align="left">Platforms stats:</p>
+<p align="left">
+<img src="https://img.shields.io/badge/LINES OF CODE- 10,300,000-95ED27?style=flat">
+<img src="https://img.shields.io/badge/FEATURES- UNKNOWN-95ED27?style=flat">
+<img src="https://img.shields.io/badge/REACTS RULES ON HOOKS- 0-95ED27?style=flat">
+<img src="https://img.shields.io/badge/DISRUPTORS- 18+-95ED27?style=flat">
+<img src="https://img.shields.io/badge/MESSAGE QUEUES- 5-95ED27?style=flat">
+</p>
+<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">
+
+- [![🧙 Alias Types](https://img.shields.io/badge/Alias%20Types-000000.svg?style=flat&logo=typescript&logoColor=white)](https://github.com/the-w1zard/alias_types) <a href="https://www.npmjs.com/package/@the-w1zard/alias_types"><img src="./icons/npm.png" alt="alias_types" width="20" height="20"></a>
+- [![🧙 The Cloud](https://img.shields.io/badge/%F0%9F%A7%99%20App%20Store-000000.svg?style=flat)](https://github.com/the-w1zard/app_store)  <a href="https://www.npmjs.com/package/@the-w1zard/store"><img src="./icons/npm.png" alt="app_store" width="20" height="20"></a>
+- [![🧙 The Cloud](https://img.shields.io/badge/%F0%9F%A7%99%20DX-95ED27.svg?style=flat)](https://github.com/the-w1zard/dx) <a href="https://www.npmjs.com/package/@the-w1zard/dx"><img src="./icons/npm.png" alt="dx" width="20" height="20"></a>
+- [![🧙 The Cloud](https://img.shields.io/badge/%F0%9F%A7%99%20Temporal%20Shift-77AA99.svg?style=flat)](https://github.com/the-w1zard/temporal_shift) <a href="https://www.npmjs.com/package/@the-w1zard/temporal_shift"><img src="./icons/npm.png" alt="temporal_shift" width="20" height="20"></a>
+- [![🧙 The Cloud](https://img.shields.io/badge/%F0%9F%A7%99%20The%20Cloud-02303A.svg?style=flat)](https://github.com/the-w1zard/the_cloud)  <a href="https://www.npmjs.com/package/@the-w1zard/the-cloud"><img src="./icons/npm.png" alt="app_store" width="20" height="20"></a>
+- [![🧙 SINGULARITY](https://img.shields.io/badge/%F0%9F%A7%99%20SINGULARITY-02303A.svg?style=flat)](https://github.com/the-w1zard)  
+- [![🧙 Sometimes,%20my%20genius...%20It%20generates%20gravity.](https://img.shields.io/badge/%F0%9F%A7%99%20Sometimes,%20my%20genius...%20It%20generates%20gravity.-4285F4.svg?style=flat)](https://github.com/the-w1zard)  
+- [![🧙 The Wizard](https://img.shields.io/badge/%F0%9F%A7%99%20Coming%20Soon:%20The%20Wizard%20Ed.-7F52FF.svg?style=flat)](https://github.com/the-w1zard)  
+- [![🧙 Hadron Particle Disruptor](https://img.shields.io/badge/%F0%9F%A7%99%20Coming%20Soon:%20Hadron%20Particle%20Disruptor-23ED8B00.svg?style=flat)](https://github.com/the-w1zard)  
+</p>
+<p align="left">The goal? To remove all friction, from everything.</p>
+
+</div>
+<br clear="right">
+
+> [!NOTE]
+> Uhhhhmmm... I truly cannot think... of a single solution that ships a reactive foundation, where its just 'plop!' right into, any app really... and you either have a react alternative... that works right alongside react without having to configure or edit anything... OR like in my case its used as one of the foundational building block of the platform.
+>
+> Nevermind the fact that:
+> - Other than my own deps... and ts ofcourse, there is no deps. The only reason I moved them out of module was because I wanted thme in other modules I was making. So this is a VERY very lean foundation.
+> - It ships with... how many hooks? I don't even know... didn't count to the exact amount but 150ish, with A LOT more to come. The platform will have EVEN MORE because of their req's, to which I won't be able to include them here.
+> - The only... literally... the only hooks... whatever you can name, solution, module, library WHATEVER really, in the industry at the time of writing, that does NOT ABIDE BY REACTS RULES ON HOOKS, despite the fact that you can LITERALLY place these hooks RIGHT FUCKING BESIDE reacts hooks and they work... And they work in any react based app. ( I've also been thinking about making a module out of... how I can turn a platform from having 0 compatibility to 100% compatibility in terms of every react based platforms node module ecosystem. Truly... not joking. Because this is a fucking pain in the dick, expecially considering there is no room for errors with this one. )
+> - The hooks run in module space, in loops and in conditionals
+> - Dspite actually being signals based, there is no mention of it anywhere. 
+> - A secret that I will drop... because it has really changed how I go about code whenever it can be used... The nested map fn ie the quad tiered scoped channel format... If any dev came up to me and asked for one piece of advice that could instantly turn their game around that wasn't some sort of philosophical thing, or just work harder man... this would be it, hands down. 
+>
+> At the time of release, this is only meant for the wizards platform. In order for this to be usuable, by anyone anywhere... I need to write a small bit of code for bundlers.
+

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;