@vistagenic/vista 0.1.0-alpha.1

package/dist/metadata/types.d.ts

@@ -0,0 +1,325 @@
+/**
+ * Vista Metadata Types
+ *
+ * Complete TypeScript types for Next.js-compatible metadata API.
+ * Supports static `metadata` exports and dynamic `generateMetadata` function.
+ */
+/**
+ * Template string for title with inheritance support
+ */
+export type TemplateString = {
+    default: string;
+    template?: string;
+    absolute?: string;
+};
+/**
+ * Author metadata
+ */
+export interface Author {
+    name?: string;
+    url?: string | URL;
+}
+/**
+ * Robots directive
+ */
+export interface Robots {
+    index?: boolean;
+    follow?: boolean;
+    noarchive?: boolean;
+    nosnippet?: boolean;
+    noimageindex?: boolean;
+    nocache?: boolean;
+    notranslate?: boolean;
+    'max-snippet'?: number;
+    'max-image-preview'?: 'none' | 'standard' | 'large';
+    'max-video-preview'?: number;
+    googleBot?: string | Robots;
+}
+export type IconURL = string | URL;
+export interface IconDescriptor {
+    url: string | URL;
+    type?: string;
+    sizes?: string;
+    color?: string;
+    rel?: string;
+    media?: string;
+    fetchPriority?: 'high' | 'low' | 'auto';
+}
+export type Icon = IconURL | IconDescriptor;
+export interface Icons {
+    icon?: Icon | Icon[];
+    shortcut?: Icon | Icon[];
+    apple?: Icon | Icon[];
+    other?: IconDescriptor | IconDescriptor[];
+}
+export interface OpenGraphImage {
+    url: string | URL;
+    secureUrl?: string | URL;
+    alt?: string;
+    type?: string;
+    width?: string | number;
+    height?: string | number;
+}
+export interface OpenGraphVideo {
+    url: string | URL;
+    secureUrl?: string | URL;
+    type?: string;
+    width?: string | number;
+    height?: string | number;
+}
+export interface OpenGraphAudio {
+    url: string | URL;
+    secureUrl?: string | URL;
+    type?: string;
+}
+export interface OpenGraphArticle {
+    publishedTime?: string;
+    modifiedTime?: string;
+    expirationTime?: string;
+    authors?: null | string | URL | Array<string | URL>;
+    section?: null | string;
+    tags?: null | string | Array<string>;
+}
+export interface OpenGraphProfile {
+    firstName?: string;
+    lastName?: string;
+    username?: string;
+    gender?: string;
+}
+export interface OpenGraphBook {
+    isbn?: string;
+    releaseDate?: string;
+    authors?: string | URL | Array<string | URL>;
+    tags?: string | Array<string>;
+}
+export interface OpenGraphBase {
+    title?: string;
+    description?: string;
+    url?: string | URL;
+    siteName?: string;
+    locale?: string;
+    images?: string | URL | OpenGraphImage | Array<string | URL | OpenGraphImage>;
+    videos?: string | URL | OpenGraphVideo | Array<string | URL | OpenGraphVideo>;
+    audio?: string | URL | OpenGraphAudio | Array<string | URL | OpenGraphAudio>;
+    countryName?: string;
+    ttl?: number;
+    determiner?: 'a' | 'an' | 'the' | 'auto' | '';
+    emails?: string | Array<string>;
+    phoneNumbers?: string | Array<string>;
+    faxNumbers?: string | Array<string>;
+}
+export interface OpenGraphWebsite extends OpenGraphBase {
+    type?: 'website';
+}
+export interface OpenGraphArticleType extends OpenGraphBase {
+    type: 'article';
+    article?: OpenGraphArticle;
+}
+export interface OpenGraphProfileType extends OpenGraphBase {
+    type: 'profile';
+    profile?: OpenGraphProfile;
+}
+export interface OpenGraphBookType extends OpenGraphBase {
+    type: 'book';
+    book?: OpenGraphBook;
+}
+export type OpenGraph = OpenGraphWebsite | OpenGraphArticleType | OpenGraphProfileType | OpenGraphBookType;
+export interface TwitterPlayerDescriptor {
+    playerUrl: string | URL;
+    streamUrl: string | URL;
+    width: number;
+    height: number;
+}
+export interface TwitterAppDescriptor {
+    id: {
+        iphone?: string | number;
+        ipad?: string | number;
+        googleplay?: string;
+    };
+    url?: {
+        iphone?: string | URL;
+        ipad?: string | URL;
+        googleplay?: string | URL;
+    };
+    name?: string;
+}
+export interface TwitterSummary {
+    card: 'summary' | 'summary_large_image';
+    site?: string;
+    siteId?: string;
+    creator?: string;
+    creatorId?: string;
+    title?: string;
+    description?: string;
+    images?: string | Array<string>;
+}
+export interface TwitterPlayer {
+    card: 'player';
+    site?: string;
+    siteId?: string;
+    creator?: string;
+    creatorId?: string;
+    title?: string;
+    description?: string;
+    images?: string | Array<string>;
+    players: TwitterPlayerDescriptor | Array<TwitterPlayerDescriptor>;
+}
+export interface TwitterApp {
+    card: 'app';
+    site?: string;
+    siteId?: string;
+    creator?: string;
+    creatorId?: string;
+    title?: string;
+    description?: string;
+    images?: string | Array<string>;
+    app: TwitterAppDescriptor;
+}
+export type Twitter = TwitterSummary | TwitterPlayer | TwitterApp;
+export interface Verification {
+    google?: string | Array<string>;
+    yahoo?: string | Array<string>;
+    yandex?: string | Array<string>;
+    me?: string | Array<string>;
+    bing?: string | Array<string>;
+    other?: Record<string, string | Array<string>>;
+}
+export interface AlternateURLs {
+    canonical?: string | URL;
+    languages?: Record<string, string | URL | Array<string | URL>>;
+    media?: Record<string, string | URL | Array<string | URL>>;
+    types?: Record<string, string | URL | Array<string | URL>>;
+}
+export interface AppleWebApp {
+    capable?: boolean;
+    title?: string;
+    startupImage?: string | AppleStartupImage | Array<AppleStartupImage>;
+    statusBarStyle?: 'default' | 'black' | 'black-translucent';
+}
+export interface AppleStartupImage {
+    url: string;
+    media?: string;
+}
+export interface FormatDetection {
+    telephone?: boolean;
+    date?: boolean;
+    address?: boolean;
+    email?: boolean;
+    url?: boolean;
+}
+/**
+ * Metadata object for Vista pages and layouts.
+ * Compatible with Next.js App Router metadata API.
+ */
+export interface Metadata {
+    /**
+     * The base URL for resolving relative URLs in metadata.
+     */
+    metadataBase?: null | string | URL;
+    /**
+     * The document title.
+     * Can be a string or a template object with default/template/absolute.
+     */
+    title?: null | string | TemplateString;
+    /**
+     * The document description.
+     */
+    description?: null | string;
+    /**
+     * Application name.
+     */
+    applicationName?: null | string;
+    /**
+     * Document authors.
+     */
+    authors?: null | Author | Array<Author>;
+    /**
+     * Generator (framework name).
+     */
+    generator?: null | string;
+    /**
+     * Keywords for the document.
+     */
+    keywords?: null | string | Array<string>;
+    /**
+     * Referrer policy.
+     */
+    referrer?: null | 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+    /**
+     * Creator of the document.
+     */
+    creator?: null | string;
+    /**
+     * Publisher of the document.
+     */
+    publisher?: null | string;
+    /**
+     * Robots directives.
+     */
+    robots?: null | string | Robots;
+    /**
+     * Alternate URLs (canonical, language variants).
+     */
+    alternates?: null | AlternateURLs;
+    /**
+     * Icons (favicon, apple-touch-icon, etc.).
+     */
+    icons?: null | IconURL | Array<Icon> | Icons;
+    /**
+     * Web app manifest URL.
+     */
+    manifest?: null | string | URL;
+    /**
+     * Open Graph metadata.
+     */
+    openGraph?: null | OpenGraph;
+    /**
+     * Twitter Card metadata.
+     */
+    twitter?: null | Twitter;
+    /**
+     * Verification tokens for search engines.
+     */
+    verification?: null | Verification;
+    /**
+     * Apple web app configuration.
+     */
+    appleWebApp?: null | boolean | AppleWebApp;
+    /**
+     * Format detection hints.
+     */
+    formatDetection?: null | FormatDetection;
+    /**
+     * Abstract (brief description, deprecated).
+     */
+    abstract?: null | string;
+    /**
+     * Category of the page.
+     */
+    category?: null | string;
+    /**
+     * Classification of the page.
+     */
+    classification?: null | string;
+    /**
+     * Other custom metadata.
+     */
+    other?: Record<string, string | number | Array<string | number>>;
+}
+/**
+ * Props passed to generateMetadata function.
+ */
+export interface MetadataProps<Params = Record<string, string>> {
+    params: Params;
+    searchParams?: Record<string, string | string[]>;
+}
+/**
+ * Parent metadata from parent layout.
+ */
+export interface ResolvingMetadata extends Metadata {
+}
+/**
+ * Type for generateMetadata function.
+ */
+export type GenerateMetadata<Params = Record<string, string>> = (props: MetadataProps<Params>, parent: ResolvingMetadata) => Metadata | Promise<Metadata>;
+export declare function isTemplateString(title: unknown): title is TemplateString;

