@lumeland/core 0.0.0-stage → 1.0.0-beta-3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 - Oscar Otero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build/deps/cli.d.ts

@@ -0,0 +1 @@
+export { parseArgs } from "deno-std/cli/parse_args.js";

package/build/deps/cli.js

@@ -0,0 +1 @@
+export { parseArgs } from "deno-std/cli/parse_args.js";

package/build/deps/colors.d.ts

@@ -0,0 +1 @@
+export * from "deno-std/fmt/colors.js";

package/build/deps/colors.js

@@ -0,0 +1 @@
+export * from "deno-std/fmt/colors.js";

package/build/deps/crypto.d.ts

@@ -0,0 +1 @@
+export { createHash } from "node:crypto";

package/build/deps/crypto.js

@@ -0,0 +1 @@
+export { createHash } from "node:crypto";

package/build/deps/dom.d.ts

@@ -0,0 +1 @@
+export * from "@lumeland/dom";

package/build/deps/dom.js

@@ -0,0 +1 @@
+export * from "@lumeland/dom";

package/build/deps/esbuild.d.ts

@@ -0,0 +1 @@
+export * from "esbuild";

package/build/deps/esbuild.js

@@ -0,0 +1 @@
+export * from "esbuild";

package/build/deps/front_matter.d.ts

@@ -0,0 +1,2 @@
+export * from "deno-std/front_matter/any.js";
+export { test } from "deno-std/front_matter/test.js";

package/build/deps/front_matter.js

@@ -0,0 +1,2 @@
+export * from "deno-std/front_matter/any.js";
+export { test } from "deno-std/front_matter/test.js";

package/build/deps/jsonc.d.ts

@@ -0,0 +1 @@
+export { parse } from "deno-std/jsonc/parse.js";

package/build/deps/jsonc.js

@@ -0,0 +1 @@
+export { parse } from "deno-std/jsonc/parse.js";

package/build/deps/lightningcss.d.ts

@@ -0,0 +1 @@
+export * from "lightningcss";

package/build/deps/lightningcss.js

@@ -0,0 +1 @@
+export * from "lightningcss";

package/build/deps/media_types.d.ts

@@ -0,0 +1,2 @@
+export { contentType } from "deno-std/media_types/content_type.js";
+export { typeByExtension } from "deno-std/media_types/type_by_extension.js";

package/build/deps/media_types.js

@@ -0,0 +1,2 @@
+export { contentType } from "deno-std/media_types/content_type.js";
+export { typeByExtension } from "deno-std/media_types/type_by_extension.js";

package/build/deps/module.d.ts

@@ -0,0 +1 @@
+export { registerHooks } from "node:module";

package/build/deps/module.js

@@ -0,0 +1 @@
+export { registerHooks } from "node:module";

package/build/deps/path.d.ts

@@ -0,0 +1,4 @@
+export { posix, sep as SEPARATOR } from "node:path";
+export { basename, dirname, extname, join, relative } from "node:path";
+export { globToRegExp } from "deno-std/path/glob_to_regexp.js";
+export { fileURLToPath as fromFileUrl, pathToFileURL as toFileUrl } from "node:url";

package/build/deps/path.js

@@ -0,0 +1,11 @@
+export { posix, sep as SEPARATOR } from "node:path";
+export { basename, dirname, extname, join, relative } from "node:path";
+export { globToRegExp } from "deno-std/path/glob_to_regexp.js";
+export { fileURLToPath as fromFileUrl, pathToFileURL as toFileUrl } from "node:url";
+// posix.dirname
+// posix.join
+// posix.basename
+// posix.extname
+// posix.normalize
+// posix.relative
+// posix.resolve

package/build/deps/remove-markdown.d.ts

@@ -0,0 +1,17 @@
+export declare function plainText(md: string, options?: RemoveMarkdownOptions): string;
+export interface RemoveMarkdownOptions {
+    /** strip list leaders (default: true) */
+    stripListLeaders?: boolean;
+    /** char to insert instead of stripped list leaders (default: '') */
+    listUnicodeChar?: string;
+    /** support GitHub-Flavored Markdown (default: true) */
+    gfm?: boolean;
+    /** replace images with alt-text, if present (default: true) */
+    useImgAltText?: boolean;
+    /** remove abbreviations, if present (default: false) */
+    abbr?: boolean;
+    /** replace links with URLs instead anchor text (default: false) */
+    replaceLinksWithURL?: boolean;
+    /** HTML tags to skip, if present */
+    htmlTagsToSkip?: string[];
+}

