npm - assign-gingerly - Versions diffs - 0.0.53 → 0.0.55 - Mend

assign-gingerly 0.0.53 → 0.0.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

package/README.md +847 -5
package/assignFrom.js +229 -9
package/assignFrom.ts +338 -9
package/assignGingerly.js +34 -1
package/assignGingerly.ts +54 -1
package/beVigilant.js +73 -0
package/beVigilant.ts +85 -0
package/enhanceAll.js +106 -0
package/enhanceAll.ts +138 -0
package/handlers/join.js +74 -0
package/handlers/join.ts +80 -0
package/handlers/lazyLoad.js +212 -0
package/handlers/lazyLoad.ts +307 -0
package/handlers/lazyLoadSwitch.js +58 -0
package/handlers/lazyLoadSwitch.ts +63 -0
package/handlers/microDataJoin.js +184 -0
package/handlers/microDataJoin.ts +270 -0
package/inferencer/.gitmodules +3 -0
package/inferencer/.vscode/settings.json +2 -0
package/inferencer/InferencedPropagator.js +230 -0
package/inferencer/InferencedPropagator.ts +269 -0
package/inferencer/LICENSE +21 -0
package/inferencer/README.md +524 -0
package/inferencer/Requirements/SupportForPropagator.md +368 -0
package/inferencer/imports.html +7 -0
package/inferencer/inferencer.js +254 -0
package/inferencer/inferencer.ts +292 -0
package/inferencer/package-lock.json +129 -0
package/inferencer/package.json +60 -0
package/inferencer/playwright-report/data/507ad515125e13390ea07de92f22331c913fa068.md +55 -0
package/inferencer/playwright-report/index.html +90 -0
package/inferencer/playwright.config.ts +54 -0
package/inferencer/test-results/.last-run.json +6 -0
package/inferencer/test-results/inferencer-Inferencer-Enha-535bc-inferencer-tests-in-browser-chromium/error-context.md +55 -0
package/inferencer/tests/inferencedPropagator.html +428 -0
package/inferencer/tests/inferencedPropagator.spec.ts +18 -0
package/inferencer/tests/inferencer.html +355 -0
package/inferencer/tests/inferencer.spec.ts +19 -0
package/inferencer/tsconfig.json +19 -0
package/inferencer/types/.kiro/specs/conversion-template/README.md +128 -0
package/inferencer/types/.kiro/specs/conversion-template/design.md +360 -0
package/inferencer/types/.kiro/specs/conversion-template/requirements.md +191 -0
package/inferencer/types/.kiro/specs/conversion-template/tasks.md +174 -0
package/inferencer/types/.kiro/steering/coding-standards.md +53 -0
package/inferencer/types/.kiro/steering/conversion-guide.md +108 -0
package/inferencer/types/.kiro/steering/declarative-configuration.md +108 -0
package/inferencer/types/.kiro/steering/emc-json-serializability.md +306 -0
package/inferencer/types/EnhancementConversionInstructions.md +1854 -0
package/inferencer/types/LICENSE +21 -0
package/inferencer/types/NewCustomElement.md +388 -0
package/inferencer/types/NewCustomElementFeature.md +683 -0
package/inferencer/types/NewEnhancementInstructions.md +705 -0
package/inferencer/types/README.md +2 -0
package/inferencer/types/agrace/types.d.ts +11 -0
package/inferencer/types/assign-gingerly/types.d.ts +572 -0
package/inferencer/types/be-a-beacon/types.d.ts +17 -0
package/inferencer/types/be-bound/types.d.ts +66 -0
package/inferencer/types/be-buttoned-up/types.d.ts +19 -0
package/inferencer/types/be-calculating/types.d.ts +54 -0
package/inferencer/types/be-clonable/types.d.ts +38 -0
package/inferencer/types/be-committed/types.d.ts +22 -0
package/inferencer/types/be-consoling/types.d.ts +24 -0
package/inferencer/types/be-decked-with/types.d.ts +26 -0
package/inferencer/types/be-delible/types.d.ts +27 -0
package/inferencer/types/be-dispatching/types.d.ts +34 -0
package/inferencer/types/be-evanescent/types.d.ts +20 -0
package/inferencer/types/be-flashy/types.d.ts +21 -0
package/inferencer/types/be-gone/types.d.ts +25 -0
package/inferencer/types/be-observing/types.d.ts +55 -0
package/inferencer/types/be-reflective/types.d.ts +78 -0
package/inferencer/types/be-reformable/types.d.ts +49 -0
package/inferencer/types/be-render-neutral/types.d.ts +32 -0
package/inferencer/types/be-switched/types.d.ts +146 -0
package/inferencer/types/be-typed/types.d.ts +32 -0
package/inferencer/types/be-valued/types.d.ts +22 -0
package/inferencer/types/data-props/types.d.ts +34 -0
package/inferencer/types/do-inc/types.d.ts +56 -0
package/inferencer/types/do-invoke/types.d.ts +38 -0
package/inferencer/types/do-merge/types.d.ts +28 -0
package/inferencer/types/do-toggle/types.d.ts +31 -0
package/inferencer/types/face-up/types.d.ts +100 -0
package/inferencer/types/fetch-for/types.d.ts +36 -0
package/inferencer/types/folder-picker/types.d.ts +21 -0
package/inferencer/types/global.d.ts +29 -0
package/inferencer/types/id-generation/types.d.ts +26 -0
package/inferencer/types/inferencer/types.d.ts +46 -0
package/inferencer/types/mount-observer/types.d.ts +363 -0
package/inferencer/types/nested-regex-groups/types.d.ts +107 -0
package/inferencer/types/pipe-in/types.d.ts +52 -0
package/inferencer/types/roundabout/types.d.ts +268 -0
package/inferencer/types/soak-up/types.d.ts +40 -0
package/inferencer/types/templ-maker/types.d.ts +43 -0
package/inferencer/types/time-ticker/types.d.ts +62 -0
package/inferencer/types/truth-sourcer/types.d.ts +44 -0
package/inferencer/upSearch.js +27 -0
package/inferencer/upSearch.ts +26 -0
package/inferencer/withScopePerimeter.js +27 -0
package/inferencer/withScopePerimeter.ts +33 -0
package/inferredAssignments.js +38 -0
package/inferredAssignments.ts +65 -0
package/isAllowedImportPath.js +42 -0
package/isAllowedImportPath.ts +53 -0
package/package.json +57 -3
package/paths.js +231 -0
package/paths.ts +413 -0
package/processHandlerCommands.js +188 -0
package/processHandlerCommands.ts +217 -0
package/resolveIdRef.js +144 -0
package/resolveIdRef.ts +170 -0
package/resolveValues.js +41 -2
package/resolveValues.ts +41 -1
package/transitionHelper.js +109 -0
package/transitionHelper.ts +132 -0
package/types/assign-gingerly/types.d.ts +89 -0