package/dist/metadata/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Vista Metadata Types
+ *
+ * Complete TypeScript types for Next.js-compatible metadata API.
+ * Supports static `metadata` exports and dynamic `generateMetadata` function.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTemplateString = isTemplateString;
+// ============================================================================
+// Export type guard
+// ============================================================================
+function isTemplateString(title) {
+    return typeof title === 'object' && title !== null && 'default' in title;
+}

package/dist/router/context.d.ts

@@ -0,0 +1,8 @@
+export type RouterContextType = {
+    pathname: string;
+    push: (path: string) => void;
+    replace: (path: string) => void;
+};
+export declare const RouterContext: import("react").Context<RouterContextType>;
+export declare const useRouter: () => RouterContextType;
+export declare const useRouterContext: () => RouterContextType;

package/dist/router/context.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRouterContext = exports.useRouter = exports.RouterContext = void 0;
+const react_1 = require("react");
+exports.RouterContext = (0, react_1.createContext)({
+    pathname: '/',
+    push: () => { },
+    replace: () => { },
+});
+const useRouter = () => (0, react_1.useContext)(exports.RouterContext);
+exports.useRouter = useRouter;
+const useRouterContext = () => (0, react_1.useContext)(exports.RouterContext);
+exports.useRouterContext = useRouterContext;

