@twobirds/microcomponents 0.8.0 → 0.10.0

package/dist/cli/inliner.d.ts

@@ -0,0 +1,42 @@
+/**
+ Asset inlining for the vite-free CLI bundler.
+
+ Companion `.css` / `.html` files declared by a DC class through
+ `static assets = [...]` are read at build time and embedded as a
+ `static _assets = { ... }` property inserted as the first line inside the
+ class body, so `loadAssets()` never fetches them at runtime. The original
+ `static assets` line is preserved for debugging purposes.
+
+ This is the inlining the shipped Vite plugin used, ported to run inside
+ {@link bundleEntry} without Vite: the bundler calls {@link inlineAssets} on
+ each module body before wrapping it, reading the companion files from the
+ same folder as the compiled `.js` (the mirrored `build/` tree).
+
+ @module CLI/Inliner
+ */
+/**
+ * Strip all line and block comments from source code, replacing
+ * their content with equivalent whitespace so character positions stay valid for
+ * later string slicing.
+ *
+ * @example Blanks out the `// note` segment while keeping every character
+ * position and line break, so later string slicing stays aligned.
+ * ```ts
+ * stripComments('const a = 1; // note\nconst b = 2;');
+ * ```
+ */
+export declare function stripComments(code: string): string;
+/**
+ * Inline every `static assets = [...]` declaration in a module body as a
+ * `static _assets` property, reading the companion files from `dir`.
+ *
+ * @example Returns the class with `static _assets` injected after its opening brace.
+ * ```ts
+ * await inlineAssets("class A extends DC { static assets = ['targetHtml']; }", '/build/mc');
+ * ```
+ * @param code Module source (the compiled `.js`).
+ * @param dir Folder holding the companion files next to the module.
+ * @returns The transformed code, or the original when there is nothing to inline.
+ */
+export declare function inlineAssets(code: string, dir: string): Promise<string>;
+//# sourceMappingURL=inliner.d.ts.map

package/dist/cli/inliner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inliner.d.ts","sourceRoot":"","sources":["../../src/cli/inliner.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAsDH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgClD;AAgDD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD7E"}

package/dist/cli/preview.d.ts

@@ -0,0 +1,48 @@
+/**
+ Vite-free preview server for `mc preview`.
+
+ A minimal `node:http` static server rooted at the project's `public/` folder —
+ the production site assembled by `mc bundle` (one `bundle.js`, the
+ `microcomponents.min.js` it imports, `bundle.css`, and the page shell). `/`
+ serves `index.html`; every file is served raw with its content type.
+
+ @module CLI/Preview
+ */
+import { type Server } from 'node:http';
+/**
+ * Resolve a request URL to a file in `public/`. `/` and `/index.html` map to the
+ * production shell; everything else to `public/<path>`.
+ *
+ * @example
+ * ```ts
+ * resolvePublicTarget('/bundle.js', publicRoot);
+ * resolvePublicTarget('/', publicRoot);
+ * ```
+ * @param url Request URL (path only, no query).
+ * @param publicRoot Served folder.
+ * @returns Absolute file path, or `undefined` when nothing matches.
+ */
+export declare function resolvePublicTarget(url: string, publicRoot: string): string | undefined;
+/**
+ * Build the preview server for a project: an `node:http` server rooted at `public/`.
+ *
+ * @example
+ * ```ts
+ * const server = createPreviewServer('<root>', 5174);
+ * server.listen(5174);
+ * ```
+ * @param projectRoot Project root (the folder holding `public/`).
+ * @param port Preview-server port.
+ * @param outDir Output folder relative to the root (default `public`).
+ * @returns The HTTP server (not yet listening).
+ */
+export declare function createPreviewServer(projectRoot: string, port: number, outDir?: string): Server;
+/**
+ * CLI entry for `mc preview`: serve the production site in `public/`.
+ *
+ * @param projectRoot Project root (defaults to the current directory).
+ * @param port Preview-server port.
+ * @returns The process exit code (the server keeps running until killed).
+ */
+export declare function runPreview(projectRoot?: string, port?: number): Promise<number>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/cli/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/cli/preview.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAMjG;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvF;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG,MAAM,CAKhG;AAED;;;;;;GAMG;AAEH,wBAAsB,UAAU,CAC/B,WAAW,GAAE,MAAsB,EACnC,IAAI,GAAE,MAAa,GACjB,OAAO,CAAC,MAAM,CAAC,CAOjB"}