@praxisjs/shared 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @praxisjs/shared
+
+## 0.1.0
+
+### Minor Changes
+
+- aaf7dab: Initial beta release

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/children.d.ts

@@ -0,0 +1,3 @@
+import type { ChildrenInternal } from "./types/children";
+export declare const flattenChildren: (children: ChildrenInternal | ChildrenInternal[], out?: ChildrenInternal[]) => ChildrenInternal[];
+//# sourceMappingURL=children.d.ts.map

package/dist/children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.d.ts","sourceRoot":"","sources":["../src/children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,eAAO,MAAM,eAAe,GAC1B,UAAU,gBAAgB,GAAG,gBAAgB,EAAE,EAC/C,MAAK,gBAAgB,EAAO,uBAU7B,CAAC"}

package/dist/children.js

@@ -0,0 +1,12 @@
+export const flattenChildren = (children, out = []) => {
+    if (Array.isArray(children)) {
+        for (const child of children) {
+            flattenChildren(child, out);
+        }
+    }
+    else {
+        out.push(children);
+    }
+    return out;
+};
+//# sourceMappingURL=children.js.map

package/dist/children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.js","sourceRoot":"","sources":["../src/children.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAA+C,EAC/C,MAA0B,EAAE,EAC5B,EAAE;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { isSignal, isComputed } from "./signal";
+export type { Computed, Signal } from "./types/signal";
+export { flattenChildren } from "./children";
+export type { VNode, Children, ChildrenInternal, FunctionComponent, ComponentConstructor, ComponentInstance, Component, } from "./types/children";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { isSignal, isComputed } from "./signal";
+export { flattenChildren } from "./children";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/signal.d.ts

@@ -0,0 +1,4 @@
+import type { Computed, Signal } from "./types/signal";
+export declare function isSignal<T>(source: Signal<T> | Computed<T> | (() => T)): boolean;
+export declare function isComputed(source: unknown): source is Function & Record<"subscribe", unknown>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEvD,wBAAgB,QAAQ,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAC1C,OAAO,CAET;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,qDAEzC"}

package/dist/signal.js

@@ -0,0 +1,7 @@
+export function isSignal(source) {
+    return typeof source.set === "function";
+}
+export function isComputed(source) {
+    return typeof source === "function" && "subscribe" in source;
+}
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CACtB,MAA2C;IAE3C,OAAO,OAAQ,MAAoB,CAAC,GAAG,KAAK,UAAU,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,OAAO,OAAO,MAAM,KAAK,UAAU,IAAI,WAAW,IAAI,MAAM,CAAC;AAC/D,CAAC"}

package/dist/types/children.d.ts

@@ -0,0 +1,32 @@
+export type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+export type ReactiveChildren = () => Primitive | VNode | VNode[] | ReactiveChildren[];
+export type ChildrenInternal = Primitive | VNode | ReactiveChildren | ChildrenInternal[];
+export type Children = ChildrenInternal | ChildrenInternal[];
+export type Component = FunctionComponent | ComponentConstructor;
+export interface VNode {
+    type: string | Component;
+    props: Record<string, unknown>;
+    children: ChildrenInternal[];
+    key?: string | number;
+}
+export type FunctionComponent<P = Record<string, unknown>> = (props: P & {
+    children?: Children;
+}) => VNode | null;
+export interface ComponentConstructor<P = Record<string, unknown>> {
+    new (props: P): ComponentInstance;
+    isComponent: true;
+}
+export interface ComponentInstance {
+    _mounted: boolean;
+    _stateDirty: boolean;
+    _lastResolvedProps?: Record<string, unknown>;
+    _isMemorized?: boolean;
+    _arePropsEqual?: (prevProps: Record<string, unknown>, nextProps: Record<string, unknown>) => boolean;
+    _setProps(p: Record<string, unknown>): void;
+    render(): VNode | null;
+    onBeforeMount?(): void;
+    onMount?(): void;
+    onUnmount?(): void;
+    onError?(e: Error): void;
+}
+//# sourceMappingURL=children.d.ts.map