package/inferencer/tests/inferencer.html ADDED Viewed

@@ -0,0 +1,355 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Inferencer Enhancement Tests</title>
+    <!-- #include virtual="/imports.html" -->
+</head>
+<body>
+    <h1>Inferencer Enhancement Tests</h1>
+    <div id="results"></div>
+    <script type="module">
+        import { value, display, registryItem, inferEventType } from '../inferencer.js';
+        import 'assign-gingerly/object-extension.js';
+        const results = [];
+        let testCount = 0;
+        let passCount = 0;
+        function test(name, fn) {
+            testCount++;
+            try {
+                fn();
+                passCount++;
+                results.push(`✓ ${name}`);
+                console.log(`✓ ${name}`);
+            } catch (error) {
+                results.push(`✗ ${name}: ${error.message}`);
+                console.error(`✗ ${name}:`, error);
+            }
+        }
+        // Register the enhancement
+        customElements.enhancementRegistry.push(registryItem);
+        // Test 1: Input text element
+        test('should set value on text input', () => {
+            const input = document.createElement('input');
+            input.type = 'text';
+            input.set[value] = 'hello';
+            if (input.value !== 'hello') {
+                throw new Error(`Expected 'hello', got '${input.value}'`);
+            }
+        });
+        // Test 2: Checkbox element
+        test('should set checked on checkbox', () => {
+            const checkbox = document.createElement('input');
+            checkbox.type = 'checkbox';
+            checkbox.set[value] = true;
+            if (!checkbox.checked) {
+                throw new Error('Expected checkbox to be checked');
+            }
+        });
+        // Test 3: Radio button
+        test('should set checked on radio button', () => {
+            const radio = document.createElement('input');
+            radio.type = 'radio';
+            radio.set[value] = true;
+            if (!radio.checked) {
+                throw new Error('Expected radio to be checked');
+            }
+        });
+        // Test 4: Textarea element
+        test('should set value on textarea', () => {
+            const textarea = document.createElement('textarea');
+            textarea.set[value] = 'multiline text';
+            if (textarea.value !== 'multiline text') {
+                throw new Error(`Expected 'multiline text', got '${textarea.value}'`);
+            }
+        });
+        // Test 5: Select element
+        test('should set value on select', () => {
+            const select = document.createElement('select');
+            const option = document.createElement('option');
+            option.value = 'option1';
+            select.appendChild(option);
+            select.set[value] = 'option1';
+            if (select.value !== 'option1') {
+                throw new Error(`Expected 'option1', got '${select.value}'`);
+            }
+        });
+        // Test 6: Div element (textContent)
+        test('should set textContent on div', () => {
+            const div = document.createElement('div');
+            div.set[value] = 'content';
+            if (div.textContent !== 'content') {
+                throw new Error(`Expected 'content', got '${div.textContent}'`);
+            }
+        });
+        // Test 7: Time element
+        test('should set dateTime on time element', () => {
+            const time = document.createElement('time');
+            time.set[value] = '2024-01-01T00:00:00Z';
+            if (time.dateTime !== '2024-01-01T00:00:00Z') {
+                throw new Error(`Expected '2024-01-01T00:00:00Z', got '${time.dateTime}'`);
+            }
+        });
+        // Test 8: Data element
+        test('should set value on data element', () => {
+            const data = document.createElement('data');
+            data.set[value] = '12345';
+            if (data.value !== '12345') {
+                throw new Error(`Expected '12345', got '${data.value}'`);
+            }
+        });
+        // Test 9: Progress element
+        test('should set value on progress element', () => {
+            const progress = document.createElement('progress');
+            progress.max = 100;
+            progress.set[value] = 50;
+            if (progress.value !== 50) {
+                throw new Error(`Expected 50, got ${progress.value}`);
+            }
+        });
+        // Test 10: Meter element
+        test('should set value on meter element', () => {
+            const meter = document.createElement('meter');
+            meter.min = 0;
+            meter.max = 100;
+            meter.set[value] = 75;
+            if (meter.value !== 75) {
+                throw new Error(`Expected 75, got ${meter.value}`);
+            }
+        });
+        // Test 11: Output element
+        test('should set value on output element', () => {
+            const output = document.createElement('output');
+            output.set[value] = 'result';
+            if (output.value !== 'result') {
+                throw new Error(`Expected 'result', got '${output.value}'`);
+            }
+        });
+        // Test 12: Element with itemprop
+        test('should use itemprop as property name', () => {
+            const span = document.createElement('span');
+            span.setAttribute('itemprop', 'title');
+            span.set[value] = 'My Title';
+            if (span.title !== 'My Title') {
+                throw new Error(`Expected 'My Title', got '${span.title}'`);
+            }
+        });
+        // Test 13: Display property on div
+        test('should set display (textContent) on div', () => {
+            const div = document.createElement('div');
+            div.set[display] = 'displayed content';
+            if (div.textContent !== 'displayed content') {
+                throw new Error(`Expected 'displayed content', got '${div.textContent}'`);
+            }
+        });
+        // Test 14: Display property on time element
+        test('should set display (textContent) on time element', () => {
+            const time = document.createElement('time');
+            time.set[display] = 'Just now';
+            if (time.textContent !== 'Just now') {
+                throw new Error(`Expected 'Just now', got '${time.textContent}'`);
+            }
+        });
+        // Test 15: Display property on meter element
+        test('should set display (ariaValueText) on meter element', () => {
+            const meter = document.createElement('meter');
+            meter.set[display] = '75 percent';
+            if (meter.ariaValueText !== '75 percent') {
+                throw new Error(`Expected '75 percent', got '${meter.ariaValueText}'`);
+            }
+        });
+        // Test 16: Access via enh.infer
+        test('should be accessible via enh.infer', () => {
+            const input = document.createElement('input');
+            input.set[value] = 'test';
+            if (!input.enh || !input.enh.infer) {
+                throw new Error('Enhancement not accessible via enh.infer');
+            }
+            if (input.enh.infer.value !== 'test') {
+                throw new Error(`Expected cached value 'test', got '${input.enh.infer.value}'`);
+            }
+        });
+        // Test 17: Multiple assignments
+        test('should handle multiple value assignments', () => {
+            const input = document.createElement('input');
+            input.set[value] = 'first';
+            input.set[value] = 'second';
+            input.set[value] = 'third';
+            if (input.value !== 'third') {
+                throw new Error(`Expected 'third', got '${input.value}'`);
+            }
+        });
+        // Test 18: Both value and display
+        test('should handle both value and display assignments', () => {
+            const time = document.createElement('time');
+            time.set[value] = '2024-01-01T00:00:00Z';
+            time.set[display] = 'January 1, 2024';
+            if (time.dateTime !== '2024-01-01T00:00:00Z') {
+                throw new Error(`Expected dateTime '2024-01-01T00:00:00Z', got '${time.dateTime}'`);
+            }
+            if (time.textContent !== 'January 1, 2024') {
+                throw new Error(`Expected textContent 'January 1, 2024', got '${time.textContent}'`);
+            }
+        });
+        // Test 19: inferEventType for input element
+        test('should infer "input" event for input element', () => {
+            const input = document.createElement('input');
+            const eventType = inferEventType(input);
+            if (eventType !== 'input') {
+                throw new Error(`Expected 'input', got '${eventType}'`);
+            }
+        });
+        // Test 20: inferEventType for textarea element
+        test('should infer "input" event for textarea element', () => {
+            const textarea = document.createElement('textarea');
+            const eventType = inferEventType(textarea);
+            if (eventType !== 'input') {
+                throw new Error(`Expected 'input', got '${eventType}'`);
+            }
+        });
+        // Test 21: inferEventType for select element
+        test('should infer "input" event for select element', () => {
+            const select = document.createElement('select');
+            const eventType = inferEventType(select);
+            if (eventType !== 'input') {
+                throw new Error(`Expected 'input', got '${eventType}'`);
+            }
+        });
+        // Test 22: inferEventType for form element
+        test('should infer "submit" event for form element', () => {
+            const form = document.createElement('form');
+            const eventType = inferEventType(form);
+            if (eventType !== 'submit') {
+                throw new Error(`Expected 'submit', got '${eventType}'`);
+            }
+        });
+        // Test 23: inferEventType for details element
+        test('should infer "toggle" event for details element', () => {
+            const details = document.createElement('details');
+            const eventType = inferEventType(details);
+            if (eventType !== 'toggle') {
+                throw new Error(`Expected 'toggle', got '${eventType}'`);
+            }
+        });
+        // Test 24: inferEventType for dialog element
+        test('should infer "close" event for dialog element', () => {
+            const dialog = document.createElement('dialog');
+            const eventType = inferEventType(dialog);
+            if (eventType !== 'close') {
+                throw new Error(`Expected 'close', got '${eventType}'`);
+            }
+        });
+        // Test 25: inferEventType for button element (default to click)
+        test('should infer "click" event for button element', () => {
+            const button = document.createElement('button');
+            const eventType = inferEventType(button);
+            if (eventType !== 'click') {
+                throw new Error(`Expected 'click', got '${eventType}'`);
+            }
+        });
+        // Test 26: inferEventType for div element (default to click)
+        test('should infer "click" event for div element', () => {
+            const div = document.createElement('div');
+            const eventType = inferEventType(div);
+            if (eventType !== 'click') {
+                throw new Error(`Expected 'click', got '${eventType}'`);
+            }
+        });
+        // Test 27: eventType getter via enh.infer
+        test('should access eventType via enh.infer.eventType', () => {
+            const input = document.createElement('input');
+            input.set[value] = 'test';
+            if (input.enh.infer.eventType !== 'input') {
+                throw new Error(`Expected 'input', got '${input.enh.infer.eventType}'`);
+            }
+        });
+        // Test 28: eventType getter for different element types
+        test('should return correct eventType for different elements via getter', () => {
+            const form = document.createElement('form');
+            form.set[value] = 'test';
+            if (form.enh.infer.eventType !== 'submit') {
+                throw new Error(`Expected 'submit', got '${form.enh.infer.eventType}'`);
+            }
+            const button = document.createElement('button');
+            button.set[value] = 'test';
+            if (button.enh.infer.eventType !== 'click') {
+                throw new Error(`Expected 'click', got '${button.enh.infer.eventType}'`);
+            }
+        });
+        // Display results
+        const resultsDiv = document.getElementById('results');
+        resultsDiv.innerHTML = `
+            <h2>Results: ${passCount}/${testCount} tests passed</h2>
+            <pre>${results.join('\n')}</pre>
+        `;
+        // Report to parent (for Playwright)
+        window.testResults = { passed: passCount, total: testCount, results };
+    </script>
+</body>
+</html>

