@twobirds/microcomponents 0.3.0 → 0.4.0

package/dist/utils/helpers.js

@@ -36,10 +36,10 @@ export function isBrowser() {
  *
  * @example
  * ```ts
- * isNativeObject({});        // true
- * isNativeObject(new Object()); // true
- * isNativeObject([]);        // false
- * isNativeObject(null);      // false
+ * console.log(isNativeObject({}));
+ * console.log(isNativeObject(new Object()));
+ * console.log(isNativeObject([]));
+ * console.log(isNativeObject(null));
  * ```
  */
 export function isNativeObject(value) {
@@ -53,7 +53,7 @@ export function isNativeObject(value) {
  * @example
  * ```ts
  * const obj = { z: 1, a: { y: 2, b: 3 } };
- * sortObject(obj); // { a: { b: 3, y: 2 }, z: 1 }
+ * console.log(JSON.stringify(sortObject(obj)));
  * ```
  */
 export function sortObject(source) {
@@ -81,7 +81,7 @@ export function sortObject(source) {
  * @example
  * ```ts
  * const obj = { user: { name: 'Alice', age: 30 } };
- * flattenObject(obj); // { 'user.age': 30, 'user.name': 'Alice' }
+ * console.log(JSON.stringify(flattenObject(obj)));
  * ```
  */
 export function flattenObject(source, doSort = true) {
@@ -117,10 +117,10 @@ export function flattenObject(source, doSort = true) {
  *
  * @example
  * ```ts
- * deepEqual({ a: 1 }, { a: 1 });          // true
- * deepEqual({ a: { b: 2 } }, { a: {} });  // false
- * deepEqual({ a: NaN }, { a: NaN });      // true  (SameValueZero)
- * deepEqual({ a: NaN }, { a: null });     // false
+ * console.log(deepEqual({ a: 1 }, { a: 1 }));
+ * console.log(deepEqual({ a: { b: 2 } }, { a: {} }));
+ * console.log(deepEqual({ a: NaN }, { a: NaN }));
+ * console.log(deepEqual({ a: NaN }, { a: null }));
  * ```
  */
 export function deepEqual(a, b) {
@@ -168,8 +168,8 @@ export function deepEqual(a, b) {
  * @example
  * ```ts
  * const data = { user: { profile: { name: 'Alice' } } };
- * nameSpace('user.profile.name', data); // 'Alice'
- * nameSpace(['user', 'profile'], data);  // { name: 'Alice' }
+ * console.log(nameSpace('user.profile.name', data));
+ * console.log(nameSpace(['user', 'profile'], data));
  * ```
  */
 export function nameSpace(ns, obj = {}) {
@@ -198,9 +198,8 @@ export function nameSpace(ns, obj = {}) {
  * @example
  * ```ts
  * const data = { user: { name: 'Alice' } };
- * parse('Hello {user.name}!', data); // 'Hello Alice!'
- *
- * parse(['Hi {user.name}', 'Bye {user.name}'], data); // ['Hi Alice', 'Bye Alice']
+ * console.log(parse('Hello {user.name}!', data));
+ * console.log(parse(['Hi {user.name}', 'Bye {user.name}'], data));
  * ```
  */
 export function parse(template, parseThis, ...rest) {
@@ -241,7 +240,7 @@ export function parse(template, parseThis, ...rest) {
  *
  * @example
  * ```ts
- * kebabToPascal('my-element'); // 'MyElement'
+ * console.log(kebabToPascal('my-element'));
  * ```
  */
 export function kebabToPascal(str) {
@@ -261,7 +260,8 @@ export function kebabToPascal(str) {
  * @example
  * ```ts
  * const log = debounce(() => console.log('called'), 300);
- * log(); // will only execute once after 300ms of inactivity
+ * log();
+ * log();
  * ```
  */
 export function debounce(func, milliseconds) {
@@ -283,7 +283,7 @@ export function debounce(func, milliseconds) {
  * @example
  * ```ts
  * const elems = htmlToElements('<div>Hello</div><span>World</span>');
- * // [HTMLElement<div>, HTMLElement<span>]
+ * console.log(elems.map((el) => el.tagName));
  * ```
  */
 export function htmlToElements(html) {
@@ -305,7 +305,7 @@ export function htmlToElements(html) {
  * const src = { get name() { return 'Alice'; } };
  * const tgt = {};
  * copyGettersSetters(src, tgt);
- * console.log(tgt.name); // 'Alice'
+ * console.log(tgt.name);
  * ```
  */
 export function copyGettersSetters(source, target) {

package/dist/utils/index.d.ts

@@ -5,7 +5,7 @@ Utils module — events, autoload, and helper utilities.
 @showGroups
 */
 /** @group Events */
-export { getMcEventName, trueEventName, off, on, one, trigger, BubbleController } from './events.js';
+export { getMcEventName, trueEventName, off, on, one, trigger, BubbleController, } from './events.js';
 /** @hidden */
 export type { QuerySelectorString, TargetSelect } from './events.js';
 /** @group Autoload */
@@ -13,5 +13,5 @@ export { autoload } from './autoload.js';
 /** @hidden */
 export type { Autoload } from './autoload.js';
 /** @group Helpers */
-export { isBrowser, isNativeObject, sortObject, flattenObject, deepEqual, nameSpace, parse, kebabToPascal, debounce, htmlToElements, copyGettersSetters, injectCSS, processAssets, loadAssets, bindTemplateEvents } from './helpers.js';
+export { isBrowser, isNativeObject, sortObject, flattenObject, deepEqual, nameSpace, parse, kebabToPascal, debounce, htmlToElements, copyGettersSetters, injectCSS, processAssets, loadAssets, bindTemplateEvents, } from './helpers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;EAKE;AAEF,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrG,cAAc;AACd,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc;AACd,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;EAKE;AAEF,oBAAoB;AACpB,OAAO,EACN,cAAc,EACd,aAAa,EACb,GAAG,EACH,EAAE,EACF,GAAG,EACH,OAAO,EACP,gBAAgB,GAChB,MAAM,aAAa,CAAC;AACrB,cAAc;AACd,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc;AACd,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,qBAAqB;AACrB,OAAO,EACN,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa,EACb,SAAS,EACT,SAAS,EACT,KAAK,EACL,aAAa,EACb,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,GAClB,MAAM,cAAc,CAAC"}

package/dist/utils/index.js

@@ -5,8 +5,8 @@ Utils module — events, autoload, and helper utilities.
 @showGroups
 */
 /** @group Events */
-export { getMcEventName, trueEventName, off, on, one, trigger, BubbleController } from './events.js';
+export { getMcEventName, trueEventName, off, on, one, trigger, BubbleController, } from './events.js';
 /** @group Autoload */
 export { autoload } from './autoload.js';
 /** @group Helpers */
-export { isBrowser, isNativeObject, sortObject, flattenObject, deepEqual, nameSpace, parse, kebabToPascal, debounce, htmlToElements, copyGettersSetters, injectCSS, processAssets, loadAssets, bindTemplateEvents } from './helpers.js';
+export { isBrowser, isNativeObject, sortObject, flattenObject, deepEqual, nameSpace, parse, kebabToPascal, debounce, htmlToElements, copyGettersSetters, injectCSS, processAssets, loadAssets, bindTemplateEvents, } from './helpers.js';

package/dist/utils/resolveComponentPath.d.ts

@@ -0,0 +1,36 @@
+/**
+@module Autoload
+
+Single source of truth for the tag-to-file convention: hyphens become path
+separators, so `my-card` resolves to `./my/card.js`. Imported by the runtime
+autoload loader and by build-time tooling so both agree on the path without
+either duplicating the rule.
+*/
+/**
+The tag-to-path primitive: hyphens become path separators, with no prefix or
+extension. `my-card` → `my/card`. The single source of truth for the
+convention; {@link resolveComponentPath} and build-time tooling both derive
+their paths from it so neither duplicates the rule.
+
+@example Returns `'my/card'` for `my-card`, and `'app/header'` for `app-header`.
+```ts
+tagPath('my-card');
+tagPath('app-header');
+```
+@hidden
+@group Autoload
+*/
+export declare function tagPath(tag: string): string;
+/**
+Resolves a microcomponent tag name to its autoload module path by prefixing and
+suffixing {@link tagPath}: `my-card` → `./my/card.js`.
+
+@example Returns `'./my/card.js'` for `my-card`, and `'./app/header.js'` for `app-header`.
+```ts
+resolveComponentPath('my-card');
+resolveComponentPath('app-header');
+```
+@group Autoload
+*/
+export declare function resolveComponentPath(tag: string): string;
+//# sourceMappingURL=resolveComponentPath.d.ts.map

package/dist/utils/resolveComponentPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveComponentPath.d.ts","sourceRoot":"","sources":["../../src/utils/resolveComponentPath.ts"],"names":[],"mappings":"AAAA;;;;;;;EAOE;AAEF;;;;;;;;;;;;;EAaE;AACF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;;;;;EAUE;AACF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/utils/resolveComponentPath.js

@@ -0,0 +1,39 @@
+/**
+@module Autoload
+
+Single source of truth for the tag-to-file convention: hyphens become path
+separators, so `my-card` resolves to `./my/card.js`. Imported by the runtime
+autoload loader and by build-time tooling so both agree on the path without
+either duplicating the rule.
+*/
+/**
+The tag-to-path primitive: hyphens become path separators, with no prefix or
+extension. `my-card` → `my/card`. The single source of truth for the
+convention; {@link resolveComponentPath} and build-time tooling both derive
+their paths from it so neither duplicates the rule.
+
+@example Returns `'my/card'` for `my-card`, and `'app/header'` for `app-header`.
+```ts
+tagPath('my-card');
+tagPath('app-header');
+```
+@hidden
+@group Autoload
+*/
+export function tagPath(tag) {
+    return tag.split('-').join('/');
+}
+/**
+Resolves a microcomponent tag name to its autoload module path by prefixing and
+suffixing {@link tagPath}: `my-card` → `./my/card.js`.
+
+@example Returns `'./my/card.js'` for `my-card`, and `'./app/header.js'` for `app-header`.
+```ts
+resolveComponentPath('my-card');
+resolveComponentPath('app-header');
+```
+@group Autoload
+*/
+export function resolveComponentPath(tag) {
+    return './' + tagPath(tag) + '.js';
+}

package/package.json

@@ -1,20 +1,20 @@
 {
 	"name": "@twobirds/microcomponents",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"description": "Micro Components",
 	"keywords": [
-		"custom elements",
-		"web components",
-		"javascript",
-		"typescript",
 		"PWA",
 		"SPA",
 		"client",
-		"library",
+		"custom elements",
 		"framework",
+		"javascript",
+		"library",
 		"lightweight",
 		"native",
-		"standalone"
+		"standalone",
+		"typescript",
+		"web components"
 	],
 	"license": "MIT",
 	"author": "Frank Thürigen",
@@ -32,6 +32,9 @@
 		"type": "git",
 		"url": "git+https://gitlab.com/twoBirds/microcomponents.git"
 	},
+	"bin": {
+		"mc": "./dist/cli/index.js"
+	},
 	"files": [
 		"dist"
 	],
@@ -70,23 +73,27 @@
 		"format": "oxfmt .",
 		"lint": "oxlint \"src\"",
 		"fix": "oxfmt . && oxlint \"src\" --fix",
-		"check": "tsc --noEmit -p tsconfig.lib.json && tsc -p tsconfig.test.json && tsc -p demo/web-test/tsconfig.demo.json && tsc -p tsconfig.node.json",
+		"check": "tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.cli.json && tsc -p tsconfig.test.json && tsc -p demo/web-test/tsconfig.demo.json && tsc --noEmit -p demo/shop/tsconfig.demo.json && tsc --noEmit -p demo/todo_mvc/tsconfig.demo.json && tsc -p tsconfig.node.json",
 		"check:pack": "publint && attw --pack . --profile esm-only",
 		"test": "vitest",
 		"test:run": "vitest run --reporter=verbose",
 		"test:coverage": "vitest run --coverage",
 		"demo:shop": "vite --config demo/shop/vite.config.ts",
 		"demo:shop:bundled": "tsx demo/shop/vite.shop.bundle.ts",
-		"demo:shop:build": "tsx demo/shop/vite.shop.ts && pnpm run demo:shop:bundled",
+		"demo:shop:build": "tsx demo/build-demo.ts shop && pnpm run demo:shop:bundled",
 		"demo:shop:serve": "vite preview --outDir public/shop --port 5174 --host",
+		"demo:todo": "vite --config demo/todo_mvc/vite.config.ts",
+		"demo:todo:build": "tsx demo/build-demo.ts todo_mvc",
+		"demo:todo:serve": "vite preview --outDir public/todo_mvc --port 5175 --host",
 		"typedoc": "typedoc --displayBasePath ./typedoc/",
 		"bundle": "tsx vite.build.ts",
-		"clean": "rm -rf dist public build",
-		"build": "pnpm run clean && tsc -p tsconfig.lib.json && pnpm run test:coverage && pnpm run bundle && pnpm run check:pack && pnpm run typedoc && pnpm run demo:build && pnpm run demo:shop:build && find src -name '*.js' -delete",
+		"clean": "rm -rf dist public build coverage",
+		"build": "pnpm run clean && tsc -p tsconfig.lib.json && tsc -p tsconfig.cli.json && chmod +x dist/cli/index.js && pnpm run test:coverage && pnpm run bundle && pnpm run check:pack && pnpm run typedoc && pnpm run demo:build && pnpm run demo:shop:build && pnpm run demo:todo:build && find src -name '*.js' -delete",
 		"demo:build": "tsx demo/web-test/vite.demo.ts",
-		"dev": "vite preview --outDir public/test --port 10000 --host",
+		"dev": "vite preview --outDir build/web-test --port 10000 --host",
 		"doc": "vite preview --outDir public/typedoc --port 11000 --host",
 		"watch": "tsx watch.ts",
+		"cli": "tsx src/cli/index.ts",
 		"mcp:dev": "tsx watch microcomponents-mcp-server.ts",
 		"mcp:docs": "node mcp-docs-generate.ts",
 		"mcp:run": "tsx microcomponents-mcp-server.ts",
@@ -113,4 +120,3 @@
 	},
 	"packageManager": "pnpm@12.4.1"
 }
-