package/build/deps/remove-markdown.js

@@ -0,0 +1,4 @@
+import removeMarkdown from "remove-markdown";
+export function plainText(md, options) {
+    return removeMarkdown(md, options).replaceAll(/\s+/g, " ").trim();
+}

package/build/deps/resvg.d.ts

@@ -0,0 +1,3 @@
+import { type ResvgRenderOptions } from "@resvg/resvg-js";
+export type { ResvgRenderOptions };
+export declare function toPng(svg: string, options?: ResvgRenderOptions): Uint8Array;

package/build/deps/resvg.js

@@ -0,0 +1,6 @@
+import { Resvg } from "@resvg/resvg-js";
+export function toPng(svg, options = { fitTo: { mode: "original" } }) {
+    const resvg = new Resvg(svg, options);
+    const pngData = resvg.render();
+    return pngData.asPng();
+}

package/build/deps/semver.d.ts

@@ -0,0 +1 @@
+export { canParse, format, maxSatisfying, parse, parseRange } from "deno-std/semver/mod.js";

package/build/deps/semver.js

@@ -0,0 +1 @@
+export { canParse, format, maxSatisfying, parse, parseRange } from "deno-std/semver/mod.js";

package/build/deps/sharp.d.ts

@@ -0,0 +1,5 @@
+export type { FormatEnum, ResizeOptions, Sharp } from "sharp";
+import type { Sharp, SharpOptions } from "sharp";
+import { type ResvgRenderOptions } from "./resvg.ts";
+export declare function sharpsToIco(...images: Sharp[]): Promise<any>;
+export declare function create(content: Uint8Array | string, config?: SharpOptions, svgOptions?: ResvgRenderOptions): Sharp;

package/build/deps/sharp.js

@@ -0,0 +1,16 @@
+import sharp from "sharp";
+// @ts-expect-error: no types for ico-endec
+import icoEndec from "ico-endec";
+import { toPng } from "./resvg.js";
+export async function sharpsToIco(...images) {
+    const buffers = await Promise.all(images.map((image) => image.toFormat("png").toBuffer()));
+    // deno-lint-ignore no-explicit-any
+    return icoEndec.encode(buffers.map((buffer) => buffer.buffer));
+}
+export function create(content, config = {}, svgOptions) {
+    // It's a SVG
+    if (typeof content === "string") {
+        return sharp(toPng(content, svgOptions));
+    }
+    return sharp(content, config);
+}

package/build/deps/toml.d.ts

@@ -0,0 +1 @@
+export { parse } from "deno-std/toml/parse.js";

package/build/deps/toml.js

@@ -0,0 +1 @@
+export { parse } from "deno-std/toml/parse.js";

package/build/deps/yaml.d.ts

@@ -0,0 +1,2 @@
+export { parse } from "deno-std/yaml/parse.js";
+export { stringify } from "deno-std/yaml/stringify.js";

package/build/deps/yaml.js

@@ -0,0 +1,2 @@
+export { parse } from "deno-std/yaml/parse.js";
+export { stringify } from "deno-std/yaml/stringify.js";

package/build/src/archetypes.d.ts

@@ -0,0 +1,20 @@
+export interface Options {
+    src: string;
+    root: string;
+}
+export default class Archetypes {
+    archetypes: Map<string, string | Archetype>;
+    src: string;
+    root: string;
+    constructor(options: Options);
+    register(name: string, archetype: string | Archetype): void;
+    run(name: string, args?: string[]): Promise<void>;
+    save(file: ArchetypeFile): Promise<void>;
+    load(name: string): Promise<Archetype>;
+}
+export type Archetype = (...args: string[]) => void | ArchetypeFile | Generator<ArchetypeFile> | AsyncGenerator<ArchetypeFile>;
+export interface ArchetypeFile<T = unknown> {
+    base?: "src" | "root";
+    path: string;
+    content: T | ((prev?: T) => T | Promise<T>);
+}

package/build/src/archetypes.js