package/inferencer/tests/inferencer.spec.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import { test, expect } from '@playwright/test';
+test('Inferencer Enhancement › should run all inferencer tests in browser', async ({ page }) => {
+  // Start local server and navigate
+  await page.goto('http://localhost:8000/tests/inferencer.html');
+  // Wait for tests to complete
+  await page.waitForFunction(() => window.testResults !== undefined, { timeout: 5000 });
+  // Get test results
+  const results = await page.evaluate(() => window.testResults);
+  // Log results
+  console.log(`Inferencer tests: ${results.passed}/${results.total} passed`);
+  results.results.forEach((result: string) => console.log(result));
+  // Assert all tests passed
+  expect(results.passed).toBe(results.total);
+});

package/inferencer/tsconfig.json ADDED Viewed

@@ -0,0 +1,19 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module":"ESNext",
+		"sourceMap": false,
+		"experimentalDecorators": false,
+		"newLine": "LF",
+		"strict": true,
+		"skipLibCheck": true
+	},
+	"include": [
+		"inferencer.ts",
+		"InferencedPropagator.ts",
+		"upSearch.ts"
+	],
+	"exclude":[
+		"node_modules/*"
+	]
+}

package/inferencer/types/.kiro/specs/conversion-template/README.md ADDED Viewed

