ts-prorm-orm 1.2.3 → 2.1.0

package/dist/diagrams/palette.d.ts

@@ -1,138 +0,0 @@
-/**
- * Shared accent-color and theme resolution for the diagram generators.
- *
- * `--color <name>` (or a custom hex string) picks an accent palette used for
- * header bars / banners / entity colors.
- * `--theme light|dark` picks a background/text theme.
- *
- * Both are genuinely applied by ModelDiagram, ERDiagram, RelationalDiagram,
- * SchemaDocDiagram, ChenDiagram (and MigrationDiagram) — changing either flag
- * changes real fill/stroke values in the generated SVG.
- *
- * ─── Industry design system ────────────────────────────────────────────────
- * The DEFAULT look is the "Industry" blueprint design: a #f2f2f3 ground, white
- * cards, hairline dividers, square corners, a solid #5980a6 accent header bar,
- * and Barlow / Barlow Condensed / JetBrains Mono typography. The old vibrant
- * multi-stop gradient palettes are retained as explicit `--color` overrides,
- * but `industry` is now `ACCENT_PALETTES[0]` (the fallback of `resolveAccent`).
- *
- * The exported API is intentionally stable — `AccentPalette` / `ThemeColors`
- * keep their existing fields (new fields are additive & optional), and
- * `resolveAccent` / `resolveTheme` / `rotatedPalettes` keep their signatures —
- * so sibling generators and other callers that import them keep working.
- */
-export interface AccentPalette {
-    name: string;
-    /** Darkest gradient stop / primary header color (also used as a solid fill) */
-    from: string;
-    /** Mid gradient stop — the canonical solid accent fill in the Industry look */
-    mid: string;
-    /** Lightest gradient stop (used for 3-stop gradients / light accents) */
-    to: string;
-    /** Light background tint (badges, footers) */
-    light: string;
-    /** Readable text color on `light` background */
-    text: string;
-    /** Secondary accent (blueprint two-tone; FK marks, alt entities) */
-    accent2?: string;
-    /** Light tint of the secondary accent */
-    accent2Light?: string;
-    /** Readable text on `accent2Light` */
-    accent2Text?: string;
-}
-export declare const INDUSTRY: {
-    readonly ground: "#f2f2f3";
-    readonly surface: "#e9e9ea";
-    readonly card: "#ffffff";
-    readonly text: "#1d1f20";
-    readonly muted: "#7a7a7d";
-    readonly accent: "#5980a6";
-    readonly accent2: "#728fab";
-    readonly accentLight: "#eef6ff";
-    readonly accentText: "#2c455d";
-    readonly accent2Light: "#d6ebff";
-    readonly accent2Text: "#314457";
-    /** Hairline divider — rgba(29,31,32,0.16) */
-    readonly divider: "rgba(29,31,32,0.16)";
-    readonly neutral: {
-        readonly 100: "#f5f5f8";
-        readonly 200: "#e7e7ea";
-        readonly 300: "#d4d4d7";
-        readonly 400: "#b7b7ba";
-        readonly 500: "#98989b";
-        readonly 600: "#7a7a7d";
-        readonly 700: "#5d5d60";
-        readonly 800: "#424244";
-        readonly 900: "#2b2b2d";
-    };
-};
-export declare const FONTS: {
-    /** headings & labels */
-    readonly heading: "\"Barlow Condensed\", system-ui, sans-serif";
-    /** body copy */
-    readonly body: "\"Barlow\", system-ui, sans-serif";
-    /** code / types / mono */
-    readonly mono: "ui-monospace, \"JetBrains Mono\", \"SF Mono\", Menlo, monospace";
-};
-/**
- * A Google-Fonts @import so browser-rendered SVGs pick up Barlow / Barlow
- * Condensed / JetBrains Mono. Non-browser renderers fall back to the system
- * fonts declared alongside each family in `FONTS`.
- */
-export declare const FONT_IMPORT = "@import url('https://fonts.googleapis.com/css2?family=Barlow:wght@400;500;600;700&family=Barlow+Condensed:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');";
-/** Constraint / cardinality badge tints in the Industry system. */
-export declare const BADGE_TINTS: {
-    /** PK / UQ — accent tint */
-    readonly accent: {
-        readonly bg: "#eef6ff";
-        readonly fg: "#2c455d";
-    };
-    /** FK — accent-2 tint */
-    readonly accent2: {
-        readonly bg: "#d6ebff";
-        readonly fg: "#314457";
-    };
-    /** NN / AI / TS — neutral tint */
-    readonly neutral: {
-        readonly bg: "#f5f5f8";
-        readonly fg: "#424244";
-    };
-};
-export declare const ACCENT_PALETTES: AccentPalette[];
-/**
- * Resolve a `--color` flag value to a concrete palette.
- * Accepts a named palette (case-insensitive) or a hex color string.
- * Falls back to the default Industry palette.
- */
-export declare function resolveAccent(color?: string): AccentPalette;
-/** The secondary accent for a resolved palette, with an Industry fallback. */
-export declare function accent2Of(p: AccentPalette): {
-    color: string;
-    light: string;
-    text: string;
-};
-/**
- * Rotate the palette list so it starts at the resolved accent (used by
- * ERDiagram / RelationalDiagram to color multiple entities while still honoring
- * --color for the first/primary entity).
- */
-export declare function rotatedPalettes(color?: string): AccentPalette[];
-export interface ThemeColors {
-    /** Outer page/canvas background */
-    canvasBg: string;
-    /** Card / entity-box background */
-    cardBg: string;
-    /** Alternating row background (even rows use cardBg) */
-    rowAlt: string;
-    /** Column-header strip background */
-    colHeaderBg: string;
-    /** Primary body text color */
-    textPrimary: string;
-    /** Secondary/muted text color */
-    textSecondary: string;
-    /** Hairline border/divider color */
-    border: string;
-    /** Footer bar background */
-    footerBg: string;
-}
-export declare function resolveTheme(theme?: 'light' | 'dark'): ThemeColors;

