dotmem 0.0.0-stage → 0.0.1

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "dotmem",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "codeName": "dotmem",
+  "version": "0.0.1",
+  "description": "Append your component in any part of your html using reattach",
+  "license": "PROPRIETARY",
+  "author": "Dario Passariello",
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "typings": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.js"
+    },
+    "./types/*": "./types/*"
+  },
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "types",
+    "AGENTS.md",
+    "CITATION.md",
+    "CODEOWNERS.md",
+    "COPYRIGHT.md",
+    "LICENSE.md",
+    "llms.txt",
+    "README.md",
+    "SECURITY.md"
+  ],
+  "keywords": [
+    ".mem",
+    "memory",
+    "joy",
+    "jo",
+    "mcp",
+    "ai",
+    "agents",
+    "assistant"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "npm:publish": "npm run build && npm publish ./dist",
+    "": "-----------",
+    "lint": "cd tests && npm run lint",
+    "tsc": "cd tests && npm run tsc",
+    "test": "cd tests && npm run test",
+    "test:coverage": "cd tests && npm run test:coverage",
+    "pw": "cd tests && npm run pw",
+    "pw:browser": "cd tests && npm run pw"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "26.6.5",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "terser": "5.51.2",
+    "tslib": "^2.8.1",
+    "tsup": "^9.0.0",
+    "tsx": "4.23.15",
+    "typescript": "7.0.2"
+  }
 }

package/types/reattach.d.ts

@@ -0,0 +1,87 @@
+import type { ReactElement, ReactNode, CSSProperties, Context } from "react"
+import type { Root } from "react-dom/client"
+
+export type ReattachWhere = string
+
+export interface ReattachElementAttributes {
+  id?: string
+  class?: string
+  name?: string
+  dataset?: Record<string, string>
+  style?: CSSProperties | string
+  [key: string]: unknown
+}
+
+export interface OverlayOptions {
+  trapFocus?: boolean
+  lockScroll?: boolean
+  closeOnEscape?: boolean
+  stackingOrder?: "top" | "bottom" | "exact"
+  zIndex?: number
+}
+
+export interface LayoutOptions {
+  anchor?: string
+  placement?: "top" | "bottom" | "left" | "right" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"
+  offset?: number
+}
+
+export type EventHandlerKey = `on${string}`
+
+export interface AttachmentHandle {
+  updateProps: (newProps: Record<string, unknown>) => void
+  getContainer: () => HTMLElement
+  destroy: () => void
+}
+
+export interface MountOptions extends Partial<ReattachElementAttributes> {
+  root?: Root
+  inheritContext?: boolean
+  resilient?: boolean
+  overlay?: OverlayOptions
+  bubbleEvents?: EventHandlerKey[]
+  isolateNativeEvents?: boolean
+  layout?: LayoutOptions
+  hydrate?: boolean
+}
+
+export interface ReattachProps extends ReattachElementAttributes {
+  where: ReattachWhere
+  children: ReactNode
+  inheritContext?: boolean
+  resilient?: boolean
+  overlay?: OverlayOptions
+  bubbleEvents?: EventHandlerKey[]
+  isolateNativeEvents?: boolean
+  layout?: LayoutOptions
+  hydrate?: boolean
+}
+
+export declare class ReattachError extends Error {
+  readonly code: string
+  readonly details?: unknown
+  constructor(message: string, code: string, details?: unknown)
+}
+
+export interface ReattachFn {
+  (where: string): HTMLElement | null
+  (where: string, id: string, children: ReactNode, options?: MountOptions): HTMLElement
+  (where: string, children: ReactNode, options?: MountOptions): HTMLElement
+  (where: string, attrs: ReattachElementAttributes, children: ReactNode, options?: MountOptions): HTMLElement
+  readonly mount: (container: HTMLElement, children: ReactNode, options?: MountOptions) => HTMLElement
+  readonly unmount: (where?: string, id?: string) => boolean
+  readonly clear: (where?: string) => number
+  readonly has: (where?: string, id?: string) => boolean
+  readonly when: (where: string, timeout?: number) => Promise<HTMLElement>
+  readonly global: () => ReattachFn
+}
+
+export declare const Reattach: (props: ReattachProps) => ReactElement | null
+
+export declare const reattach: ReattachFn
+
+export declare function captureContext<T>(ctx: Context<T>, value: T): void
+
+interface Window {
+  reattach?: ReattachFn
+}

package/README.md

@@ -1,3 +0,0 @@
-# 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.