@webstir-io/webstir-frontend 0.1.40

package/dist/config/schema.d.ts

@@ -0,0 +1,413 @@
+import { z } from 'zod';
+export declare const frontendPathSchema: z.ZodObject<{
+    workspace: z.ZodString;
+    src: z.ZodObject<{
+        root: z.ZodString;
+        frontend: z.ZodString;
+        app: z.ZodString;
+        pages: z.ZodString;
+        content: z.ZodString;
+        images: z.ZodString;
+        fonts: z.ZodString;
+        media: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }>;
+    build: z.ZodObject<{
+        root: z.ZodString;
+        frontend: z.ZodString;
+        app: z.ZodString;
+        pages: z.ZodString;
+        content: z.ZodString;
+        images: z.ZodString;
+        fonts: z.ZodString;
+        media: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }>;
+    dist: z.ZodObject<{
+        root: z.ZodString;
+        frontend: z.ZodString;
+        app: z.ZodString;
+        pages: z.ZodString;
+        content: z.ZodString;
+        images: z.ZodString;
+        fonts: z.ZodString;
+        media: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }, {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    src: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    build: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    dist: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    workspace: string;
+}, {
+    src: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    build: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    dist: {
+        frontend: string;
+        app: string;
+        pages: string;
+        images: string;
+        fonts: string;
+        media: string;
+        root: string;
+        content: string;
+    };
+    workspace: string;
+}>;
+export declare const frontendFeatureFlagsSchema: z.ZodObject<{
+    htmlSecurity: z.ZodDefault<z.ZodBoolean>;
+    imageOptimization: z.ZodDefault<z.ZodBoolean>;
+    precompression: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    htmlSecurity: boolean;
+    imageOptimization: boolean;
+    precompression: boolean;
+}, {
+    htmlSecurity?: boolean | undefined;
+    imageOptimization?: boolean | undefined;
+    precompression?: boolean | undefined;
+}>;
+export declare const frontendConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    paths: z.ZodObject<{
+        workspace: z.ZodString;
+        src: z.ZodObject<{
+            root: z.ZodString;
+            frontend: z.ZodString;
+            app: z.ZodString;
+            pages: z.ZodString;
+            content: z.ZodString;
+            images: z.ZodString;
+            fonts: z.ZodString;
+            media: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }>;
+        build: z.ZodObject<{
+            root: z.ZodString;
+            frontend: z.ZodString;
+            app: z.ZodString;
+            pages: z.ZodString;
+            content: z.ZodString;
+            images: z.ZodString;
+            fonts: z.ZodString;
+            media: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }>;
+        dist: z.ZodObject<{
+            root: z.ZodString;
+            frontend: z.ZodString;
+            app: z.ZodString;
+            pages: z.ZodString;
+            content: z.ZodString;
+            images: z.ZodString;
+            fonts: z.ZodString;
+            media: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }, {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        src: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        build: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        dist: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        workspace: string;
+    }, {
+        src: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        build: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        dist: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        workspace: string;
+    }>;
+    features: z.ZodObject<{
+        htmlSecurity: z.ZodDefault<z.ZodBoolean>;
+        imageOptimization: z.ZodDefault<z.ZodBoolean>;
+        precompression: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        htmlSecurity: boolean;
+        imageOptimization: boolean;
+        precompression: boolean;
+    }, {
+        htmlSecurity?: boolean | undefined;
+        imageOptimization?: boolean | undefined;
+        precompression?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    features: {
+        htmlSecurity: boolean;
+        imageOptimization: boolean;
+        precompression: boolean;
+    };
+    version: 1;
+    paths: {
+        src: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        build: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        dist: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        workspace: string;
+    };
+}, {
+    features: {
+        htmlSecurity?: boolean | undefined;
+        imageOptimization?: boolean | undefined;
+        precompression?: boolean | undefined;
+    };
+    version: 1;
+    paths: {
+        src: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        build: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        dist: {
+            frontend: string;
+            app: string;
+            pages: string;
+            images: string;
+            fonts: string;
+            media: string;
+            root: string;
+            content: string;
+        };
+        workspace: string;
+    };
+}>;
+export type FrontendConfigInput = z.infer<typeof frontendConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+export const frontendPathSchema = z.object({
+    workspace: z.string(),
+    src: z.object({
+        root: z.string(),
+        frontend: z.string(),
+        app: z.string(),
+        pages: z.string(),
+        content: z.string(),
+        images: z.string(),
+        fonts: z.string(),
+        media: z.string()
+    }),
+    build: z.object({
+        root: z.string(),
+        frontend: z.string(),
+        app: z.string(),
+        pages: z.string(),
+        content: z.string(),
+        images: z.string(),
+        fonts: z.string(),
+        media: z.string()
+    }),
+    dist: z.object({
+        root: z.string(),
+        frontend: z.string(),
+        app: z.string(),
+        pages: z.string(),
+        content: z.string(),
+        images: z.string(),
+        fonts: z.string(),
+        media: z.string()
+    })
+});
+export const frontendFeatureFlagsSchema = z.object({
+    htmlSecurity: z.boolean().default(true),
+    imageOptimization: z.boolean().default(true),
+    precompression: z.boolean().default(true)
+});
+export const frontendConfigSchema = z.object({
+    version: z.literal(1),
+    paths: frontendPathSchema,
+    features: frontendFeatureFlagsSchema
+});

package/dist/config/setup.d.ts

@@ -0,0 +1,2 @@
+import type { FrontendConfig } from '../types.js';
+export declare function prepareWorkspaceConfig(workspaceRoot: string): Promise<FrontendConfig>;

package/dist/config/setup.js

@@ -0,0 +1,12 @@
+import { writeConfigManifest } from './manifest.js';
+import { buildConfig } from './workspace.js';
+import { ensureWebstirDirectory, resolveManifestPath } from './paths.js';
+export async function prepareWorkspaceConfig(workspaceRoot) {
+    const config = buildConfig(workspaceRoot);
+    await ensureWebstirDirectory(workspaceRoot);
+    await writeConfigManifest({
+        outputPath: resolveManifestPath(workspaceRoot),
+        data: config
+    });
+    return config;
+}

package/dist/config/workspace.d.ts

@@ -0,0 +1,2 @@
+import type { FrontendConfig } from '../types.js';
+export declare function buildConfig(workspaceRoot: string): FrontendConfig;

package/dist/config/workspace.js

@@ -0,0 +1,131 @@
+import fs from 'node:fs';
+import path from 'path';
+import { FOLDERS } from '../core/constants.js';
+import { frontendFeatureFlagsSchema } from './schema.js';
+const DEFAULT_FEATURE_FLAGS = {
+    htmlSecurity: true,
+    imageOptimization: true,
+    precompression: true
+};
+export function buildConfig(workspaceRoot) {
+    const srcRoot = path.join(workspaceRoot, FOLDERS.src);
+    const frontendRoot = path.join(srcRoot, FOLDERS.frontend);
+    const buildRoot = path.join(workspaceRoot, FOLDERS.build);
+    const distRoot = path.join(workspaceRoot, FOLDERS.dist);
+    const buildFrontend = path.join(buildRoot, FOLDERS.frontend);
+    const distFrontend = path.join(distRoot, FOLDERS.frontend);
+    const srcContentRoot = resolveContentRoot(workspaceRoot, frontendRoot);
+    return {
+        version: 1,
+        paths: {
+            workspace: workspaceRoot,
+            src: {
+                root: srcRoot,
+                frontend: frontendRoot,
+                app: path.join(frontendRoot, FOLDERS.app),
+                pages: path.join(frontendRoot, FOLDERS.pages),
+                content: srcContentRoot,
+                images: path.join(frontendRoot, FOLDERS.images),
+                fonts: path.join(frontendRoot, FOLDERS.fonts),
+                media: path.join(frontendRoot, FOLDERS.media)
+            },
+            build: {
+                root: buildRoot,
+                frontend: buildFrontend,
+                app: path.join(buildFrontend, FOLDERS.app),
+                pages: path.join(buildFrontend, FOLDERS.pages),
+                content: path.join(buildFrontend, FOLDERS.pages, 'docs'),
+                images: path.join(buildFrontend, FOLDERS.images),
+                fonts: path.join(buildFrontend, FOLDERS.fonts),
+                media: path.join(buildFrontend, FOLDERS.media)
+            },
+            dist: {
+                root: distRoot,
+                frontend: distFrontend,
+                app: path.join(distFrontend, FOLDERS.app),
+                pages: path.join(distFrontend, FOLDERS.pages),
+                content: path.join(distFrontend, FOLDERS.pages, 'docs'),
+                images: path.join(distFrontend, FOLDERS.images),
+                fonts: path.join(distFrontend, FOLDERS.fonts),
+                media: path.join(distFrontend, FOLDERS.media)
+            }
+        },
+        features: loadFeatureFlags(frontendRoot)
+    };
+}
+function resolveContentRoot(workspaceRoot, frontendRoot) {
+    const defaultContentRoot = path.join(frontendRoot, 'content');
+    const configPath = path.join(frontendRoot, 'frontend.config.json');
+    if (!fs.existsSync(configPath)) {
+        return defaultContentRoot;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const override = extractContentRoot(parsed);
+        if (override === undefined) {
+            return defaultContentRoot;
+        }
+        if (typeof override !== 'string') {
+            throw new Error('Expected contentRoot to be a string when specified.');
+        }
+        const trimmed = override.trim();
+        if (!trimmed) {
+            return defaultContentRoot;
+        }
+        if (path.isAbsolute(trimmed)) {
+            return trimmed;
+        }
+        return path.join(workspaceRoot, trimmed);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read frontend content root from ${configPath}: ${message}`);
+    }
+}
+function extractContentRoot(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const container = value;
+    if ('paths' in container && container.paths && typeof container.paths === 'object') {
+        const pathsContainer = container.paths;
+        if ('contentRoot' in pathsContainer) {
+            return pathsContainer.contentRoot;
+        }
+    }
+    if ('contentRoot' in container) {
+        return container.contentRoot;
+    }
+    return undefined;
+}
+function loadFeatureFlags(frontendRoot) {
+    const configPath = path.join(frontendRoot, 'frontend.config.json');
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_FEATURE_FLAGS;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const overridesSource = extractOverrideSource(parsed);
+        const overrides = frontendFeatureFlagsSchema.parse(overridesSource);
+        return {
+            htmlSecurity: overrides.htmlSecurity,
+            imageOptimization: overrides.imageOptimization,
+            precompression: overrides.precompression
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read frontend feature flags from ${configPath}: ${message}`);
+    }
+}
+function extractOverrideSource(value) {
+    if (value && typeof value === 'object' && 'features' in value) {
+        const container = value.features;
+        if (container && typeof container === 'object') {
+            return container;
+        }
+    }
+    return (value && typeof value === 'object') ? value : {};
+}

package/dist/config/workspaceManifest.d.ts

@@ -0,0 +1,23 @@
+export type RenderMode = 'ssg' | 'ssr' | 'spa';
+export interface WorkspaceModuleView {
+    readonly name?: string;
+    readonly path?: string;
+    readonly renderMode?: RenderMode;
+    readonly staticPaths?: readonly string[];
+}
+export interface WorkspaceModuleRouteGuard {
+    readonly renderMode?: unknown;
+    readonly staticPaths?: unknown;
+    readonly ssg?: unknown;
+}
+export interface WorkspaceModuleConfig {
+    readonly views?: readonly WorkspaceModuleView[];
+    readonly routes?: readonly WorkspaceModuleRouteGuard[];
+}
+export interface WorkspacePackageJson {
+    readonly name?: string;
+    readonly webstir?: {
+        readonly mode?: string;
+        readonly moduleManifest?: WorkspaceModuleConfig;
+    };
+}

package/dist/config/workspaceManifest.js

@@ -0,0 +1 @@
+export {};

package/dist/core/constants.d.ts

@@ -0,0 +1,70 @@
+export declare const FOLDERS: {
+    readonly src: "src";
+    readonly build: "build";
+    readonly dist: "dist";
+    readonly webstir: ".webstir";
+    readonly tests: "tests";
+    readonly frontend: "frontend";
+    readonly backend: "backend";
+    readonly shared: "shared";
+    readonly types: "types";
+    readonly app: "app";
+    readonly pages: "pages";
+    readonly styles: "styles";
+    readonly scripts: "scripts";
+    readonly images: "images";
+    readonly fonts: "fonts";
+    readonly media: "media";
+    readonly chunks: "chunks";
+    readonly home: "home";
+    readonly nodeModules: "node_modules";
+    readonly seed: "seed";
+    readonly demo: "demo";
+    readonly temp: "temp";
+};
+export declare const FILES: {
+    readonly packageJson: "package.json";
+    readonly packageLockJson: "package-lock.json";
+    readonly tsBuildInfo: ".tsbuildinfo";
+    readonly baseTsConfigJson: "base.tsconfig.json";
+    readonly manifestJson: "manifest.json";
+    readonly test: ".test";
+    readonly index: "index";
+    readonly indexHtml: "index.html";
+    readonly refreshJs: "refresh.js";
+    readonly hmrJs: "hmr.js";
+    readonly robotsTxt: "robots.txt";
+};
+export declare const EXTENSIONS: {
+    readonly html: ".html";
+    readonly css: ".css";
+    readonly br: ".br";
+    readonly gz: ".gz";
+    readonly dts: ".d.ts";
+    readonly ts: ".ts";
+    readonly js: ".js";
+    readonly map: ".map";
+    readonly png: ".png";
+    readonly jpg: ".jpg";
+    readonly jpeg: ".jpeg";
+    readonly gif: ".gif";
+    readonly svg: ".svg";
+    readonly webp: ".webp";
+    readonly avif: ".avif";
+    readonly ico: ".ico";
+    readonly woff: ".woff";
+    readonly woff2: ".woff2";
+    readonly ttf: ".ttf";
+    readonly otf: ".otf";
+    readonly eot: ".eot";
+    readonly mp3: ".mp3";
+    readonly m4a: ".m4a";
+    readonly wav: ".wav";
+    readonly ogg: ".ogg";
+    readonly mp4: ".mp4";
+    readonly webm: ".webm";
+    readonly mov: ".mov";
+};
+export declare const FILE_NAMES: {
+    readonly htmlAppTemplate: "app.html";
+};