package/dist/diagrams/palette.js

@@ -1,194 +0,0 @@
-"use strict";
-/**
- * Shared accent-color and theme resolution for the diagram generators.
- *
- * `--color <name>` (or a custom hex string) picks an accent palette used for
- * header bars / banners / entity colors.
- * `--theme light|dark` picks a background/text theme.
- *
- * Both are genuinely applied by ModelDiagram, ERDiagram, RelationalDiagram,
- * SchemaDocDiagram, ChenDiagram (and MigrationDiagram) — changing either flag
- * changes real fill/stroke values in the generated SVG.
- *
- * ─── Industry design system ────────────────────────────────────────────────
- * The DEFAULT look is the "Industry" blueprint design: a #f2f2f3 ground, white
- * cards, hairline dividers, square corners, a solid #5980a6 accent header bar,
- * and Barlow / Barlow Condensed / JetBrains Mono typography. The old vibrant
- * multi-stop gradient palettes are retained as explicit `--color` overrides,
- * but `industry` is now `ACCENT_PALETTES[0]` (the fallback of `resolveAccent`).
- *
- * The exported API is intentionally stable — `AccentPalette` / `ThemeColors`
- * keep their existing fields (new fields are additive & optional), and
- * `resolveAccent` / `resolveTheme` / `rotatedPalettes` keep their signatures —
- * so sibling generators and other callers that import them keep working.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACCENT_PALETTES = exports.BADGE_TINTS = exports.FONT_IMPORT = exports.FONTS = exports.INDUSTRY = void 0;
-exports.resolveAccent = resolveAccent;
-exports.accent2Of = accent2Of;
-exports.rotatedPalettes = rotatedPalettes;
-exports.resolveTheme = resolveTheme;
-// ─── Industry design tokens (shared by every generator) ─────────────────────
-exports.INDUSTRY = {
-    ground: '#f2f2f3',
-    surface: '#e9e9ea',
-    card: '#ffffff',
-    text: '#1d1f20',
-    muted: '#7a7a7d',
-    accent: '#5980a6',
-    accent2: '#728fab',
-    accentLight: '#eef6ff',
-    accentText: '#2c455d',
-    accent2Light: '#d6ebff',
-    accent2Text: '#314457',
-    /** Hairline divider — rgba(29,31,32,0.16) */
-    divider: 'rgba(29,31,32,0.16)',
-    neutral: {
-        100: '#f5f5f8',
-        200: '#e7e7ea',
-        300: '#d4d4d7',
-        400: '#b7b7ba',
-        500: '#98989b',
-        600: '#7a7a7d',
-        700: '#5d5d60',
-        800: '#424244',
-        900: '#2b2b2d',
-    },
-};
-// ─── Typography (Barlow / Barlow Condensed / JetBrains Mono) ─────────────────
-exports.FONTS = {
-    /** headings & labels */
-    heading: '"Barlow Condensed", system-ui, sans-serif',
-    /** body copy */
-    body: '"Barlow", system-ui, sans-serif',
-    /** code / types / mono */
-    mono: 'ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace',
-};
-/**
- * A Google-Fonts @import so browser-rendered SVGs pick up Barlow / Barlow
- * Condensed / JetBrains Mono. Non-browser renderers fall back to the system
- * fonts declared alongside each family in `FONTS`.
- */
-exports.FONT_IMPORT = "@import url('https://fonts.googleapis.com/css2?family=Barlow:wght@400;500;600;700&family=Barlow+Condensed:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');";
-/** Constraint / cardinality badge tints in the Industry system. */
-exports.BADGE_TINTS = {
-    /** PK / UQ — accent tint */
-    accent: { bg: exports.INDUSTRY.accentLight, fg: exports.INDUSTRY.accentText },
-    /** FK — accent-2 tint */
-    accent2: { bg: exports.INDUSTRY.accent2Light, fg: exports.INDUSTRY.accent2Text },
-    /** NN / AI / TS — neutral tint */
-    neutral: { bg: exports.INDUSTRY.neutral[100], fg: exports.INDUSTRY.neutral[800] },
-};
-// Named palette entries. Order matters: it is also the default cycling order
-// used by ERDiagram / RelationalDiagram when no explicit --color is given, so
-// the two Industry entries lead — a schema with no `--color` renders as a
-// blueprint two-tone (accent → accent-2) rather than a rainbow.
-exports.ACCENT_PALETTES = [
-    {
-        name: 'industry',
-        from: exports.INDUSTRY.accent,
-        mid: exports.INDUSTRY.accent,
-        to: exports.INDUSTRY.accent,
-        light: exports.INDUSTRY.accentLight,
-        text: exports.INDUSTRY.accentText,
-        accent2: exports.INDUSTRY.accent2,
-        accent2Light: exports.INDUSTRY.accent2Light,
-        accent2Text: exports.INDUSTRY.accent2Text,
-    },
-    {
-        name: 'industry-2',
-        from: exports.INDUSTRY.accent2,
-        mid: exports.INDUSTRY.accent2,
-        to: exports.INDUSTRY.accent2,
-        light: exports.INDUSTRY.accent2Light,
-        text: exports.INDUSTRY.accent2Text,
-        accent2: exports.INDUSTRY.accent,
-        accent2Light: exports.INDUSTRY.accentLight,
-        accent2Text: exports.INDUSTRY.accentText,
-    },
-    { name: 'blue', from: '#1E3A8A', mid: '#2563EB', to: '#60A5FA', light: '#DBEAFE', text: '#1E3A8A' },
-    { name: 'violet', from: '#5B21B6', mid: '#7C3AED', to: '#A78BFA', light: '#EDE9FE', text: '#5B21B6' },
-    { name: 'emerald', from: '#065F46', mid: '#059669', to: '#34D399', light: '#D1FAE5', text: '#065F46' },
-    { name: 'amber', from: '#92400E', mid: '#D97706', to: '#FBBF24', light: '#FEF3C7', text: '#92400E' },
-    { name: 'pink', from: '#831843', mid: '#DB2777', to: '#F472B6', light: '#FCE7F3', text: '#831843' },
-    { name: 'sky', from: '#0C4A6E', mid: '#0284C7', to: '#38BDF8', light: '#E0F2FE', text: '#0C4A6E' },
-    { name: 'indigo', from: '#1E1B4B', mid: '#4338CA', to: '#818CF8', light: '#E0E7FF', text: '#1E1B4B' },
-    { name: 'purple', from: '#4A1942', mid: '#9333EA', to: '#C084FC', light: '#F3E8FF', text: '#4A1942' },
-    { name: 'red', from: '#7F1D1D', mid: '#DC2626', to: '#F87171', light: '#FEE2E2', text: '#7F1D1D' },
-    { name: 'teal', from: '#134E4A', mid: '#0D9488', to: '#2DD4BF', light: '#CCFBF1', text: '#134E4A' },
-    { name: 'green', from: '#14532D', mid: '#16A34A', to: '#4ADE80', light: '#DCFCE7', text: '#14532D' },
-    { name: 'stone', from: '#1C1917', mid: '#44403C', to: '#A8A29E', light: '#F5F5F4', text: '#1C1917' },
-];
-const HEX_RE = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
-/**
- * Resolve a `--color` flag value to a concrete palette.
- * Accepts a named palette (case-insensitive) or a hex color string.
- * Falls back to the default Industry palette.
- */
-function resolveAccent(color) {
-    if (color) {
-        const named = exports.ACCENT_PALETTES.find((p) => p.name === color.toLowerCase());
-        if (named)
-            return named;
-        if (HEX_RE.test(color)) {
-            return {
-                name: color,
-                from: color,
-                mid: color,
-                to: color,
-                light: `${color}22`,
-                text: color,
-                accent2: exports.INDUSTRY.accent2,
-                accent2Light: exports.INDUSTRY.accent2Light,
-                accent2Text: exports.INDUSTRY.accent2Text,
-            };
-        }
-    }
-    return exports.ACCENT_PALETTES[0];
-}
-/** The secondary accent for a resolved palette, with an Industry fallback. */
-function accent2Of(p) {
-    return {
-        color: p.accent2 ?? exports.INDUSTRY.accent2,
-        light: p.accent2Light ?? exports.INDUSTRY.accent2Light,
-        text: p.accent2Text ?? exports.INDUSTRY.accent2Text,
-    };
-}
-/**
- * Rotate the palette list so it starts at the resolved accent (used by
- * ERDiagram / RelationalDiagram to color multiple entities while still honoring
- * --color for the first/primary entity).
- */
-function rotatedPalettes(color) {
-    if (!color)
-        return exports.ACCENT_PALETTES;
-    const idx = exports.ACCENT_PALETTES.findIndex((p) => p.name === color.toLowerCase());
-    if (idx <= 0)
-        return exports.ACCENT_PALETTES;
-    return [...exports.ACCENT_PALETTES.slice(idx), ...exports.ACCENT_PALETTES.slice(0, idx)];
-}
-// Industry light theme — the ground/surface/card/hairline blueprint.
-const LIGHT_THEME = {
-    canvasBg: exports.INDUSTRY.ground,
-    cardBg: exports.INDUSTRY.card,
-    rowAlt: exports.INDUSTRY.neutral[100],
-    colHeaderBg: exports.INDUSTRY.surface,
-    textPrimary: exports.INDUSTRY.text,
-    textSecondary: exports.INDUSTRY.muted,
-    border: exports.INDUSTRY.divider,
-    footerBg: exports.INDUSTRY.surface,
-};
-// Industry dark theme — same blueprint reasoning, inverted onto neutral-900.
-const DARK_THEME = {
-    canvasBg: '#1d1f20',
-    cardBg: '#2b2b2d',
-    rowAlt: '#242426',
-    colHeaderBg: '#242426',
-    textPrimary: '#f5f5f8',
-    textSecondary: '#b7b7ba',
-    border: 'rgba(245,245,248,0.18)',
-    footerBg: '#242426',
-};
-function resolveTheme(theme) {
-    return theme === 'dark' ? DARK_THEME : LIGHT_THEME;
-}

