@jay-framework/runtime 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @jay-framework/runtime
+
+## 0.5.1
+
+### Patch Changes
+
+- updating the dependencies to be fixed versions
+- Updated dependencies
+  - @jay-framework/list-compare@0.5.1
+  - @jay-framework/reactive@0.5.1

package/dist/index.d.ts

@@ -454,6 +454,12 @@ declare const svgDynamicElement: <ViewState>(tagName: string, attributes: Attrib
 declare const mathMLDynamicElement: <ViewState>(tagName: string, attributes: Attributes<ViewState>, children?: DynamicElementChildren<ViewState>, ref?: PrivateRef<ViewState, BaseJayElement<ViewState>>) => BaseJayElement<ViewState>;
 declare function normalizeUpdates<ViewState>(updates: Array<updateFunc<ViewState>>): updateFunc<ViewState>;
 declare function normalizeMount(mounts: Array<MountFunc>): MountFunc;
+interface HeadLink {
+    rel: string;
+    href: string;
+    attributes?: Record<string, string>;
+}
+declare function injectHeadLinks(headLinks: HeadLink[]): void;
 
 interface ContextStack<ContextType> {
     context: ContextType;
@@ -478,4 +484,4 @@ declare class ConstructContext<ViewState> {
     static withRootContext<ViewState, Refs>(viewState: ViewState, refManager: ReferencesManager, elementConstructor: () => BaseJayElement<ViewState>): JayElement<ViewState, Refs>;
 }
 
-export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractRefs, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayNativeEventBuilder, type JayNativeFunction, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, type TextElement, type ViewStateFrom, booleanAttribute, childComp, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicProperty, dynamicText, element, findContext, forEach, isCondition, isForEach, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noopMount, noopUpdate, normalizeMount, normalizeUpdates, restoreContext, saveContext, svgDynamicElement, svgElement, type updateFunc, useContext, withContext };
+export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractRefs, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type HeadLink, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayNativeEventBuilder, type JayNativeFunction, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, type TextElement, type ViewStateFrom, booleanAttribute, childComp, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicProperty, dynamicText, element, findContext, forEach, injectHeadLinks, isCondition, isForEach, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noopMount, noopUpdate, normalizeMount, normalizeUpdates, restoreContext, saveContext, svgDynamicElement, svgElement, type updateFunc, useContext, withContext };

package/dist/index.js

@@ -471,6 +471,27 @@ function normalizeMount(mounts) {
     return noopMount;
   }
 }
+function injectHeadLinks(headLinks) {
+  const head = document.head;
+  if (!head)
+    return;
+  headLinks.forEach((linkData) => {
+    const existingLink = head.querySelector(
+      `link[href="${linkData.href}"][rel="${linkData.rel}"]`
+    );
+    if (existingLink)
+      return;
+    const link = document.createElement("link");
+    link.rel = linkData.rel;
+    link.href = linkData.href;
+    if (linkData.attributes) {
+      Object.entries(linkData.attributes).forEach(([key, value]) => {
+        link.setAttribute(key, value);
+      });
+    }
+    head.appendChild(link);
+  });
+}
 class PrivateRefs {
   constructor() {
     __publicField(this, "elements", /* @__PURE__ */ new Set());
@@ -818,6 +839,7 @@ export {
   element,
   findContext,
   forEach,
+  injectHeadLinks,
   isCondition,
   isForEach,
   mathMLDynamicElement,

package/docs/runtime.md

@@ -203,6 +203,58 @@ at which
 
 - `propertyValue` - a function that renders the property value from the current data item
 
+## injectHeadLinks
+
+The `injectHeadLinks` function injects `<link>` elements into the document head. This is primarily used by the Jay compiler to automatically inject head links defined in Jay-HTML files.
+
+The function is used in client only use cases. For jay-stack, it is expected that slowly or fast rendering will handle links and this function will not be used.
+
+```typescript
+import { injectHeadLinks, HeadLink } from '@jay-framework/runtime';
+
+// Basic usage
+injectHeadLinks([
+  { rel: 'stylesheet', href: 'styles/main.css' },
+  { rel: 'icon', href: '/favicon.ico' },
+]);
+
+// With additional attributes
+injectHeadLinks([
+  {
+    rel: 'preconnect',
+    href: 'https://fonts.googleapis.com',
+    attributes: { crossorigin: '' },
+  },
+  {
+    rel: 'alternate',
+    href: '/feed.xml',
+    attributes: {
+      type: 'application/rss+xml',
+      title: 'RSS Feed',
+    },
+  },
+]);
+```
+
+The `HeadLink` interface:
+
+```typescript
+interface HeadLink {
+  rel: string;
+  href: string;
+  attributes?: Record<string, string>;
+}
+```
+
+**Features**:
+
+- **Duplicate Prevention**: Automatically prevents duplicate links by checking both `href` and `rel` attributes
+- **Attribute Support**: Supports all standard HTML link attributes via the `attributes` property
+- **Safe Injection**: Gracefully handles missing `document.head` and other edge cases
+- **Runtime Only**: Designed for browser environments where `document` is available
+
+**Generated Code**: The Jay compiler automatically generates calls to `injectHeadLinks` when Jay-HTML files contain `<link>` elements in the `<head>` section.
+
 ## Jay Component
 
 Jay Components are logic wrappers over a Jay Element, and can be coded using any coding methodology. They have to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/runtime",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -23,12 +23,12 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/list-compare": "workspace:^",
-    "@jay-framework/reactive": "workspace:^",
+    "@jay-framework/list-compare": "^0.5.2",
+    "@jay-framework/reactive": "^0.5.2",
     "jsdom": "^23.2.0"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "workspace:^",
+    "@jay-framework/dev-environment": "^0.5.2",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/jsdom": "^21.1.6",
     "@types/node": "^20.11.5",
@@ -40,4 +40,4 @@
     "vite": "^5.0.11",
     "vitest": "^1.2.1"
   }
-}
+}