@@ -0,0 +1,128 @@
+# Conversion Template
+This spec template provides a structured approach to converting legacy be-* enhancement projects to the modern architecture.
+## When to Use This Template
+Use this template when:
+- You want to track conversion progress step-by-step
+- You're converting a be-* project for the first time
+- You want to review each step before proceeding
+- Multiple people are involved in the conversion
+- You want a record of the conversion process
+## How to Use This Template
+### Option 1: Copy to Project (Recommended)
+1. Copy this entire folder to your project's `.kiro/specs/` directory:
+   ```bash
+   cp -r types/.kiro/specs/conversion-template .kiro/specs/conversion-[project-name]
+   ```
+2. Update placeholders in all files:
+   - Replace `[PROJECT_NAME]` with your project name (e.g., "be-clonable")
+   - Replace `[project-name]` with kebab-case name (e.g., "be-clonable")
+   - Replace `[ClassName]` with PascalCase name (e.g., "BeClonable")
+   - Replace `[emoji]` with actual emoji if applicable (e.g., "⿻")
+3. Work through the tasks in `tasks.md` sequentially
+4. Use Kiro to execute tasks: "execute task 1", "execute task 2", etc.
+### Option 2: Use as Reference
+Simply reference this template while doing a manual conversion:
+- Follow the requirements in `requirements.md`
+- Understand the architecture from `design.md`
+- Use `tasks.md` as a checklist
+## Template Structure
+### requirements.md
+- User stories for each conversion step
+- Correctness properties to verify
+- Success criteria
+- Non-functional requirements
+### design.md
+- Architecture overview with diagrams
+- Component design for each file type
+- Data flow explanations
+- Design decisions and rationale
+- Alternatives considered
+### tasks.md
+- Detailed task breakdown (11 major tasks, 60+ subtasks)
+- Task dependencies
+- Execution notes for each step
+- Reference to ConversionInstructions.md
+## Key Features
+### Comprehensive Coverage
+All 10 conversion steps from ConversionInstructions.md are covered with detailed subtasks
+### Verification Built-in
+Task 11 provides comprehensive verification steps to ensure conversion success
+### Reference Integration
+All files reference ConversionInstructions.md for detailed step-by-step instructions
+### Kiro-Optimized
+- Uses file references: `#[[file:../../ConversionInstructions.md]]`
+- Task format compatible with Kiro's task execution
+- Structured for spec-driven development workflow
+## Example Usage with Kiro
+```
+User: "I want to convert be-clonable to the modern architecture"
+Kiro: "I can help you with that. Would you like to:
+1. Create a tracked conversion spec (recommended for first-time conversions)
+2. Do a direct conversion (faster, for experienced users)
+User: "Create a spec"
+Kiro: [Creates spec from template, updates placeholders]
+      "I've created a conversion spec at .kiro/specs/conversion-be-clonable/
+       Let's start with Task 1: Migrate Type Definitions. Ready to begin?"
+User: "Yes"
+Kiro: [Executes Task 1, marks subtasks complete]
+      "Task 1 complete. Type definitions migrated to types/be-clonable/.
+       Ready for Task 2: Archive Legacy Implementation?"
+```
+## Success Criteria
+A successful conversion using this template should result in:
+- ✅ All tasks marked complete
+- ✅ `npm run build` succeeds
+- ✅ `npm test` passes
+- ✅ No TypeScript errors
+- ✅ Legacy code preserved in legacy/ folder
+- ✅ Modern architecture verified
+## Related Files
+- `../../ConversionInstructions.md` - Detailed step-by-step instructions
+- `../../.kiro/steering/conversion-guide.md` - Kiro steering guidance
+- Reference implementations:
+  - [be-a-beacon](https://github.com/bahrus/be-a-beacon)
+  - [be-committed](https://github.com/bahrus/be-committed)
+  - [be-decked-with](https://github.com/bahrus/be-decked-with)
+## Customization
+Feel free to customize this template for your specific needs:
+- Add project-specific tasks
+- Modify verification steps
+- Add additional correctness properties
+- Extend design documentation
+## Feedback
+If you find issues with this template or have suggestions for improvement, please update the template in the types repository so all projects benefit.