package/dist/hooks/hooks-manager.d.ts

@@ -1,189 +0,0 @@
-/**
- * Hooks Manager for the TypeScript ORM
- * Provides a centralized system for managing Prorm-style model hooks
- */
-import { HookOptions, HookHandler, BulkHookHandler } from '../types';
-export type HookName = 'beforeValidate' | 'afterValidate' | 'beforeCreate' | 'afterCreate' | 'beforeUpdate' | 'afterUpdate' | 'beforeDestroy' | 'afterDestroy' | 'beforeSave' | 'afterSave' | 'beforeBulkCreate' | 'afterBulkCreate' | 'beforeBulkUpdate' | 'afterBulkUpdate' | 'beforeBulkDestroy' | 'afterBulkDestroy' | 'beforeFind' | 'afterFind';
-export type HookCallback = HookHandler | BulkHookHandler | FindHookHandler;
-export interface FindHookHandler {
-    (options: FindHookOptions): Promise<void> | void;
-}
-export interface FindHookOptions extends HookOptions {
-    where?: Record<string, any>;
-    attributes?: string[];
-    include?: any[];
-    order?: any;
-    limit?: number | string;
-    offset?: number | string;
-    model?: any;
-}
-export type HooksMap = Map<HookName, Set<HookCallback>>;
-/**
- * HooksManager - Manages all lifecycle hooks for a model
- */
-export declare class HooksManager {
-    private hooks;
-    private modelName;
-    constructor(modelName?: string);
-    /**
-     * Initialize all hook types as empty Sets
-     */
-    private initializeHooks;
-    /**
-     * Get all hooks
-     */
-    getHooks(): HooksMap;
-    /**
-     * Get hooks for a specific hook name
-     */
-    getHook(hookName: HookName): Set<HookCallback>;
-    /**
-     * Add a hook callback
-     */
-    addHook(hookName: string, callback: HookCallback): this;
-    /**
-     * Remove a hook callback
-     */
-    removeHook(hookName: string, callback: HookCallback): this;
-    /**
-     * Run all callbacks for a specific hook
-     */
-    runHook(hookName: string, ...args: any[]): Promise<void>;
-    /**
-     * Check if a hook has registered callbacks
-     */
-    hasHook(hookName: string): boolean;
-    /**
-     * Get the count of hooks for a specific hook name
-     */
-    getHookCount(hookName: string): number;
-    /**
-     * Clear all hooks
-     */
-    clearHooks(): this;
-    /**
-     * Clear hooks for a specific hook name
-     */
-    clearHook(hookName: string): this;
-    /**
-     * Normalize hook name to camelCase
-     */
-    private normalizeHookName;
-}
-/**
- * Create a hooks object compatible with Model options
- */
-export declare function createHooksObject(hooksManager: HooksManager): Record<string, HookCallback>;
-/**
- * Mixin function to add hook methods to a Model class
- */
-export declare function addHookMethods<T extends HooksManager>(target: any, hooksManager: T): void;
-/**
- * Create a beforeValidate hook wrapper
- */
-export declare function beforeValidate(callback: HookHandler): {
-    beforeValidate: HookHandler;
-};
-/**
- * Create an afterValidate hook wrapper
- */
-export declare function afterValidate(callback: HookHandler): {
-    afterValidate: HookHandler;
-};
-/**
- * Create a beforeCreate hook wrapper
- */
-export declare function beforeCreate(callback: HookHandler): {
-    beforeCreate: HookHandler;
-};
-/**
- * Create an afterCreate hook wrapper
- */
-export declare function afterCreate(callback: HookHandler): {
-    afterCreate: HookHandler;
-};
-/**
- * Create a beforeUpdate hook wrapper
- */
-export declare function beforeUpdate(callback: HookHandler): {
-    beforeUpdate: HookHandler;
-};
-/**
- * Create an afterUpdate hook wrapper
- */
-export declare function afterUpdate(callback: HookHandler): {
-    afterUpdate: HookHandler;
-};
-/**
- * Create a beforeDestroy hook wrapper
- */
-export declare function beforeDestroy(callback: HookHandler): {
-    beforeDestroy: HookHandler;
-};
-/**
- * Create an afterDestroy hook wrapper
- */
-export declare function afterDestroy(callback: HookHandler): {
-    afterDestroy: HookHandler;
-};
-/**
- * Create a beforeSave hook wrapper
- */
-export declare function beforeSave(callback: HookHandler): {
-    beforeSave: HookHandler;
-};
-/**
- * Create an afterSave hook wrapper
- */
-export declare function afterSave(callback: HookHandler): {
-    afterSave: HookHandler;
-};
-/**
- * Create a beforeBulkCreate hook wrapper
- */
-export declare function beforeBulkCreate(callback: BulkHookHandler): {
-    beforeBulkCreate: BulkHookHandler;
-};
-/**
- * Create an afterBulkCreate hook wrapper
- */
-export declare function afterBulkCreate(callback: BulkHookHandler): {
-    afterBulkCreate: BulkHookHandler;
-};
-/**
- * Create a beforeBulkUpdate hook wrapper
- */
-export declare function beforeBulkUpdate(callback: BulkHookHandler): {
-    beforeBulkUpdate: BulkHookHandler;
-};
-/**
- * Create an afterBulkUpdate hook wrapper
- */
-export declare function afterBulkUpdate(callback: BulkHookHandler): {
-    afterBulkUpdate: BulkHookHandler;
-};
-/**
- * Create a beforeBulkDestroy hook wrapper
- */
-export declare function beforeBulkDestroy(callback: BulkHookHandler): {
-    beforeBulkDestroy: BulkHookHandler;
-};
-/**
- * Create an afterBulkDestroy hook wrapper
- */
-export declare function afterBulkDestroy(callback: BulkHookHandler): {
-    afterBulkDestroy: BulkHookHandler;
-};
-/**
- * Create a beforeFind hook wrapper
- */
-export declare function beforeFind(callback: FindHookHandler): {
-    beforeFind: FindHookHandler;
-};
-/**
- * Create an afterFind hook wrapper
- */
-export declare function afterFind(callback: FindHookHandler): {
-    afterFind: FindHookHandler;
-};
-export default HooksManager;