@joist/di 2.0.0-next.8 → 2.0.0

package/README.md

@@ -1,6 +1,7 @@
 # Di
 
-Dependency Injection in ~800 bytes.
+Dependency Injection in ~800 bytes. The Joist Dependency Injector is a small inversion of control (IOC) container that resolves dependencies lazyily.
+This means that it passes functions around and that dependencies are not initialized untill they are called.
 
 #### Installation:
 
@@ -11,7 +12,7 @@ npm i @joist/di
 #### Example:
 
 ```TS
-import { Injector } from '@joist/di';
+import { Injector, Injected } from '@joist/di';
 
 class FooService {
   sayHello() {
@@ -20,12 +21,12 @@ class FooService {
 }
 
 class BarService {
-  static deps = [FooService];
+  static inject = [FooService];
 
-  constructor(private foo: FooService) {}
+  constructor(private foo: Injected<FooService>) { }
 
   sayHello() {
-    return this.foo.sayHello();
+    return this.foo().sayHello();
   }
 }
 
@@ -37,7 +38,7 @@ app.get(BarService).sayHello(); // Hello from BarService and Hello from FooServi
 #### Override A Service:
 
 ```TS
-import { Injector, inject } from '@joist/di';
+import { Injector, inject, Injected } from '@joist/di';
 
 class FooService {
   sayHello() {
@@ -46,28 +47,26 @@ class FooService {
 }
 
 class BarService {
-  static deps = [FooService];
+  static inject = [FooService];
 
-  constructor(private foo: FooService) {}
+  constructor(private foo: Injected<FooService>) {}
 
   sayHello() {
-    return 'Hello From BarService and ' + this.foo.sayHello();
+    return 'Hello From BarService and ' + this.foo().sayHello();
   }
 }
 
 // Override FooService with an alternate implementation
-const app = new Injector({
-  providers: [
-    {
-      provide: FooService,
-      use: class extends FooService {
-        sayHello() {
-          return 'IT HAS BEEN OVERRIDEN'
-        }
+const app = new Injector([
+  {
+    provide: FooService,
+    use: class extends FooService {
+      sayHello() {
+        return 'IT HAS BEEN OVERRIDEN'
       }
     }
-  ]
-});
+  }
+]);
 
 app.get(BarService).sayHello(); // Hello from BarService and IT HAS BEEN OVERRIDEN
 ```
@@ -95,54 +94,110 @@ Since the browser will be what initializes your custom elements we need to be ab
 
 The `@injectable` decorator allows the Joist Dependency Injector to pass arguments to your custom element when instances of your element is created.
 
-`@injectable` is on required when you will not be able to manually create instances via an injector.
+`@injectable` also injects your services in a lazy way. Instead of passing direct instances of your services it passes a function that be called when you need your service instance. This allows the injector to look for parent injectors which are only availabel after connectedCallback.
 
 #### Inject dependency into your custom element constructor
 
 ```TS
-import { inject, service, injectable } from '@joist/di';
+import { injectable, Injected } from '@joist/di';
 
-@service
 class MyService {}
 
 @injectable
 class MyElement extends HTMLElement {
-  static deps = [MyService];
+  static inject = [MyService];
 
-  constructor(public myService: MyService) {}
+  constructor(public myService: Injected<MyService>) {}
 }
 
 customElements.define('my-element', MyElement);
 ```
 
-#### Define providers and overrides
+#### Define global providers and overrides
 
 This allows your to override services for different environments or scenarios
 
 ```TS
-import { defineEnvironment, injectable } from '@joist/di';
+import { environment, injectable, Injected } from '@joist/di';
 
 class Config {
   apiUrl = 'http://localhost:4000/api/'
 }
 
-defineEnvironment([
-  {
-    provide: Config,
-    use: class extends Config {
-      apiUrl = 'http://real-api/api/'
-    }
+environment().providers.push({
+  provide: Config,
+  use: class {
+    apiUrl = 'http://real-api/api/'
   }
-]);
+});
 
 @injectable
 class MyElement extends HTMLElement {
-  static deps = [Config];
+  static inject = [Config];
 
-  constructor(config: Config) {
-    console.log(config.apiUrl); // http://real-api/api/
+  constructor(config: Injected<Config>) {
+    console.log(config().apiUrl); // http://real-api/api/
   }
 }
 
 customElements.define('my-element', MyElement);
 ```
+
+## Context
+
+The Joist injector is hierarchical meaning that you can define context for just one part of the DOM tree.
+
+### NOTE:
+
+When using context elements it is important that they are registered BEFORE your other elements.
+If child elements are upgraded before the context element they won't be able to find the context scope.
+
+```TS
+import { injectable, Injected } from '@joist/di';
+
+class Colors {
+  primary = 'red';
+  secodnary = 'green';
+}
+
+@injectable
+class ColorCtx extends HTMLElement {
+  static providers = [
+    {
+      provide: Colors,
+      use: class implements Colors {
+        primary = 'orange';
+        secondary = 'purple';
+      },
+    },
+  ];
+}
+
+@injectable
+class MyElement extends HTMLElement {
+  static inject = [Colors];
+
+  constructor(public colors: Injected<Colors>) {
+    super();
+  }
+
+  connectedCallback() {
+    const { primary } = this.colors();
+
+    this.style.background = primary;
+  }
+}
+
+customElements.define('color-ctx', ColorCtx);
+customElements.define('my-element', MyElement);
+```
+
+```HTML
+<!-- Default Colors -->
+<my-element></my-element>
+
+<!-- Special color ctx -->
+<color-ctx>
+  <my-element></my-element>
+</color-ctx>
+```

package/package.json

@@ -1,18 +1,33 @@
 {
   "name": "@joist/di",
-  "version": "2.0.0-next.8",
+  "version": "2.0.0",
   "main": "./target/build/lib.js",
   "module": "./target/build/lib.js",
   "exports": {
     ".": {
       "import": "./target/build/lib.js"
+    },
+    "./environment.js": {
+      "import": "./target/build/lib/environment.js"
+    },
+    "./injectable.js": {
+      "import": "./target/build/lib/injectable.js"
+    },
+    "./injector.js": {
+      "import": "./target/build/lib/injector.js"
+    },
+    "./provider.js": {
+      "import": "./target/build/lib/provider.js"
+    },
+    "./service.js": {
+      "import": "./target/build/lib/service.js"
     }
   },
   "files": [
     "target/build"
   ],
   "sideEffects": false,
-  "description": "Dependency Injection in ~800 bytes",
+  "description": "Dependency Injection for Vanilla JS classes",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/deebloo/joist.git"
@@ -20,7 +35,8 @@
   "keywords": [
     "TypeScript",
     "DI",
-    "Dependency Injection"
+    "Dependency Injection",
+    "WebComponents"
   ],
   "author": "deebloo",
   "license": "MIT",
@@ -34,5 +50,5 @@
     "test": "tsc -p tsconfig.test.json && wtr --config ../../wtr.config.mjs --port 8001",
     "build": "tsc -p tsconfig.build.json"
   },
-  "gitHead": "1212ee3fec6c88bed79dc5ff97076c088f91c852"
+  "gitHead": "ed9e8f0cb4c6213ba255278a173c3dc7f45aee89"
 }

package/target/build/lib/dom/environment.d.ts

@@ -0,0 +1,3 @@
+import { Injector } from '../injector';
+export declare function environment(): Injector;
+export declare function clearEnvironment(): void;

package/target/build/lib/dom/environment.js

@@ -0,0 +1,9 @@
+import { Injector } from '../injector';
+const rootInjector = new Injector();
+export function environment() {
+    return rootInjector;
+}
+export function clearEnvironment() {
+    rootInjector.providers = [];
+    rootInjector.instances = new WeakMap();
+}

package/target/build/lib/dom/injectable.d.ts

@@ -0,0 +1,317 @@
+import { Provider, ProviderToken } from '../provider';
+import { Injector } from '../injector';
+export interface Injectable {
+    inject?: ProviderToken<any>[];
+    providers?: Provider<any>[];
+    new (...args: any[]): HTMLElement;
+}
+export declare function injectable<T extends Injectable>(CustomElement: T): {
+    new (...args: any[]): {
+        injector: Injector;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        accessKey: string;
+        readonly accessKeyLabel: string;
+        autocapitalize: string;
+        dir: string;
+        draggable: boolean;
+        hidden: boolean;
+        innerText: string;
+        lang: string;
+        readonly offsetHeight: number;
+        readonly offsetLeft: number;
+        readonly offsetParent: Element | null;
+        readonly offsetTop: number;
+        readonly offsetWidth: number;
+        outerText: string;
+        spellcheck: boolean;
+        title: string;
+        translate: boolean;
+        attachInternals(): ElementInternals;
+        click(): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions | undefined): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
+        removeEventListener<K_1 extends keyof HTMLElementEventMap>(type: K_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1]) => any, options?: boolean | EventListenerOptions | undefined): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions | undefined): void;
+        readonly attributes: NamedNodeMap;
+        readonly classList: DOMTokenList;
+        className: string;
+        readonly clientHeight: number;
+        readonly clientLeft: number;
+        readonly clientTop: number;
+        readonly clientWidth: number;
+        id: string;
+        readonly localName: string;
+        readonly namespaceURI: string | null;
+        onfullscreenchange: ((this: Element, ev: Event) => any) | null;
+        onfullscreenerror: ((this: Element, ev: Event) => any) | null;
+        outerHTML: string;
+        readonly ownerDocument: Document;
+        readonly part: DOMTokenList;
+        readonly prefix: string | null;
+        readonly scrollHeight: number;
+        scrollLeft: number;
+        scrollTop: number;
+        readonly scrollWidth: number;
+        readonly shadowRoot: ShadowRoot | null;
+        slot: string;
+        readonly tagName: string;
+        attachShadow(init: ShadowRootInit): ShadowRoot;
+        closest<K_2 extends keyof HTMLElementTagNameMap>(selector: K_2): HTMLElementTagNameMap[K_2] | null;
+        closest<K_3 extends keyof SVGElementTagNameMap>(selector: K_3): SVGElementTagNameMap[K_3] | null;
+        closest<E extends Element = Element>(selectors: string): E | null;
+        getAttribute(qualifiedName: string): string | null;
+        getAttributeNS(namespace: string | null, localName: string): string | null;
+        getAttributeNames(): string[];
+        getAttributeNode(qualifiedName: string): Attr | null;
+        getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
+        getBoundingClientRect(): DOMRect;
+        getClientRects(): DOMRectList;
+        getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+        getElementsByTagName<K_4 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4): HTMLCollectionOf<HTMLElementTagNameMap[K_4]>;
+        getElementsByTagName<K_5 extends keyof SVGElementTagNameMap>(qualifiedName: K_5): HTMLCollectionOf<SVGElementTagNameMap[K_5]>;
+        getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+        getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+        hasAttribute(qualifiedName: string): boolean;
+        hasAttributeNS(namespace: string | null, localName: string): boolean;
+        hasAttributes(): boolean;
+        hasPointerCapture(pointerId: number): boolean;
+        insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
+        insertAdjacentHTML(position: InsertPosition, text: string): void;
+        insertAdjacentText(where: InsertPosition, data: string): void;
+        matches(selectors: string): boolean;
+        releasePointerCapture(pointerId: number): void;
+        removeAttribute(qualifiedName: string): void;
+        removeAttributeNS(namespace: string | null, localName: string): void;
+        removeAttributeNode(attr: Attr): Attr;
+        requestFullscreen(options?: FullscreenOptions | undefined): Promise<void>;
+        requestPointerLock(): void;
+        scroll(options?: ScrollToOptions | undefined): void;
+        scroll(x: number, y: number): void;
+        scrollBy(options?: ScrollToOptions | undefined): void;
+        scrollBy(x: number, y: number): void;
+        scrollIntoView(arg?: boolean | ScrollIntoViewOptions | undefined): void;
+        scrollTo(options?: ScrollToOptions | undefined): void;
+        scrollTo(x: number, y: number): void;
+        setAttribute(qualifiedName: string, value: string): void;
+        setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
+        setAttributeNode(attr: Attr): Attr | null;
+        setAttributeNodeNS(attr: Attr): Attr | null;
+        setPointerCapture(pointerId: number): void;
+        toggleAttribute(qualifiedName: string, force?: boolean | undefined): boolean;
+        webkitMatchesSelector(selectors: string): boolean;
+        readonly baseURI: string;
+        readonly childNodes: NodeListOf<ChildNode>;
+        readonly firstChild: ChildNode | null;
+        readonly isConnected: boolean;
+        readonly lastChild: ChildNode | null;
+        readonly nextSibling: ChildNode | null;
+        readonly nodeName: string;
+        readonly nodeType: number;
+        nodeValue: string | null;
+        readonly parentElement: HTMLElement | null;
+        readonly parentNode: ParentNode | null;
+        readonly previousSibling: ChildNode | null;
+        textContent: string | null;
+        appendChild<T_1 extends Node>(node: T_1): T_1;
+        cloneNode(deep?: boolean | undefined): Node;
+        compareDocumentPosition(other: Node): number;
+        contains(other: Node | null): boolean;
+        getRootNode(options?: GetRootNodeOptions | undefined): Node;
+        hasChildNodes(): boolean;
+        insertBefore<T_2 extends Node>(node: T_2, child: Node | null): T_2;
+        isDefaultNamespace(namespace: string | null): boolean;
+        isEqualNode(otherNode: Node | null): boolean;
+        isSameNode(otherNode: Node | null): boolean;
+        lookupNamespaceURI(prefix: string | null): string | null;
+        lookupPrefix(namespace: string | null): string | null;
+        normalize(): void;
+        removeChild<T_3 extends Node>(child: T_3): T_3;
+        replaceChild<T_4 extends Node>(node: Node, child: T_4): T_4;
+        readonly ATTRIBUTE_NODE: number;
+        readonly CDATA_SECTION_NODE: number;
+        readonly COMMENT_NODE: number;
+        readonly DOCUMENT_FRAGMENT_NODE: number;
+        readonly DOCUMENT_NODE: number;
+        readonly DOCUMENT_POSITION_CONTAINED_BY: number;
+        readonly DOCUMENT_POSITION_CONTAINS: number;
+        readonly DOCUMENT_POSITION_DISCONNECTED: number;
+        readonly DOCUMENT_POSITION_FOLLOWING: number;
+        readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: number;
+        readonly DOCUMENT_POSITION_PRECEDING: number;
+        readonly DOCUMENT_TYPE_NODE: number;
+        readonly ELEMENT_NODE: number;
+        readonly ENTITY_NODE: number;
+        readonly ENTITY_REFERENCE_NODE: number;
+        readonly NOTATION_NODE: number;
+        readonly PROCESSING_INSTRUCTION_NODE: number;
+        readonly TEXT_NODE: number;
+        dispatchEvent(event: Event): boolean;
+        ariaAtomic: string | null;
+        ariaAutoComplete: string | null;
+        ariaBusy: string | null;
+        ariaChecked: string | null;
+        ariaColCount: string | null;
+        ariaColIndex: string | null;
+        ariaColSpan: string | null;
+        ariaCurrent: string | null;
+        ariaDisabled: string | null;
+        ariaExpanded: string | null;
+        ariaHasPopup: string | null;
+        ariaHidden: string | null;
+        ariaKeyShortcuts: string | null;
+        ariaLabel: string | null;
+        ariaLevel: string | null;
+        ariaLive: string | null;
+        ariaModal: string | null;
+        ariaMultiLine: string | null;
+        ariaMultiSelectable: string | null;
+        ariaOrientation: string | null;
+        ariaPlaceholder: string | null;
+        ariaPosInSet: string | null;
+        ariaPressed: string | null;
+        ariaReadOnly: string | null;
+        ariaRequired: string | null;
+        ariaRoleDescription: string | null;
+        ariaRowCount: string | null;
+        ariaRowIndex: string | null;
+        ariaRowSpan: string | null;
+        ariaSelected: string | null;
+        ariaSetSize: string | null;
+        ariaSort: string | null;
+        ariaValueMax: string | null;
+        ariaValueMin: string | null;
+        ariaValueNow: string | null;
+        ariaValueText: string | null;
+        animate(keyframes: PropertyIndexedKeyframes | Keyframe[] | null, options?: number | KeyframeAnimationOptions | undefined): Animation;
+        getAnimations(options?: GetAnimationsOptions | undefined): Animation[];
+        after(...nodes: (string | Node)[]): void;
+        before(...nodes: (string | Node)[]): void;
+        remove(): void;
+        replaceWith(...nodes: (string | Node)[]): void;
+        innerHTML: string;
+        readonly nextElementSibling: Element | null;
+        readonly previousElementSibling: Element | null;
+        readonly childElementCount: number;
+        readonly children: HTMLCollection;
+        readonly firstElementChild: Element | null;
+        readonly lastElementChild: Element | null;
+        append(...nodes: (string | Node)[]): void;
+        prepend(...nodes: (string | Node)[]): void;
+        querySelector<K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6] | null;
+        querySelector<K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7] | null;
+        querySelector<E_1 extends Element = Element>(selectors: string): E_1 | null;
+        querySelectorAll<K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
+        querySelectorAll<K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
+        querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+        replaceChildren(...nodes: (string | Node)[]): void;
+        readonly assignedSlot: HTMLSlotElement | null;
+        oncopy: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        oncut: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        onpaste: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        readonly style: CSSStyleDeclaration;
+        contentEditable: string;
+        enterKeyHint: string;
+        inputMode: string;
+        readonly isContentEditable: boolean;
+        onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onauxclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncontextmenu: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onerror: OnErrorEventHandler;
+        onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
+        ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent<EventTarget>) => any) | null;
+        onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
+        onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
+        onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontoggle: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
+        autofocus: boolean;
+        readonly dataset: DOMStringMap;
+        nonce?: string | undefined;
+        tabIndex: number;
+        blur(): void;
+        focus(options?: FocusOptions | undefined): void;
+    };
+    inject?: ProviderToken<any>[] | undefined;
+    providers?: Provider<any>[] | undefined;
+} & T;

package/target/build/lib/dom/injectable.js

@@ -0,0 +1,49 @@
+import { Injector } from '../injector';
+import { environment } from './environment';
+export function injectable(CustomElement) {
+    const { inject, providers } = CustomElement;
+    return class InjectableElement extends CustomElement {
+        constructor(...args) {
+            const injector = new Injector(providers, environment());
+            if (args.length || !inject) {
+                super(...args);
+            }
+            else {
+                super(...inject.map((dep) => () => injector.get(dep)));
+            }
+            this.injector = injector;
+            this.addEventListener('finddiroot', (e) => {
+                const parentInjector = findInjectorRoot(e);
+                if (parentInjector) {
+                    this.injector.parent = parentInjector;
+                }
+                if (super.connectedCallback) {
+                    super.connectedCallback();
+                }
+            });
+        }
+        connectedCallback() {
+            // only mark as an injector root if element defines providers
+            if (providers) {
+                this.setAttribute('joist-injector-root', 'true');
+            }
+            this.dispatchEvent(new Event('finddiroot'));
+        }
+        disconnectedCallback() {
+            delete this.injector.parent;
+            if (super.disconnectedCallback) {
+                super.disconnectedCallback();
+            }
+        }
+    };
+}
+function findInjectorRoot(e) {
+    const path = e.composedPath();
+    const parentInjector = path.find((el) => {
+        return el instanceof HTMLElement && el !== e.target && el.hasAttribute('joist-injector-root');
+    });
+    if (parentInjector) {
+        return Reflect.get(parentInjector, 'injector');
+    }
+    return null;
+}

package/target/build/lib/dom.d.ts

@@ -0,0 +1,2 @@
+export { environment } from './dom/environment';
+export { injectable } from './dom/injectable';

package/target/build/lib/dom.js

@@ -0,0 +1,2 @@
+export { environment } from './dom/environment';
+export { injectable } from './dom/injectable';

package/target/build/lib/environment.d.ts

@@ -1,5 +1,3 @@
-import { Injector } from './injector';
-import { Provider } from './provider';
-export declare function defineEnvironment(providers?: Provider<any>[]): Injector;
-export declare function getEnvironmentRef(): Injector;
+import { Injector } from './injector.js';
+export declare function environment(): Injector;
 export declare function clearEnvironment(): void;