@@ -0,0 +1,152 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { parse, stringify } from "../deps/yaml.js";
+import { extract, test } from "../deps/front_matter.js";
+import { ensureDir } from "./utils/fs.js";
+import { dirname, join, toFileUrl } from "../deps/path.js";
+import { isGenerator } from "./utils/generator.js";
+import { log } from "./utils/log.js";
+import { isUrl } from "./utils/path.js";
+import { cwd } from "./services/process.js";
+import { readTextFile, writeFile, writeTextFile } from "./services/fs.js";
+export default class Archetypes {
+    archetypes = new Map();
+    src;
+    root;
+    constructor(options) {
+        this.src = options.src;
+        this.root = options.root;
+    }
+    register(name, archetype) {
+        this.archetypes.set(name, archetype);
+    }
+    async run(name, args = []) {
+        let archetype;
+        try {
+            archetype = await this.load(name);
+        }
+        catch (cause) {
+            log.fatal(`[archetype] Archetype "${name}" not found or is errored.: ${cause.message}`);
+            return;
+        }
+        if (typeof archetype !== "function") {
+            log.fatal(`[archetype] Archetype "${name}" is not a valid function.`);
+            return;
+        }
+        if (isGenerator(archetype)) {
+            for await (const file of archetype(...args)) {
+                await this.save(file);
+            }
+        }
+        else {
+            const file = archetype(...args);
+            if (file) {
+                await this.save(file);
+            }
+        }
+    }
+    async save(file) {
+        const { path, base = "src", content } = file;
+        if (!path) {
+            throw new Error("Archetype path is required.");
+        }
+        if (!content) {
+            throw new Error("Archetype content is required.");
+        }
+        const fullPath = join(base === "root" ? this.root : this.src, path);
+        if (typeof content === "string" || content instanceof Uint8Array) {
+            return await saveFile(fullPath, content);
+        }
+        if (path.endsWith(".json")) {
+            return await runObjectArchetype(fullPath, content, JSON.parse, (o) => JSON.stringify(o, null, 2));
+        }
+        if (path.endsWith(".yaml") || path.endsWith(".yml")) {
+            return await runObjectArchetype(fullPath, content, parse, stringify);
+        }
+        return await runObjectArchetype(fullPath, content, (content) => {
+            if (test(content)) {
+                const { attrs, body } = extract(content);
+                return { ...attrs, content: body };
+            }
+            return { content };
+        }, (data) => {
+            const { content: body, ...frontmatter } = data;
+            return `---\n${stringify(frontmatter)}---\n${body || ""}\n`;
+        });
+    }
+    async load(name) {
+        const registered = this.archetypes.get(name);
+        if (registered) {
+            if (typeof registered === "string") {
+                return (await import(__rewriteRelativeImportExtension(registered))).default;
+            }
+            return registered;
+        }
+        if (name.startsWith(".")) {
+            return (await import(__rewriteRelativeImportExtension(toFileUrl(join(cwd(), name)).href))).default;
+        }
+        if (isUrl(name)) {
+            return (await import(__rewriteRelativeImportExtension(name))).default;
+        }
+        return (await Promise.any([
+            import(__rewriteRelativeImportExtension(toFileUrl(join(this.root, `_archetypes/${name}.ts`)).href)),
+            import(__rewriteRelativeImportExtension(toFileUrl(join(this.root, `_archetypes/${name}.js`)).href)),
+        ])).default;
+    }
+}
+async function saveFile(path, content, overwrite = false) {
+    ensureDir(dirname(path));
+    try {
+        if (content instanceof Uint8Array) {
+            await writeFile(path, content, !overwrite);
+        }
+        else {
+            await writeTextFile(path, content, !overwrite);
+        }
+        if (overwrite) {
+            log.info(`✔️ Updated file: <gray>${path}</gray>`);
+        }
+        else {
+            log.info(`✔️ Created file: <gray>${path}</gray>`);
+        }
+    }
+    catch (error) {
+        if (error.code === "exists") {
+            log.warn(`⚠️ File already exists: <gray>${path}</gray>`);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+async function runObjectArchetype(fullPath, content, parse, stringify) {
+    let newContent;
+    let overwrite = false;
+    if (typeof content === "function") {
+        const fn = content;
+        const previousContent = await readFile(fullPath);
+        newContent = previousContent ? await fn(parse(previousContent)) : await fn();
+        overwrite = true;
+    }
+    else {
+        newContent = content;
+    }
+    return await saveFile(fullPath, stringify(newContent) + "\n", overwrite);
+}
+async function readFile(path) {
+    try {
+        return await readTextFile(path);
+    }
+    catch (error) {
+        if (error.code === "not-found") {
+            return;
+        }
+        throw error;
+    }
+}

package/build/src/cache.d.ts

@@ -0,0 +1,22 @@
+export interface Options {
+    /** The folder to load the files from */
+    folder: string;
+}
+/**
+ * Class to manage cache in the _cache folder
+ */
+export default class Cache {
+    #private;
+    constructor(options: Options);
+    /** Save some content in the cache folder */
+    set(key: unknown[], value: string | Uint8Array): void;
+    /** Remove content from the cache folder */
+    remove(key: unknown[]): void;
+    getPath(key: unknown[]): string;
+    /** Get the content from the cache folder as Uint8Array */
+    getBytes(key: unknown[]): Uint8Array<ArrayBuffer> | undefined;
+    /** Get the content from the cache folder as string */
+    getText(key: unknown[]): string | undefined;
+    /** Empty the cache folder */
+    clear(): void;
+}

package/build/src/cache.js

@@ -0,0 +1,64 @@
+import { emptyDir, ensureDir } from "./utils/fs.js";
+import { posix } from "../deps/path.js";
+import { readFileSync, readTextFileSync, removeSync, writeFileSync, writeTextFileSync, } from "./services/fs.js";
+import { md5 } from "./utils/digest.js";
+/**
+ * Class to manage cache in the _cache folder
+ */
+export default class Cache {
+    #folder;
+    constructor(options) {
+        this.#folder = options.folder;
+    }
+    /** Save some content in the cache folder */
+    set(key, value) {
+        const path = this.getPath(key);
+        ensureDir(posix.dirname(path));
+        if (typeof value === "string") {
+            writeTextFileSync(path, value);
+        }
+        else {
+            writeFileSync(path, value);
+        }
+    }
+    /** Remove content from the cache folder */
+    remove(key) {
+        try {
+            removeSync(this.getPath(key));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    getPath(key) {
+        const paths = key.map((value) => {
+            if (value instanceof Uint8Array || typeof value === "string") {
+                return md5(value);
+            }
+            return md5(JSON.stringify(value));
+        });
+        return posix.join(this.#folder, ...paths);
+    }
+    /** Get the content from the cache folder as Uint8Array */
+    getBytes(key) {
+        try {
+            return readFileSync(this.getPath(key));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /** Get the content from the cache folder as string */
+    getText(key) {
+        try {
+            return readTextFileSync(this.getPath(key));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /** Empty the cache folder */
+    clear() {
+        emptyDir(this.#folder);
+    }
+}

package/build/src/components.d.ts

@@ -0,0 +1,61 @@
+import { Entry } from "./fs.ts";
+import type { DirectoryData } from "./types.ts";
+import type Formats from "./formats.ts";
+export interface Options {
+    /** The registered file formats */
+    formats: Formats;
+}
+/**
+ * Class to load components from the _components folder.
+ */
+export declare class ComponentLoader {
+    #private;
+    /** List of loaders and engines used by extensions */
+    formats: Formats;
+    constructor(options: Options);
+    /** Load a directory of components */
+    load(dirEntry: Entry, data: DirectoryData, components?: Components): Promise<Components>;
+}
+export type Components = Map<string, Component | Components>;
+export interface Component {
+    /** Name of the component (used to get it from templates) */
+    name: string;
+    /** The function to render the component */
+    render: (props: Record<string, unknown>) => string | Promise<string>;
+    /** Optional CSS and JS code needed to style the component (global, only inserted once) */
+    assets: Map<string, string | Entry>;
+}
+/** Component defined directly by the user */
+export interface UserComponent {
+    /** Name of the component (used to get it from templates) */
+    name: string;
+    /** The function to render the component */
+    render: (props: Record<string, unknown>) => string | Promise<string>;
+    /** Optional CSS code needed to style the component (global, only inserted once) */
+    css?: string;
+    /** Optional JS code needed for the component interactivity (global, only inserted once) */
+    js?: string;
+}
+export interface ComponentFile {
+    /** The content of the component */
+    content: unknown;
+    /** Optional CSS code needed to style the component (global, only inserted once) */
+    css?: string;
+    /** Optional JS code needed for the component interactivity (global, only inserted once) */
+    js?: string;
+    /** If false, the data from the parent directory will not be inherited */
+    inheritData?: boolean;
+    /** Extra default data stored in the component */
+    [key: string]: unknown;
+}
+export declare function compileCSS(filename: string, imports: Map<string, string | Entry>, entries: Map<string, Entry>): Promise<string>;
+export declare function compileJS(filename: string, imports: Map<string, string | Entry>, entries: Map<string, Entry>): Promise<string>;
+export interface ProxyComponents {
+    (props?: Record<string, unknown>): any;
+    [key: string]: ProxyComponents;
+}
+/**
+ * Create and returns a proxy to use the components
+ * as comp.name() instead of components.get("name").render()
+ */
+export declare function toProxy(components: Components, extraCode: Map<string, string | Entry>): ProxyComponents;