apprun 3.33.9 → 3.35.0

package/src/vdom.ts

@@ -1,5 +1,28 @@
+/**
+ * Virtual DOM Implementation
+ * 
+ * This file provides the core virtual DOM functionality:
+ * 1. createElement: Creates virtual DOM nodes
+ * 2. Fragment: Support for fragments
+ * 3. render: Renders virtual DOM to real DOM
+ * 4. safeHTML: Safely renders HTML strings
+ * 
+ * The virtual DOM system:
+ * - Provides efficient DOM updates
+ * - Supports JSX compilation
+ * - Handles component rendering
+ * - Manages DOM diffing and patching
+ * 
+ * Usage:
+ * ```ts
+ * // JSX gets compiled to createElement calls
+ * const vdom = <div id="app">Hello</div>;
+ * 
+ * // Render to DOM
+ * render(document.body, vdom);
+ * ```
+ */
+
 import { createElement, updateElement, Fragment, safeHTML } from './vdom-my';
 export { createElement, Fragment, updateElement as render, safeHTML };
 export { createElement as jsx, createElement as jsxs };
-
-

package/src/web-component.ts

@@ -1,3 +1,36 @@
+/**
+ * Web Components Integration
+ * 
+ * This file enables using AppRun components as Web Components:
+ * 1. Custom Element Creation
+ *    - Converts AppRun components to custom elements
+ *    - Handles lifecycle (connected, disconnected, etc)
+ *    - Manages shadow DOM and light DOM rendering
+ * 
+ * 2. Property/Attribute Sync
+ *    - Observes attribute changes
+ *    - Updates component state automatically
+ *    - Handles camelCase/kebab-case conversion
+ *    - Supports complex property types
+ * 
+ * 3. Event Handling
+ *    - Proxies events between component and element
+ *    - Supports both global and local events
+ *    - Maintains proper event bubbling
+ * 
+ * Usage:
+ * ```ts
+ * // Register web component
+ * @customElement('my-element')
+ * class MyComponent extends Component {
+ *   // Regular AppRun component code
+ * }
+ * 
+ * // Use in HTML
+ * <my-element name="value"></my-element>
+ * ```
+ */
+
 declare var customElements;
 
 export type CustomElementOptions = {

package/tsconfig.jest.json

@@ -11,6 +11,30 @@
 		"esModuleInterop": true,
 		"downlevelIteration": true,
 		"allowJs": true,
-		"outDir": "coverage/src"
-	}
-}
+		"outDir": "coverage/src",
+		"strict": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"strictFunctionTypes": true,
+		"strictBindCallApply": true,
+		"strictPropertyInitialization": true,
+		"noImplicitThis": true,
+		"alwaysStrict": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"baseUrl": ".",
+		"paths": {
+			"*": ["src/types/*"]
+		},
+		"typeRoots": [
+			"./node_modules/@types",
+			"./src/types"
+		],
+		"types": ["jest", "node"]
+	},
+	"include": [
+		"src/**/*",
+		"tests/**/*",
+		"demo/**/*"
+	]
+}

package/tsconfig.json

@@ -1,16 +1,16 @@
 {
 	"compilerOptions": {
-		"target": "es2015",
+		"target": "es2018",
 		"module": "es2015",
 		"moduleResolution": "node",
 		"jsx": "react",
 		"jsxFactory": "app.h",
 		"jsxFragmentFactory": "app.Fragment",
-		"lib": ["dom", "es2015", "es5"],
+		"lib": ["dom", "es2018", "esnext.asynciterable"],
 		"experimentalDecorators": true,
 		"sourceMap": true,
 		"esModuleInterop": true,
 		"downlevelIteration": true,
 		"skipLibCheck": true
 	}
-}
+}

package/webpack.config.cjs

@@ -1,4 +1,5 @@
 const path = require('path');
+const webpack = require('webpack');
 
 module.exports = {
   entry: {
@@ -28,5 +29,11 @@ module.exports = {
     open: true,
     static: path.join(__dirname),
   },
-  devtool: 'source-map'
-}
+  devtool: 'source-map',
+  plugins: [
+    new webpack.DefinePlugin({
+      // This tells Lit to run in production mode
+      'globalThis.DEV_MODE': JSON.stringify(false)
+    })
+  ]
+}