package/dist/router/index.d.ts

@@ -0,0 +1,2 @@
+export * from './context';
+export * from './provider';

package/dist/router/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context"), exports);
+__exportStar(require("./provider"), exports);

package/dist/router/provider.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function RouterProvider({ children, initialPath }: {
+    children: React.ReactNode;
+    initialPath?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/router/provider.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterProvider = RouterProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const context_1 = require("./context");
+function RouterProvider({ children, initialPath }) {
+    const [pathname, setPathname] = (0, react_1.useState)(initialPath || (typeof window !== 'undefined' ? window.location.pathname : '/'));
+    (0, react_1.useEffect)(() => {
+        if (typeof window === 'undefined')
+            return;
+        const onPopState = () => {
+            setPathname(window.location.pathname);
+        };
+        window.addEventListener('popstate', onPopState);
+        return () => window.removeEventListener('popstate', onPopState);
+    }, []);
+    const push = (path) => {
+        if (typeof window !== 'undefined') {
+            window.history.pushState({}, '', path);
+            setPathname(path);
+        }
+    };
+    const replace = (path) => {
+        if (typeof window !== 'undefined') {
+            window.history.replaceState({}, '', path);
+            setPathname(path);
+        }
+    };
+    return ((0, jsx_runtime_1.jsx)(context_1.RouterContext.Provider, { value: { pathname, push, replace }, children: children }));
+}

package/dist/server/client-boundary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Vista Client Boundary Component
+ *
+ * Wraps client components during SSR to add hydration markers.
+ * These markers allow the client bundle to find and hydrate only client components.
+ */
+import * as React from 'react';
+/**
+ * Check if a file is a client component by checking for 'client load' directive
+ */
+declare function isClientComponent(filePath: string): boolean;
+/**
+ * Reset mount counter at the start of each request
+ */
+export declare function resetMountCounter(): void;
+interface ClientBoundaryProps {
+    componentId: string;
+    componentPath?: string;
+    children: React.ReactNode;
+    props?: Record<string, any>;
+}
+/**
+ * ClientBoundary - Wraps client components with hydration markers
+ *
+ * During SSR, this component renders:
+ * <div data-vista-client="counter" data-props="{}">
+ *   {children from SSR}
+ * </div>
+ *
+ * The client then hydrates only these marked islands.
+ */
+export declare function ClientBoundary({ componentId, children, props }: ClientBoundaryProps): React.ReactElement;
+/**
+ * Higher-order function to wrap a client component
+ */
+export declare function wrapClientComponent<P extends object>(Component: React.ComponentType<P>, componentId: string): React.FC<P>;
+/**
+ * Check if we're on the server
+ */
+export declare function isServer(): boolean;
+declare const _default: {
+    ClientBoundary: typeof ClientBoundary;
+    wrapClientComponent: typeof wrapClientComponent;
+    resetMountCounter: typeof resetMountCounter;
+    isClientComponent: typeof isClientComponent;
+    isServer: typeof isServer;
+};
+export default _default;

package/dist/server/client-boundary.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Vista Client Boundary Component
+ *
+ * Wraps client components during SSR to add hydration markers.
+ * These markers allow the client bundle to find and hydrate only client components.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetMountCounter = resetMountCounter;
+exports.ClientBoundary = ClientBoundary;
+exports.wrapClientComponent = wrapClientComponent;
+exports.isServer = isServer;
+const React = __importStar(require("react"));
+const fs = __importStar(require("fs"));
+// Cache for component detection
+const clientComponentCache = new Map();
+/**
+ * Check if a file is a client component by checking for 'client load' directive
+ */
+function isClientComponent(filePath) {
+    if (clientComponentCache.has(filePath)) {
+        return clientComponentCache.get(filePath);
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const isClient = content.trimStart().startsWith("'client load'") ||
+            content.trimStart().startsWith('"client load"');
+        clientComponentCache.set(filePath, isClient);
+        return isClient;
+    }
+    catch {
+        return false;
+    }
+}
+// Counter for unique mount IDs
+let mountCounter = 0;
+/**
+ * Reset mount counter at the start of each request
+ */
+function resetMountCounter() {
+    mountCounter = 0;
+}
+/**
+ * Generate unique mount ID
+ */
+function generateMountId() {
+    return `vista-client-${++mountCounter}`;
+}
+/**
+ * ClientBoundary - Wraps client components with hydration markers
+ *
+ * During SSR, this component renders:
+ * <div data-vista-client="counter" data-props="{}">
+ *   {children from SSR}
+ * </div>
+ *
+ * The client then hydrates only these marked islands.
+ */
+function ClientBoundary({ componentId, children, props = {} }) {
+    const mountId = generateMountId();
+    // Serialize props (exclude functions and React elements)
+    const safeProps = {};
+    for (const [key, value] of Object.entries(props)) {
+        if (typeof value !== 'function' && !React.isValidElement(value)) {
+            safeProps[key] = value;
+        }
+    }
+    return React.createElement('div', {
+        id: mountId,
+        'data-vista-client': componentId,
+        'data-props': JSON.stringify(safeProps),
+        style: { display: 'contents' } // Don't affect layout
+    }, children);
+}
+/**
+ * Higher-order function to wrap a client component
+ */
+function wrapClientComponent(Component, componentId) {
+    return function WrappedClientComponent(props) {
+        const children = React.createElement(Component, props);
+        return React.createElement(ClientBoundary, {
+            componentId,
+            props: props,
+            children,
+        });
+    };
+}
+/**
+ * Check if we're on the server
+ */
+function isServer() {
+    return typeof window === 'undefined';
+}
+exports.default = {
+    ClientBoundary,
+    wrapClientComponent,
+    resetMountCounter,
+    isClientComponent,
+    isServer,
+};

package/dist/server/engine.d.ts

@@ -0,0 +1,4 @@
+import webpack from 'webpack';
+export declare function enableClientComponentWrapping(appDir: string): void;
+export declare function disableClientComponentWrapping(): void;
+export declare function startServer(port?: number, compiler?: webpack.Compiler): void;