package/dist/types/children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.d.ts","sourceRoot":"","sources":["../../src/types/children.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GAAG,MAC3B,SAAS,GACT,KAAK,GACL,KAAK,EAAE,GACP,gBAAgB,EAAE,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,KAAK,GACL,gBAAgB,GAChB,gBAAgB,EAAE,CAAC;AAEvB,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAEjE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC3D,KAAK,EAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,KAC/B,KAAK,GAAG,IAAI,CAAC;AAElB,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,KAAK,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC;IAClC,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,CACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC;IACb,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,IAAI,KAAK,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,IAAI,IAAI,CAAC;IACvB,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types/children.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=children.js.map

package/dist/types/children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.js","sourceRoot":"","sources":["../../src/types/children.ts"],"names":[],"mappings":""}

package/dist/types/signal.d.ts

@@ -0,0 +1,11 @@
+export interface Computed<T> {
+    (): T;
+    subscribe(effect: (value: T) => void): () => void;
+}
+export interface Signal<T> {
+    (): T;
+    set(value: T): void;
+    update(updater: (prev: T) => T): void;
+    subscribe(effect: (value: T) => void): () => void;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/types/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/types/signal.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC;IACN,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC;IACN,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD"}

package/dist/types/signal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signal.js.map

package/dist/types/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/types/signal.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@praxisjs/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/children.ts

@@ -0,0 +1,15 @@
+import type { ChildrenInternal } from "./types/children";
+
+export const flattenChildren = (
+  children: ChildrenInternal | ChildrenInternal[],
+  out: ChildrenInternal[] = [],
+) => {
+  if (Array.isArray(children)) {
+    for (const child of children) {
+      flattenChildren(child, out);
+    }
+  } else {
+    out.push(children);
+  }
+  return out;
+};

package/src/index.ts

@@ -0,0 +1,12 @@
+export { isSignal, isComputed } from "./signal";
+export type { Computed, Signal } from "./types/signal";
+export { flattenChildren } from "./children";
+export type {
+  VNode,
+  Children,
+  ChildrenInternal,
+  FunctionComponent,
+  ComponentConstructor,
+  ComponentInstance,
+  Component,
+} from "./types/children";

package/src/signal.ts

@@ -0,0 +1,11 @@
+import type { Computed, Signal } from "./types/signal";
+
+export function isSignal<T>(
+  source: Signal<T> | Computed<T> | (() => T),
+): boolean {
+  return typeof (source as Signal<T>).set === "function";
+}
+
+export function isComputed(source: unknown) {
+  return typeof source === "function" && "subscribe" in source;
+}

package/src/types/children.ts

@@ -0,0 +1,57 @@
+export type Primitive =
+  | string
+  | number
+  | boolean
+  | bigint
+  | symbol
+  | null
+  | undefined;
+
+export type ReactiveChildren = () =>
+  | Primitive
+  | VNode
+  | VNode[]
+  | ReactiveChildren[];
+
+export type ChildrenInternal =
+  | Primitive
+  | VNode
+  | ReactiveChildren
+  | ChildrenInternal[];
+
+export type Children = ChildrenInternal | ChildrenInternal[];
+
+export type Component = FunctionComponent | ComponentConstructor;
+
+export interface VNode {
+  type: string | Component;
+  props: Record<string, unknown>;
+  children: ChildrenInternal[];
+  key?: string | number;
+}
+
+export type FunctionComponent<P = Record<string, unknown>> = (
+  props: P & { children?: Children },
+) => VNode | null;
+
+export interface ComponentConstructor<P = Record<string, unknown>> {
+  new (props: P): ComponentInstance;
+  isComponent: true;
+}
+
+export interface ComponentInstance {
+  _mounted: boolean;
+  _stateDirty: boolean;
+  _lastResolvedProps?: Record<string, unknown>;
+  _isMemorized?: boolean;
+  _arePropsEqual?: (
+    prevProps: Record<string, unknown>,
+    nextProps: Record<string, unknown>,
+  ) => boolean;
+  _setProps(p: Record<string, unknown>): void;
+  render(): VNode | null;
+  onBeforeMount?(): void;
+  onMount?(): void;
+  onUnmount?(): void;
+  onError?(e: Error): void;
+}

package/src/types/signal.ts

@@ -0,0 +1,11 @@
+export interface Computed<T> {
+  (): T;
+  subscribe(effect: (value: T) => void): () => void;
+}
+
+export interface Signal<T> {
+  (): T;
+  set(value: T): void;
+  update(updater: (prev: T) => T): void;
+  subscribe(effect: (value: T) => void): () => void;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declarationDir": "./dist"
+  },
+  "include": ["src"]
+}