@orchestr-sh/orchestr 1.9.15 → 1.11.0

package/dist/View/Engines/TemplateEngine.d.cts

@@ -0,0 +1,91 @@
+import { ViewEngine } from "./ViewEngine.cjs";
+
+//#region src/View/Engines/TemplateEngine.d.ts
+/**
+ * Dependency injection shim so the engine can resolve included views
+ * without creating a circular import with ViewFactory.
+ */
+interface TemplateEngineResolver {
+  findView(name: string): string;
+}
+declare class TemplateEngine implements ViewEngine {
+  protected resolver: TemplateEngineResolver | null;
+  /**
+   * Set the resolver used for @include / @extends directives.
+   */
+  setResolver(resolver: TemplateEngineResolver): void;
+  /**
+   * Get the evaluated contents of the view.
+   */
+  get(path: string, data: Record<string, any>): Promise<string>;
+  /**
+   * Compile a template string with the given data.
+   *
+   * Processing order:
+   *   1. @extends / @section / @yield  (layout assembly)
+   *   2. @include                       (async file inclusion)
+   *   3. @if / @elseif / @else / @endif (synchronous)
+   *   4. @foreach / @endforeach         (synchronous)
+   *   5. {{ expr }}   HTML-escaped
+   *   6. {!! expr !!} raw
+   */
+  compile(source: string, data: Record<string, any>): Promise<string>;
+  /**
+   * Synchronous directive processing: @if, @foreach, {{ }}, {!! !!}.
+   * Called both at the top level and recursively from @foreach bodies.
+   */
+  private processSync;
+  /**
+   * Compile a child template that extends a layout.
+   */
+  private compileWithLayout;
+  /**
+   * Extract @section('name') ... @endsection blocks from a template string.
+   */
+  private extractSections;
+  /**
+   * Process @include('view', data?) directives.
+   * Each included view is fully compiled (recursively) before insertion.
+   */
+  private processIncludes;
+  /**
+   * Process @if(condition) ... @elseif(condition) ... @else ... @endif blocks.
+   *
+   * Uses a character-scanning approach to handle nested @if correctly.
+   * Recurses until no more @if directives remain.
+   */
+  private processIf;
+  /**
+   * Process @foreach(items as item) ... @endforeach blocks.
+   * Each iteration body is processed synchronously (includes already expanded).
+   */
+  private processForeach;
+  /**
+   * Process {{ expression }} — HTML-escaped output.
+   */
+  private processEscapedOutput;
+  /**
+   * Process {!! expression !!} — raw/unescaped output.
+   */
+  private processRawOutput;
+  /**
+   * Safely evaluate a JavaScript expression in the context of the given data.
+   */
+  private evaluate;
+  /**
+   * Escape HTML special characters to prevent XSS.
+   */
+  private escapeHtml;
+  /**
+   * Resolve a dot-notation view name to an absolute file path via the resolver.
+   */
+  private resolveName;
+  /**
+   * Parse a simple JSON-like object literal.
+   * Handles: { key: 'str' }, { key: "str" }, { key: true/false }, { key: 123 }
+   */
+  private parseSimpleObject;
+}
+//#endregion
+export { TemplateEngine, TemplateEngineResolver };
+//# sourceMappingURL=TemplateEngine.d.cts.map

package/dist/View/Engines/TemplateEngine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.cts","names":[],"sources":["../../../src/View/Engines/TemplateEngine.ts"],"mappings":";;;;;;;UAqBiB,sBAAA;EACf,QAAA,CAAS,IAAA;AAAA;AAAA,cAGE,cAAA,YAA0B,UAAA;EAAA,UAC3B,QAAA,EAAU,sBAAA;EAKpB;;;EAAA,WAAA,CAAY,QAAA,EAAU,sBAAA;EAOZ;;;EAAJ,GAAA,CAAI,IAAA,UAAc,IAAA,EAAM,MAAA,gBAAsB,OAAA;EAgB9C;;;;;;;;;;;EAAA,OAAA,CAAQ,MAAA,UAAgB,IAAA,EAAM,MAAA,gBAAsB,OAAA;EAmQlD;;;;EAAA,QA7OA,WAAA;EAgSiB;;;EAAA,QApRX,iBAAA;;;;UAsBN,eAAA;;;;;UAgBM,eAAA;;;;;;;UAuCN,SAAA;;;;;UAgGA,cAAA;;;;UAsCA,oBAAA;;;;UAcA,gBAAA;;;;UAcA,QAAA;;;;UAWA,UAAA;;;;UAYA,WAAA;;;;;UAcA,iBAAA;AAAA"}

package/dist/View/Engines/TemplateEngine.d.mts

@@ -0,0 +1,91 @@
+import { ViewEngine } from "./ViewEngine.mjs";
+
+//#region src/View/Engines/TemplateEngine.d.ts
+/**
+ * Dependency injection shim so the engine can resolve included views
+ * without creating a circular import with ViewFactory.
+ */
+interface TemplateEngineResolver {
+  findView(name: string): string;
+}
+declare class TemplateEngine implements ViewEngine {
+  protected resolver: TemplateEngineResolver | null;
+  /**
+   * Set the resolver used for @include / @extends directives.
+   */
+  setResolver(resolver: TemplateEngineResolver): void;
+  /**
+   * Get the evaluated contents of the view.
+   */
+  get(path: string, data: Record<string, any>): Promise<string>;
+  /**
+   * Compile a template string with the given data.
+   *
+   * Processing order:
+   *   1. @extends / @section / @yield  (layout assembly)
+   *   2. @include                       (async file inclusion)
+   *   3. @if / @elseif / @else / @endif (synchronous)
+   *   4. @foreach / @endforeach         (synchronous)
+   *   5. {{ expr }}   HTML-escaped
+   *   6. {!! expr !!} raw
+   */
+  compile(source: string, data: Record<string, any>): Promise<string>;
+  /**
+   * Synchronous directive processing: @if, @foreach, {{ }}, {!! !!}.
+   * Called both at the top level and recursively from @foreach bodies.
+   */
+  private processSync;
+  /**
+   * Compile a child template that extends a layout.
+   */
+  private compileWithLayout;
+  /**
+   * Extract @section('name') ... @endsection blocks from a template string.
+   */
+  private extractSections;
+  /**
+   * Process @include('view', data?) directives.
+   * Each included view is fully compiled (recursively) before insertion.
+   */
+  private processIncludes;
+  /**
+   * Process @if(condition) ... @elseif(condition) ... @else ... @endif blocks.
+   *
+   * Uses a character-scanning approach to handle nested @if correctly.
+   * Recurses until no more @if directives remain.
+   */
+  private processIf;
+  /**
+   * Process @foreach(items as item) ... @endforeach blocks.
+   * Each iteration body is processed synchronously (includes already expanded).
+   */
+  private processForeach;
+  /**
+   * Process {{ expression }} — HTML-escaped output.
+   */
+  private processEscapedOutput;
+  /**
+   * Process {!! expression !!} — raw/unescaped output.
+   */
+  private processRawOutput;
+  /**
+   * Safely evaluate a JavaScript expression in the context of the given data.
+   */
+  private evaluate;
+  /**
+   * Escape HTML special characters to prevent XSS.
+   */
+  private escapeHtml;
+  /**
+   * Resolve a dot-notation view name to an absolute file path via the resolver.
+   */
+  private resolveName;
+  /**
+   * Parse a simple JSON-like object literal.
+   * Handles: { key: 'str' }, { key: "str" }, { key: true/false }, { key: 123 }
+   */
+  private parseSimpleObject;
+}
+//#endregion
+export { TemplateEngine, TemplateEngineResolver };
+//# sourceMappingURL=TemplateEngine.d.mts.map

package/dist/View/Engines/TemplateEngine.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.mts","names":[],"sources":["../../../src/View/Engines/TemplateEngine.ts"],"mappings":";;;;;;;UAqBiB,sBAAA;EACf,QAAA,CAAS,IAAA;AAAA;AAAA,cAGE,cAAA,YAA0B,UAAA;EAAA,UAC3B,QAAA,EAAU,sBAAA;EAKpB;;;EAAA,WAAA,CAAY,QAAA,EAAU,sBAAA;EAOZ;;;EAAJ,GAAA,CAAI,IAAA,UAAc,IAAA,EAAM,MAAA,gBAAsB,OAAA;EAgB9C;;;;;;;;;;;EAAA,OAAA,CAAQ,MAAA,UAAgB,IAAA,EAAM,MAAA,gBAAsB,OAAA;EAmQlD;;;;EAAA,QA7OA,WAAA;EAgSiB;;;EAAA,QApRX,iBAAA;;;;UAsBN,eAAA;;;;;UAgBM,eAAA;;;;;;;UAuCN,SAAA;;;;;UAgGA,cAAA;;;;UAsCA,oBAAA;;;;UAcA,gBAAA;;;;UAcA,QAAA;;;;UAWA,UAAA;;;;UAYA,WAAA;;;;;UAcA,iBAAA;AAAA"}

package/dist/View/Engines/TemplateEngine.mjs

@@ -0,0 +1,2 @@
+import{readFileSync as e}from"fs";var t=class{resolver=null;setResolver(e){this.resolver=e}async get(t,n){let r=e(t,`utf8`);return this.compile(r,n)}async compile(e,t){let n=e.match(/@extends\(\s*['"]([^'"]+)['"]\s*\)/),r;r=n?await this.compileWithLayout(e,n[1],t):e;let i=await this.processIncludes(r,t);return this.processSync(i,t)}processSync(e,t){let n=e;return n=this.processIf(n,t),n=this.processForeach(n,t),n=this.processEscapedOutput(n,t),n=this.processRawOutput(n,t),n}async compileWithLayout(t,n,r){let i=this.extractSections(t);return e(this.resolveName(n),`utf8`).replace(/@yield\(\s*['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]*)['"]\s*)?\)/g,(e,t,n=``)=>i[t]===void 0?n:i[t])}extractSections(e){let t={},n=/@section\(\s*['"]([^'"]+)['"]\s*\)([\s\S]*?)@endsection/g,r;for(;(r=n.exec(e))!==null;)t[r[1]]=r[2].trim();return t}async processIncludes(t,n){let r=/@include\(\s*['"]([^'"]+)['"]\s*(?:,\s*(\{[^}]*\}))?\s*\)/g,i=[],a;for(;(a=r.exec(t))!==null;)i.push({full:a[0],name:a[1],extraData:a[2]});let o=t;for(let{full:t,name:r,extraData:a}of i){let i={...n};if(a)try{let e=this.parseSimpleObject(a);i={...i,...e}}catch{}let s=e(this.resolveName(r),`utf8`),c=await this.compile(s,i);o=o.replace(t,c)}return o}processIf(e,t){let n=e.indexOf(`@if(`);if(n===-1)return e;let r=n+4,i=1,a=r;for(;a<e.length&&i>0;)e[a]===`(`?i++:e[a]===`)`&&i--,i>0&&a++;let o=e.slice(r,a),s=1,c=a+1,l=[],u=a+1,d=o;for(;c<e.length&&s>0;)if(e.startsWith(`@if(`,c))s++,c+=4;else if(e.startsWith(`@endif`,c)&&s===1){l.push({condition:d,body:e.slice(u,c)}),c+=6;break}else if(e.startsWith(`@endif`,c))s--,c++;else if(s===1&&e.startsWith(`@elseif(`,c)){l.push({condition:d,body:e.slice(u,c)});let t=c+8,n=1,r=t;for(;r<e.length&&n>0;)e[r]===`(`?n++:e[r]===`)`&&n--,n>0&&r++;d=e.slice(t,r),u=r+1,c=r+1}else s===1&&e.startsWith(`@else`,c)&&!e.startsWith(`@elseif(`,c)?(l.push({condition:d,body:e.slice(u,c)}),d=`__else__`,u=c+5,c+=5):c++;let f=``;for(let e of l){if(e.condition===`__else__`){f=e.body;break}try{if(this.evaluate(e.condition,t)){f=e.body;break}}catch{}}let p=e.slice(0,n),m=e.slice(c),h=p+f+m;return this.processIf(h,t)}processForeach(e,t){return e.replace(/@foreach\(([^)]+)\s+as\s+(\w+)(?:\s*,\s*(\w+))?\)([\s\S]*?)@endforeach/g,(e,n,r,i,a)=>{let o;try{o=this.evaluate(n.trim(),t)}catch{return``}return!o||typeof o!=`object`?``:(Array.isArray(o)?o.map((e,t)=>[t,e]):Object.entries(o)).map(([e,n])=>{let o={...t,[r]:n};return i&&(o[i]=e),this.processSync(a,o)}).join(``)})}processEscapedOutput(e,t){return e.replace(/\{\{\s*([\s\S]+?)\s*\}\}/g,(e,n)=>{try{let e=this.evaluate(n.trim(),t);return this.escapeHtml(String(e??``))}catch{return``}})}processRawOutput(e,t){return e.replace(/\{!!\s*([\s\S]+?)\s*!!\}/g,(e,n)=>{try{let e=this.evaluate(n.trim(),t);return String(e??``)}catch{return``}})}evaluate(e,t){let n=Object.keys(t),r=Object.values(t);return Function(...n,`return (${e});`)(...r)}escapeHtml(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#039;`)}resolveName(e){if(!this.resolver)throw Error(`TemplateEngine: No resolver set. Cannot resolve view "${e}". Call setResolver() before using @include or @extends.`);return this.resolver.findView(e)}parseSimpleObject(e){let t=e.trim().replace(/^\{/,``).replace(/\}$/,``).trim(),n={},r=/(\w+)\s*:\s*(?:'([^']*)'|"([^"]*)"|(true|false|\d+(?:\.\d+)?))/g,i;for(;(i=r.exec(t))!==null;){let e=i[1],t=i[2]??i[3],r=i[4];t===void 0?r===`true`?n[e]=!0:r===`false`?n[e]=!1:r!==void 0&&(n[e]=Number(r)):n[e]=t}return n}};export{t as TemplateEngine};
+//# sourceMappingURL=TemplateEngine.mjs.map

package/dist/View/Engines/TemplateEngine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.mjs","names":[],"sources":["../../../src/View/Engines/TemplateEngine.ts"],"sourcesContent":["/**\n * TemplateEngine - Simple template engine\n *\n * Supports a subset of Blade-like directives:\n *   - {{ variable }}        HTML-escaped output\n *   - {!! variable !!}      Raw/unescaped output\n *   - @if / @elseif / @else / @endif\n *   - @foreach / @endforeach\n *   - @include('partial', data?)\n *   - @extends('layout') + @section('name') ... @endsection + @yield('name')\n *\n * Mirrors Laravel's Illuminate\\View\\Engines\\CompilerEngine (simplified)\n */\n\nimport { readFileSync } from 'fs';\nimport type { ViewEngine } from './ViewEngine';\n\n/**\n * Dependency injection shim so the engine can resolve included views\n * without creating a circular import with ViewFactory.\n */\nexport interface TemplateEngineResolver {\n  findView(name: string): string;\n}\n\nexport class TemplateEngine implements ViewEngine {\n  protected resolver: TemplateEngineResolver | null = null;\n\n  /**\n   * Set the resolver used for @include / @extends directives.\n   */\n  setResolver(resolver: TemplateEngineResolver): void {\n    this.resolver = resolver;\n  }\n\n  /**\n   * Get the evaluated contents of the view.\n   */\n  async get(path: string, data: Record<string, any>): Promise<string> {\n    const source = readFileSync(path, 'utf8');\n    return this.compile(source, data);\n  }\n\n  /**\n   * Compile a template string with the given data.\n   *\n   * Processing order:\n   *   1. @extends / @section / @yield  (layout assembly)\n   *   2. @include                       (async file inclusion)\n   *   3. @if / @elseif / @else / @endif (synchronous)\n   *   4. @foreach / @endforeach         (synchronous)\n   *   5. {{ expr }}   HTML-escaped\n   *   6. {!! expr !!} raw\n   */\n  async compile(source: string, data: Record<string, any>): Promise<string> {\n    // --- Step 1: Layout inheritance (@extends / @section / @yield) ---\n    const extendsMatch = source.match(/@extends\\(\\s*['\"]([^'\"]+)['\"]\\s*\\)/);\n\n    let assembled: string;\n    if (extendsMatch) {\n      assembled = await this.compileWithLayout(source, extendsMatch[1], data);\n    } else {\n      assembled = source;\n    }\n\n    // --- Step 2: Expand all @include directives (async, reads files) ---\n    const withIncludes = await this.processIncludes(assembled, data);\n\n    // --- Steps 3-6: Synchronous directive processing ---\n    return this.processSync(withIncludes, data);\n  }\n\n  /**\n   * Synchronous directive processing: @if, @foreach, {{ }}, {!! !!}.\n   * Called both at the top level and recursively from @foreach bodies.\n   */\n  private processSync(source: string, data: Record<string, any>): string {\n    let output = source;\n    output = this.processIf(output, data);\n    output = this.processForeach(output, data);\n    output = this.processEscapedOutput(output, data);\n    output = this.processRawOutput(output, data);\n    return output;\n  }\n\n  /**\n   * Compile a child template that extends a layout.\n   */\n  private async compileWithLayout(childSource: string, layoutName: string, data: Record<string, any>): Promise<string> {\n    // Extract all @section ... @endsection blocks from the child\n    const sections = this.extractSections(childSource);\n\n    // Load the layout template\n    const layoutPath = this.resolveName(layoutName);\n    const layoutSource = readFileSync(layoutPath, 'utf8');\n\n    // Replace @yield('name') / @yield('name', 'default') in the layout\n    const output = layoutSource.replace(\n      /@yield\\(\\s*['\"]([^'\"]+)['\"]\\s*(?:,\\s*['\"]([^'\"]*)['\"]\\s*)?\\)/g,\n      (_match: string, sectionName: string, defaultValue: string = '') => {\n        return sections[sectionName] !== undefined ? sections[sectionName] : defaultValue;\n      }\n    );\n\n    return output;\n  }\n\n  /**\n   * Extract @section('name') ... @endsection blocks from a template string.\n   */\n  private extractSections(source: string): Record<string, string> {\n    const sections: Record<string, string> = {};\n    const sectionRegex = /@section\\(\\s*['\"]([^'\"]+)['\"]\\s*\\)([\\s\\S]*?)@endsection/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = sectionRegex.exec(source)) !== null) {\n      sections[match[1]] = match[2].trim();\n    }\n\n    return sections;\n  }\n\n  /**\n   * Process @include('view', data?) directives.\n   * Each included view is fully compiled (recursively) before insertion.\n   */\n  private async processIncludes(source: string, data: Record<string, any>): Promise<string> {\n    const includeRegex = /@include\\(\\s*['\"]([^'\"]+)['\"]\\s*(?:,\\s*(\\{[^}]*\\}))?\\s*\\)/g;\n    const matches: Array<{ full: string; name: string; extraData: string | undefined }> = [];\n\n    let match: RegExpExecArray | null;\n    while ((match = includeRegex.exec(source)) !== null) {\n      matches.push({ full: match[0], name: match[1], extraData: match[2] });\n    }\n\n    let output = source;\n\n    for (const { full, name, extraData } of matches) {\n      let includeData = { ...data };\n\n      if (extraData) {\n        try {\n          const parsed = this.parseSimpleObject(extraData);\n          includeData = { ...includeData, ...parsed };\n        } catch {\n          // Ignore malformed extra data\n        }\n      }\n\n      const includePath = this.resolveName(name);\n      const includeSource = readFileSync(includePath, 'utf8');\n      // Fully compile the included template (handles its own @extends / @include)\n      const rendered = await this.compile(includeSource, includeData);\n      output = output.replace(full, rendered);\n    }\n\n    return output;\n  }\n\n  /**\n   * Process @if(condition) ... @elseif(condition) ... @else ... @endif blocks.\n   *\n   * Uses a character-scanning approach to handle nested @if correctly.\n   * Recurses until no more @if directives remain.\n   */\n  private processIf(source: string, data: Record<string, any>): string {\n    const ifStart = source.indexOf('@if(');\n    if (ifStart === -1) {\n      return source;\n    }\n\n    // Extract the main @if condition (handles nested parentheses)\n    const condStart = ifStart + 4;\n    let depth = 1;\n    let condEnd = condStart;\n    while (condEnd < source.length && depth > 0) {\n      if (source[condEnd] === '(') depth++;\n      else if (source[condEnd] === ')') depth--;\n      if (depth > 0) condEnd++;\n    }\n    const mainCondition = source.slice(condStart, condEnd);\n\n    // Scan for @elseif / @else / @endif at nesting level 1\n    let nesting = 1;\n    let pos = condEnd + 1;\n\n    // Each segment: { condition: string (main/elseif) | 'else' | 'if-body', body: string }\n    type Segment = { condition: string; body: string };\n    const segments: Segment[] = [];\n    let segmentStart = condEnd + 1;\n    // The first segment uses the main condition\n    let pendingCondition: string = mainCondition;\n\n    while (pos < source.length && nesting > 0) {\n      if (source.startsWith('@if(', pos)) {\n        nesting++;\n        pos += 4;\n      } else if (source.startsWith('@endif', pos) && nesting === 1) {\n        // Close the last segment\n        segments.push({ condition: pendingCondition, body: source.slice(segmentStart, pos) });\n        pos += 6;\n        break;\n      } else if (source.startsWith('@endif', pos)) {\n        nesting--;\n        pos++;\n      } else if (nesting === 1 && source.startsWith('@elseif(', pos)) {\n        // Close current segment\n        segments.push({ condition: pendingCondition, body: source.slice(segmentStart, pos) });\n\n        // Extract the @elseif condition\n        const elseifCondStart = pos + 8;\n        let elseifDepth = 1;\n        let elseifCondEnd = elseifCondStart;\n        while (elseifCondEnd < source.length && elseifDepth > 0) {\n          if (source[elseifCondEnd] === '(') elseifDepth++;\n          else if (source[elseifCondEnd] === ')') elseifDepth--;\n          if (elseifDepth > 0) elseifCondEnd++;\n        }\n        pendingCondition = source.slice(elseifCondStart, elseifCondEnd);\n        segmentStart = elseifCondEnd + 1;\n        pos = elseifCondEnd + 1;\n      } else if (nesting === 1 && source.startsWith('@else', pos) && !source.startsWith('@elseif(', pos)) {\n        // Close current segment\n        segments.push({ condition: pendingCondition, body: source.slice(segmentStart, pos) });\n        pendingCondition = '__else__';\n        segmentStart = pos + 5;\n        pos += 5;\n      } else {\n        pos++;\n      }\n    }\n\n    // Evaluate the segments to find the first truthy one\n    let replacement = '';\n    for (const seg of segments) {\n      if (seg.condition === '__else__') {\n        replacement = seg.body;\n        break;\n      }\n      try {\n        if (this.evaluate(seg.condition, data)) {\n          replacement = seg.body;\n          break;\n        }\n      } catch {\n        // Evaluation error — treat as falsy\n      }\n    }\n\n    const before = source.slice(0, ifStart);\n    const after = source.slice(pos);\n    const result = before + replacement + after;\n\n    // Recurse to process remaining @if blocks\n    return this.processIf(result, data);\n  }\n\n  /**\n   * Process @foreach(items as item) ... @endforeach blocks.\n   * Each iteration body is processed synchronously (includes already expanded).\n   */\n  private processForeach(source: string, data: Record<string, any>): string {\n    const foreachRegex = /@foreach\\(([^)]+)\\s+as\\s+(\\w+)(?:\\s*,\\s*(\\w+))?\\)([\\s\\S]*?)@endforeach/g;\n\n    return source.replace(\n      foreachRegex,\n      (_match: string, expr: string, valueVar: string, keyVar: string | undefined, body: string) => {\n        let items: any;\n        try {\n          items = this.evaluate(expr.trim(), data);\n        } catch {\n          return '';\n        }\n\n        if (!items || typeof items !== 'object') {\n          return '';\n        }\n\n        const entries: Array<[any, any]> = Array.isArray(items)\n          ? items.map((v: any, i: number) => [i, v])\n          : Object.entries(items);\n\n        return entries\n          .map(([key, value]) => {\n            const loopData: Record<string, any> = { ...data, [valueVar]: value };\n            if (keyVar) {\n              loopData[keyVar] = key;\n            }\n            // Use synchronous processing — includes are already expanded\n            return this.processSync(body, loopData);\n          })\n          .join('');\n      }\n    );\n  }\n\n  /**\n   * Process {{ expression }} — HTML-escaped output.\n   */\n  private processEscapedOutput(source: string, data: Record<string, any>): string {\n    return source.replace(/\\{\\{\\s*([\\s\\S]+?)\\s*\\}\\}/g, (_match: string, expr: string) => {\n      try {\n        const value = this.evaluate(expr.trim(), data);\n        return this.escapeHtml(String(value ?? ''));\n      } catch {\n        return '';\n      }\n    });\n  }\n\n  /**\n   * Process {!! expression !!} — raw/unescaped output.\n   */\n  private processRawOutput(source: string, data: Record<string, any>): string {\n    return source.replace(/\\{!!\\s*([\\s\\S]+?)\\s*!!\\}/g, (_match: string, expr: string) => {\n      try {\n        const value = this.evaluate(expr.trim(), data);\n        return String(value ?? '');\n      } catch {\n        return '';\n      }\n    });\n  }\n\n  /**\n   * Safely evaluate a JavaScript expression in the context of the given data.\n   */\n  private evaluate(expr: string, data: Record<string, any>): any {\n    const keys = Object.keys(data);\n    const values = Object.values(data);\n\n    const fn = new Function(...keys, `return (${expr});`);\n    return fn(...values);\n  }\n\n  /**\n   * Escape HTML special characters to prevent XSS.\n   */\n  private escapeHtml(str: string): string {\n    return str\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')\n      .replace(/>/g, '&gt;')\n      .replace(/\"/g, '&quot;')\n      .replace(/'/g, '&#039;');\n  }\n\n  /**\n   * Resolve a dot-notation view name to an absolute file path via the resolver.\n   */\n  private resolveName(name: string): string {\n    if (!this.resolver) {\n      throw new Error(\n        `TemplateEngine: No resolver set. Cannot resolve view \"${name}\". ` +\n          `Call setResolver() before using @include or @extends.`\n      );\n    }\n    return this.resolver.findView(name);\n  }\n\n  /**\n   * Parse a simple JSON-like object literal.\n   * Handles: { key: 'str' }, { key: \"str\" }, { key: true/false }, { key: 123 }\n   */\n  private parseSimpleObject(str: string): Record<string, any> {\n    const inner = str.trim().replace(/^\\{/, '').replace(/\\}$/, '').trim();\n    const result: Record<string, any> = {};\n    const pairRegex = /(\\w+)\\s*:\\s*(?:'([^']*)'|\"([^\"]*)\"|(true|false|\\d+(?:\\.\\d+)?))/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = pairRegex.exec(inner)) !== null) {\n      const key = match[1];\n      const strVal = match[2] ?? match[3];\n      const primitiveVal = match[4];\n\n      if (strVal !== undefined) {\n        result[key] = strVal;\n      } else if (primitiveVal === 'true') {\n        result[key] = true;\n      } else if (primitiveVal === 'false') {\n        result[key] = false;\n      } else if (primitiveVal !== undefined) {\n        result[key] = Number(primitiveVal);\n      }\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/dist/View/Engines/ViewEngine.d.cts

@@ -0,0 +1,15 @@
+//#region src/View/Engines/ViewEngine.d.ts
+/**
+ * ViewEngine - Contract for template engines
+ *
+ * Mirrors Laravel's Illuminate\View\Engines\EngineInterface
+ */
+interface ViewEngine {
+  /**
+   * Get the evaluated contents of the view.
+   */
+  get(path: string, data: Record<string, any>): Promise<string>;
+}
+//#endregion
+export { ViewEngine };
+//# sourceMappingURL=ViewEngine.d.cts.map

package/dist/View/Engines/ViewEngine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewEngine.d.cts","names":[],"sources":["../../../src/View/Engines/ViewEngine.ts"],"mappings":";;AAMA;;;;UAAiB,UAAA;EAIX;;;EAAJ,GAAA,CAAI,IAAA,UAAc,IAAA,EAAM,MAAA,gBAAsB,OAAA;AAAA"}

package/dist/View/Engines/ViewEngine.d.mts

@@ -0,0 +1,15 @@
+//#region src/View/Engines/ViewEngine.d.ts
+/**
+ * ViewEngine - Contract for template engines
+ *
+ * Mirrors Laravel's Illuminate\View\Engines\EngineInterface
+ */
+interface ViewEngine {
+  /**
+   * Get the evaluated contents of the view.
+   */
+  get(path: string, data: Record<string, any>): Promise<string>;
+}
+//#endregion
+export { ViewEngine };
+//# sourceMappingURL=ViewEngine.d.mts.map

package/dist/View/Engines/ViewEngine.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewEngine.d.mts","names":[],"sources":["../../../src/View/Engines/ViewEngine.ts"],"mappings":";;AAMA;;;;UAAiB,UAAA;EAIX;;;EAAJ,GAAA,CAAI,IAAA,UAAc,IAAA,EAAM,MAAA,gBAAsB,OAAA;AAAA"}

package/dist/View/View.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);var e=class{viewPath;viewName;viewData;engine;constructor(e,t,n,r={}){this.engine=e,this.viewName=t,this.viewPath=n,this.viewData=r}with(e,t){return typeof e==`string`?this.viewData[e]=t:Object.assign(this.viewData,e),this}async render(){return this.engine.get(this.viewPath,this.viewData)}name(){return this.viewName}getData(){return this.viewData}getPath(){return this.viewPath}async toHtml(){return this.render()}toString(){return`[View: ${this.viewName}]`}};exports.View=e;

package/dist/View/View.d.cts

@@ -0,0 +1,43 @@
+import { ViewEngine } from "./Engines/ViewEngine.cjs";
+
+//#region src/View/View.d.ts
+declare class View {
+  protected viewPath: string;
+  protected viewName: string;
+  protected viewData: Record<string, any>;
+  protected engine: ViewEngine;
+  constructor(engine: ViewEngine, name: string, path: string, data?: Record<string, any>);
+  /**
+   * Add a piece of data to the view.
+   * Laravel: $view->with('key', 'value') or $view->with(['key' => 'value'])
+   */
+  with(key: string | Record<string, any>, value?: any): this;
+  /**
+   * Render the view to an HTML string.
+   */
+  render(): Promise<string>;
+  /**
+   * Get the name of the view.
+   */
+  name(): string;
+  /**
+   * Get the array of view data.
+   */
+  getData(): Record<string, any>;
+  /**
+   * Get the path to the view file.
+   */
+  getPath(): string;
+  /**
+   * Alias for render() — allows using the View as an HTML string source.
+   */
+  toHtml(): Promise<string>;
+  /**
+   * Allow string coercion (synchronous) — returns the view name for debugging.
+   * For the actual HTML, always await render().
+   */
+  toString(): string;
+}
+//#endregion
+export { View };
+//# sourceMappingURL=View.d.cts.map

package/dist/View/View.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"View.d.cts","names":[],"sources":["../../src/View/View.ts"],"mappings":";;;cAQa,IAAA;EAAA,UACD,QAAA;EAAA,UACA,QAAA;EAAA,UACA,QAAA,EAAU,MAAA;EAAA,UACV,MAAA,EAAQ,UAAA;cAEN,MAAA,EAAQ,UAAA,EAAY,IAAA,UAAc,IAAA,UAAc,IAAA,GAAM,MAAA;EAsCvD;;;;EA3BX,IAAA,CAAK,GAAA,WAAc,MAAA,eAAqB,KAAA;EAf9B;;;EA4BJ,MAAA,CAAA,GAAU,OAAA;EA1BE;;;EAiClB,IAAA,CAAA;EA/BgC;;;EAsChC,OAAA,CAAA,GAAW,MAAA;EA3BX;;;EAkCA,OAAA,CAAA;EArBM;;;EA4BA,MAAA,CAAA,GAAU,OAAA;EAdL;;;;EAsBX,QAAA,CAAA;AAAA"}

package/dist/View/View.d.mts

@@ -0,0 +1,43 @@
+import { ViewEngine } from "./Engines/ViewEngine.mjs";
+
+//#region src/View/View.d.ts
+declare class View {
+  protected viewPath: string;
+  protected viewName: string;
+  protected viewData: Record<string, any>;
+  protected engine: ViewEngine;
+  constructor(engine: ViewEngine, name: string, path: string, data?: Record<string, any>);
+  /**
+   * Add a piece of data to the view.
+   * Laravel: $view->with('key', 'value') or $view->with(['key' => 'value'])
+   */
+  with(key: string | Record<string, any>, value?: any): this;
+  /**
+   * Render the view to an HTML string.
+   */
+  render(): Promise<string>;
+  /**
+   * Get the name of the view.
+   */
+  name(): string;
+  /**
+   * Get the array of view data.
+   */
+  getData(): Record<string, any>;
+  /**
+   * Get the path to the view file.
+   */
+  getPath(): string;
+  /**
+   * Alias for render() — allows using the View as an HTML string source.
+   */
+  toHtml(): Promise<string>;
+  /**
+   * Allow string coercion (synchronous) — returns the view name for debugging.
+   * For the actual HTML, always await render().
+   */
+  toString(): string;
+}
+//#endregion
+export { View };
+//# sourceMappingURL=View.d.mts.map

package/dist/View/View.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"View.d.mts","names":[],"sources":["../../src/View/View.ts"],"mappings":";;;cAQa,IAAA;EAAA,UACD,QAAA;EAAA,UACA,QAAA;EAAA,UACA,QAAA,EAAU,MAAA;EAAA,UACV,MAAA,EAAQ,UAAA;cAEN,MAAA,EAAQ,UAAA,EAAY,IAAA,UAAc,IAAA,UAAc,IAAA,GAAM,MAAA;EAsCvD;;;;EA3BX,IAAA,CAAK,GAAA,WAAc,MAAA,eAAqB,KAAA;EAf9B;;;EA4BJ,MAAA,CAAA,GAAU,OAAA;EA1BE;;;EAiClB,IAAA,CAAA;EA/BgC;;;EAsChC,OAAA,CAAA,GAAW,MAAA;EA3BX;;;EAkCA,OAAA,CAAA;EArBM;;;EA4BA,MAAA,CAAA,GAAU,OAAA;EAdL;;;;EAsBX,QAAA,CAAA;AAAA"}

package/dist/View/View.mjs

@@ -0,0 +1,2 @@
+var e=class{viewPath;viewName;viewData;engine;constructor(e,t,n,r={}){this.engine=e,this.viewName=t,this.viewPath=n,this.viewData=r}with(e,t){return typeof e==`string`?this.viewData[e]=t:Object.assign(this.viewData,e),this}async render(){return this.engine.get(this.viewPath,this.viewData)}name(){return this.viewName}getData(){return this.viewData}getPath(){return this.viewPath}async toHtml(){return this.render()}toString(){return`[View: ${this.viewName}]`}};export{e as View};
+//# sourceMappingURL=View.mjs.map

package/dist/View/View.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"View.mjs","names":[],"sources":["../../src/View/View.ts"],"sourcesContent":["/**\n * View - Represents a renderable view with its data.\n *\n * Mirrors Laravel's Illuminate\\View\\View\n */\n\nimport type { ViewEngine } from './Engines/ViewEngine';\n\nexport class View {\n  protected viewPath: string;\n  protected viewName: string;\n  protected viewData: Record<string, any>;\n  protected engine: ViewEngine;\n\n  constructor(engine: ViewEngine, name: string, path: string, data: Record<string, any> = {}) {\n    this.engine = engine;\n    this.viewName = name;\n    this.viewPath = path;\n    this.viewData = data;\n  }\n\n  /**\n   * Add a piece of data to the view.\n   * Laravel: $view->with('key', 'value') or $view->with(['key' => 'value'])\n   */\n  with(key: string | Record<string, any>, value?: any): this {\n    if (typeof key === 'string') {\n      this.viewData[key] = value;\n    } else {\n      Object.assign(this.viewData, key);\n    }\n\n    return this;\n  }\n\n  /**\n   * Render the view to an HTML string.\n   */\n  async render(): Promise<string> {\n    return this.engine.get(this.viewPath, this.viewData);\n  }\n\n  /**\n   * Get the name of the view.\n   */\n  name(): string {\n    return this.viewName;\n  }\n\n  /**\n   * Get the array of view data.\n   */\n  getData(): Record<string, any> {\n    return this.viewData;\n  }\n\n  /**\n   * Get the path to the view file.\n   */\n  getPath(): string {\n    return this.viewPath;\n  }\n\n  /**\n   * Alias for render() — allows using the View as an HTML string source.\n   */\n  async toHtml(): Promise<string> {\n    return this.render();\n  }\n\n  /**\n   * Allow string coercion (synchronous) — returns the view name for debugging.\n   * For the actual HTML, always await render().\n   */\n  toString(): string {\n    return `[View: ${this.viewName}]`;\n  }\n}\n"],"mappings":"AAQA,IAAa,EAAb,KAAkB,CAChB,SACA,SACA,SACA,OAEA,YAAY,EAAoB,EAAc,EAAc,EAA4B,EAAE,CAAE,CAC1F,KAAK,OAAS,EACd,KAAK,SAAW,EAChB,KAAK,SAAW,EAChB,KAAK,SAAW,EAOlB,KAAK,EAAmC,EAAmB,CAOzD,OANI,OAAO,GAAQ,SACjB,KAAK,SAAS,GAAO,EAErB,OAAO,OAAO,KAAK,SAAU,EAAI,CAG5B,KAMT,MAAM,QAA0B,CAC9B,OAAO,KAAK,OAAO,IAAI,KAAK,SAAU,KAAK,SAAS,CAMtD,MAAe,CACb,OAAO,KAAK,SAMd,SAA+B,CAC7B,OAAO,KAAK,SAMd,SAAkB,CAChB,OAAO,KAAK,SAMd,MAAM,QAA0B,CAC9B,OAAO,KAAK,QAAQ,CAOtB,UAAmB,CACjB,MAAO,UAAU,KAAK,SAAS"}

package/dist/View/ViewFactory.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./View.cjs`);let t=require(`path`),n=require(`fs`);var r=class{paths;extensions;engine;shared={};constructor(e,t,n=[`.html`,`.orchestr.html`]){this.engine=e,this.paths=t,this.extensions=n}make(t,n={}){let r=this.findView(t),i={...this.shared,...n};return new e.View(this.engine,t,r,i)}exists(e){try{return this.findView(e),!0}catch{return!1}}share(e,t){typeof e==`string`?this.shared[e]=t:Object.assign(this.shared,e)}addLocation(e){this.paths.push(e)}getPaths(){return this.paths}getShared(){return this.shared}findView(e){let r=e.replace(/\./g,`/`);for(let e of this.paths)for(let i of this.extensions){let a=(0,t.join)(e,r+i);if((0,n.existsSync)(a))return a}throw Error(`View [${e}] not found. Searched in: ${this.paths.join(`, `)} with extensions: ${this.extensions.join(`, `)}`)}};exports.ViewFactory=r;

package/dist/View/ViewFactory.d.cts

@@ -0,0 +1,54 @@
+import { ViewEngine } from "./Engines/ViewEngine.cjs";
+import { TemplateEngineResolver } from "./Engines/TemplateEngine.cjs";
+import { View } from "./View.cjs";
+
+//#region src/View/ViewFactory.d.ts
+declare class ViewFactory implements TemplateEngineResolver {
+  protected paths: string[];
+  protected extensions: string[];
+  protected engine: ViewEngine;
+  protected shared: Record<string, any>;
+  constructor(engine: ViewEngine, paths: string[], extensions?: string[]);
+  /**
+   * Create a new view instance.
+   * Laravel: view('welcome', ['key' => 'value'])
+   */
+  make(view: string, data?: Record<string, any>): View;
+  /**
+   * Determine if a given view exists.
+   * Laravel: View::exists('welcome')
+   */
+  exists(view: string): boolean;
+  /**
+   * Add a piece of shared data to the environment.
+   * Laravel: View::share('key', 'value')
+   */
+  share(key: string | Record<string, any>, value?: any): void;
+  /**
+   * Add a location to the array of view paths.
+   * Laravel: View::addLocation('/path/to/views')
+   */
+  addLocation(path: string): void;
+  /**
+   * Get all registered view paths.
+   */
+  getPaths(): string[];
+  /**
+   * Get all shared data.
+   */
+  getShared(): Record<string, any>;
+  /**
+   * Resolve a dot-notation view name to an absolute file path.
+   *
+   * 'welcome'        -> {path}/welcome.html
+   * 'layouts.app'   -> {path}/layouts/app.html
+   * 'emails.invoice' -> {path}/emails/invoice.html
+   *
+   * Implements TemplateEngineResolver so the TemplateEngine can use it
+   * for @include and @extends resolution.
+   */
+  findView(name: string): string;
+}
+//#endregion
+export { ViewFactory };
+//# sourceMappingURL=ViewFactory.d.cts.map

package/dist/View/ViewFactory.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewFactory.d.cts","names":[],"sources":["../../src/View/ViewFactory.ts"],"mappings":";;;;;cAYa,WAAA,YAAuB,sBAAA;EAAA,UACxB,KAAA;EAAA,UACA,UAAA;EAAA,UACA,MAAA,EAAQ,UAAA;EAAA,UACR,MAAA,EAAQ,MAAA;cAEN,MAAA,EAAQ,UAAA,EAAY,KAAA,YAAiB,UAAA;EA2DpC;;;;EAjDb,IAAA,CAAK,IAAA,UAAc,IAAA,GAAM,MAAA,gBAA2B,IAAA;EAf1C;;;;EAyBV,MAAA,CAAO,IAAA;EAtBW;;;;EAmClB,KAAA,CAAM,GAAA,WAAc,MAAA,eAAqB,KAAA;EAjCQ;;;;EA6CjD,WAAA,CAAY,IAAA;EAnCwC;;;EA0CpD,QAAA,CAAA;EAnBoB;;;EA0BpB,SAAA,CAAA,GAAa,MAAA;EAdD;;;;;;;;;;EA4BZ,QAAA,CAAS,IAAA;AAAA"}

package/dist/View/ViewFactory.d.mts

@@ -0,0 +1,54 @@
+import { ViewEngine } from "./Engines/ViewEngine.mjs";
+import { TemplateEngineResolver } from "./Engines/TemplateEngine.mjs";
+import { View } from "./View.mjs";
+
+//#region src/View/ViewFactory.d.ts
+declare class ViewFactory implements TemplateEngineResolver {
+  protected paths: string[];
+  protected extensions: string[];
+  protected engine: ViewEngine;
+  protected shared: Record<string, any>;
+  constructor(engine: ViewEngine, paths: string[], extensions?: string[]);
+  /**
+   * Create a new view instance.
+   * Laravel: view('welcome', ['key' => 'value'])
+   */
+  make(view: string, data?: Record<string, any>): View;
+  /**
+   * Determine if a given view exists.
+   * Laravel: View::exists('welcome')
+   */
+  exists(view: string): boolean;
+  /**
+   * Add a piece of shared data to the environment.
+   * Laravel: View::share('key', 'value')
+   */
+  share(key: string | Record<string, any>, value?: any): void;
+  /**
+   * Add a location to the array of view paths.
+   * Laravel: View::addLocation('/path/to/views')
+   */
+  addLocation(path: string): void;
+  /**
+   * Get all registered view paths.
+   */
+  getPaths(): string[];
+  /**
+   * Get all shared data.
+   */
+  getShared(): Record<string, any>;
+  /**
+   * Resolve a dot-notation view name to an absolute file path.
+   *
+   * 'welcome'        -> {path}/welcome.html
+   * 'layouts.app'   -> {path}/layouts/app.html
+   * 'emails.invoice' -> {path}/emails/invoice.html
+   *
+   * Implements TemplateEngineResolver so the TemplateEngine can use it
+   * for @include and @extends resolution.
+   */
+  findView(name: string): string;
+}
+//#endregion
+export { ViewFactory };
+//# sourceMappingURL=ViewFactory.d.mts.map

package/dist/View/ViewFactory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewFactory.d.mts","names":[],"sources":["../../src/View/ViewFactory.ts"],"mappings":";;;;;cAYa,WAAA,YAAuB,sBAAA;EAAA,UACxB,KAAA;EAAA,UACA,UAAA;EAAA,UACA,MAAA,EAAQ,UAAA;EAAA,UACR,MAAA,EAAQ,MAAA;cAEN,MAAA,EAAQ,UAAA,EAAY,KAAA,YAAiB,UAAA;EA2DpC;;;;EAjDb,IAAA,CAAK,IAAA,UAAc,IAAA,GAAM,MAAA,gBAA2B,IAAA;EAf1C;;;;EAyBV,MAAA,CAAO,IAAA;EAtBW;;;;EAmClB,KAAA,CAAM,GAAA,WAAc,MAAA,eAAqB,KAAA;EAjCQ;;;;EA6CjD,WAAA,CAAY,IAAA;EAnCwC;;;EA0CpD,QAAA,CAAA;EAnBoB;;;EA0BpB,SAAA,CAAA,GAAa,MAAA;EAdD;;;;;;;;;;EA4BZ,QAAA,CAAS,IAAA;AAAA"}

package/dist/View/ViewFactory.mjs

@@ -0,0 +1,2 @@
+import{View as e}from"./View.mjs";import{join as t}from"path";import{existsSync as n}from"fs";var r=class{paths;extensions;engine;shared={};constructor(e,t,n=[`.html`,`.orchestr.html`]){this.engine=e,this.paths=t,this.extensions=n}make(t,n={}){let r=this.findView(t),i={...this.shared,...n};return new e(this.engine,t,r,i)}exists(e){try{return this.findView(e),!0}catch{return!1}}share(e,t){typeof e==`string`?this.shared[e]=t:Object.assign(this.shared,e)}addLocation(e){this.paths.push(e)}getPaths(){return this.paths}getShared(){return this.shared}findView(e){let r=e.replace(/\./g,`/`);for(let e of this.paths)for(let i of this.extensions){let a=t(e,r+i);if(n(a))return a}throw Error(`View [${e}] not found. Searched in: ${this.paths.join(`, `)} with extensions: ${this.extensions.join(`, `)}`)}};export{r as ViewFactory};
+//# sourceMappingURL=ViewFactory.mjs.map

package/dist/View/ViewFactory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewFactory.mjs","names":[],"sources":["../../src/View/ViewFactory.ts"],"sourcesContent":["/**\n * ViewFactory - Resolves view names and creates View instances.\n *\n * Mirrors Laravel's Illuminate\\View\\Factory\n */\n\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport type { TemplateEngineResolver } from './Engines/TemplateEngine';\nimport type { ViewEngine } from './Engines/ViewEngine';\nimport { View } from './View';\n\nexport class ViewFactory implements TemplateEngineResolver {\n  protected paths: string[];\n  protected extensions: string[];\n  protected engine: ViewEngine;\n  protected shared: Record<string, any> = {};\n\n  constructor(engine: ViewEngine, paths: string[], extensions: string[] = ['.html', '.orchestr.html']) {\n    this.engine = engine;\n    this.paths = paths;\n    this.extensions = extensions;\n  }\n\n  /**\n   * Create a new view instance.\n   * Laravel: view('welcome', ['key' => 'value'])\n   */\n  make(view: string, data: Record<string, any> = {}): View {\n    const path = this.findView(view);\n    const mergedData = { ...this.shared, ...data };\n    return new View(this.engine, view, path, mergedData);\n  }\n\n  /**\n   * Determine if a given view exists.\n   * Laravel: View::exists('welcome')\n   */\n  exists(view: string): boolean {\n    try {\n      this.findView(view);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Add a piece of shared data to the environment.\n   * Laravel: View::share('key', 'value')\n   */\n  share(key: string | Record<string, any>, value?: any): void {\n    if (typeof key === 'string') {\n      this.shared[key] = value;\n    } else {\n      Object.assign(this.shared, key);\n    }\n  }\n\n  /**\n   * Add a location to the array of view paths.\n   * Laravel: View::addLocation('/path/to/views')\n   */\n  addLocation(path: string): void {\n    this.paths.push(path);\n  }\n\n  /**\n   * Get all registered view paths.\n   */\n  getPaths(): string[] {\n    return this.paths;\n  }\n\n  /**\n   * Get all shared data.\n   */\n  getShared(): Record<string, any> {\n    return this.shared;\n  }\n\n  /**\n   * Resolve a dot-notation view name to an absolute file path.\n   *\n   * 'welcome'        -> {path}/welcome.html\n   * 'layouts.app'   -> {path}/layouts/app.html\n   * 'emails.invoice' -> {path}/emails/invoice.html\n   *\n   * Implements TemplateEngineResolver so the TemplateEngine can use it\n   * for @include and @extends resolution.\n   */\n  findView(name: string): string {\n    // Convert dot notation to directory separator\n    const relativePath = name.replace(/\\./g, '/');\n\n    for (const basePath of this.paths) {\n      for (const ext of this.extensions) {\n        const fullPath = join(basePath, relativePath + ext);\n        if (existsSync(fullPath)) {\n          return fullPath;\n        }\n      }\n    }\n\n    throw new Error(\n      `View [${name}] not found. Searched in: ${this.paths.join(', ')} ` +\n        `with extensions: ${this.extensions.join(', ')}`\n    );\n  }\n}\n"],"mappings":"8FAYA,IAAa,EAAb,KAA2D,CACzD,MACA,WACA,OACA,OAAwC,EAAE,CAE1C,YAAY,EAAoB,EAAiB,EAAuB,CAAC,QAAS,iBAAiB,CAAE,CACnG,KAAK,OAAS,EACd,KAAK,MAAQ,EACb,KAAK,WAAa,EAOpB,KAAK,EAAc,EAA4B,EAAE,CAAQ,CACvD,IAAM,EAAO,KAAK,SAAS,EAAK,CAC1B,EAAa,CAAE,GAAG,KAAK,OAAQ,GAAG,EAAM,CAC9C,OAAO,IAAI,EAAK,KAAK,OAAQ,EAAM,EAAM,EAAW,CAOtD,OAAO,EAAuB,CAC5B,GAAI,CAEF,OADA,KAAK,SAAS,EAAK,CACZ,QACD,CACN,MAAO,IAQX,MAAM,EAAmC,EAAmB,CACtD,OAAO,GAAQ,SACjB,KAAK,OAAO,GAAO,EAEnB,OAAO,OAAO,KAAK,OAAQ,EAAI,CAQnC,YAAY,EAAoB,CAC9B,KAAK,MAAM,KAAK,EAAK,CAMvB,UAAqB,CACnB,OAAO,KAAK,MAMd,WAAiC,CAC/B,OAAO,KAAK,OAad,SAAS,EAAsB,CAE7B,IAAM,EAAe,EAAK,QAAQ,MAAO,IAAI,CAE7C,IAAK,IAAM,KAAY,KAAK,MAC1B,IAAK,IAAM,KAAO,KAAK,WAAY,CACjC,IAAM,EAAW,EAAK,EAAU,EAAe,EAAI,CACnD,GAAI,EAAW,EAAS,CACtB,OAAO,EAKb,MAAU,MACR,SAAS,EAAK,4BAA4B,KAAK,MAAM,KAAK,KAAK,CAAC,oBAC1C,KAAK,WAAW,KAAK,KAAK,GACjD"}

package/dist/View/ViewServiceProvider.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../Foundation/ServiceProvider.cjs`),t=require(`./Engines/TemplateEngine.cjs`),n=require(`./ViewFactory.cjs`);let r=require(`path`);var i=class extends e.ServiceProvider{register(){this.app.singleton(`view`,()=>{let e=this.getConfig(),r=new t.TemplateEngine,i=new n.ViewFactory(r,e.paths,e.extensions);return r.setResolver(i),i})}getConfig(){let e=this.app.getBasePath();try{let t=this.app.make(`config`),n=t?.items?.view||t?.get?.(`view`);if(n)return{paths:n.paths??[(0,r.join)(e,`resources/views`)],extensions:n.extensions??[`.html`,`.orchestr.html`]}}catch{}return{paths:[(0,r.join)(e,`resources/views`)],extensions:[`.html`,`.orchestr.html`]}}};exports.ViewServiceProvider=i;

package/dist/View/ViewServiceProvider.d.cts

@@ -0,0 +1,28 @@
+import { ServiceProvider } from "../Foundation/ServiceProvider.cjs";
+
+//#region src/View/ViewServiceProvider.d.ts
+interface ViewConfig {
+  /**
+   * Paths to search for view files.
+   * Defaults to [{basePath}/resources/views]
+   */
+  paths?: string[];
+  /**
+   * File extensions to try, in order.
+   * Defaults to ['.html', '.orchestr.html']
+   */
+  extensions?: string[];
+}
+declare class ViewServiceProvider extends ServiceProvider {
+  /**
+   * Register view services
+   */
+  register(): void;
+  /**
+   * Get the view configuration
+   */
+  protected getConfig(): Required<ViewConfig>;
+}
+//#endregion
+export { ViewConfig, ViewServiceProvider };
+//# sourceMappingURL=ViewServiceProvider.d.cts.map

package/dist/View/ViewServiceProvider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewServiceProvider.d.cts","names":[],"sources":["../../src/View/ViewServiceProvider.ts"],"mappings":";;;UAYiB,UAAA;EAcJ;;;;EATX,KAAA;EASuC;;;;EAHvC,UAAA;AAAA;AAAA,cAGW,mBAAA,SAA4B,eAAA;EAqBP;;;EAjBhC,QAAA,CAAA;;;;YAiBU,SAAA,CAAA,GAAa,QAAA,CAAS,UAAA;AAAA"}

package/dist/View/ViewServiceProvider.d.mts

@@ -0,0 +1,28 @@
+import { ServiceProvider } from "../Foundation/ServiceProvider.mjs";
+
+//#region src/View/ViewServiceProvider.d.ts
+interface ViewConfig {
+  /**
+   * Paths to search for view files.
+   * Defaults to [{basePath}/resources/views]
+   */
+  paths?: string[];
+  /**
+   * File extensions to try, in order.
+   * Defaults to ['.html', '.orchestr.html']
+   */
+  extensions?: string[];
+}
+declare class ViewServiceProvider extends ServiceProvider {
+  /**
+   * Register view services
+   */
+  register(): void;
+  /**
+   * Get the view configuration
+   */
+  protected getConfig(): Required<ViewConfig>;
+}
+//#endregion
+export { ViewConfig, ViewServiceProvider };
+//# sourceMappingURL=ViewServiceProvider.d.mts.map

package/dist/View/ViewServiceProvider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewServiceProvider.d.mts","names":[],"sources":["../../src/View/ViewServiceProvider.ts"],"mappings":";;;UAYiB,UAAA;EAcJ;;;;EATX,KAAA;EASuC;;;;EAHvC,UAAA;AAAA;AAAA,cAGW,mBAAA,SAA4B,eAAA;EAqBP;;;EAjBhC,QAAA,CAAA;;;;YAiBU,SAAA,CAAA,GAAa,QAAA,CAAS,UAAA;AAAA"}

package/dist/View/ViewServiceProvider.mjs

@@ -0,0 +1,2 @@
+import{ServiceProvider as e}from"../Foundation/ServiceProvider.mjs";import{TemplateEngine as t}from"./Engines/TemplateEngine.mjs";import{ViewFactory as n}from"./ViewFactory.mjs";import{join as r}from"path";var i=class extends e{register(){this.app.singleton(`view`,()=>{let e=this.getConfig(),r=new t,i=new n(r,e.paths,e.extensions);return r.setResolver(i),i})}getConfig(){let e=this.app.getBasePath();try{let t=this.app.make(`config`),n=t?.items?.view||t?.get?.(`view`);if(n)return{paths:n.paths??[r(e,`resources/views`)],extensions:n.extensions??[`.html`,`.orchestr.html`]}}catch{}return{paths:[r(e,`resources/views`)],extensions:[`.html`,`.orchestr.html`]}}};export{i as ViewServiceProvider};
+//# sourceMappingURL=ViewServiceProvider.mjs.map

package/dist/View/ViewServiceProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewServiceProvider.mjs","names":[],"sources":["../../src/View/ViewServiceProvider.ts"],"sourcesContent":["/**\n * ViewServiceProvider\n *\n * Registers view services into the container.\n * Mirrors Laravel's Illuminate\\View\\ViewServiceProvider\n */\n\nimport { join } from 'path';\nimport { ServiceProvider } from '@/Foundation/ServiceProvider';\nimport { TemplateEngine } from './Engines/TemplateEngine';\nimport { ViewFactory } from './ViewFactory';\n\nexport interface ViewConfig {\n  /**\n   * Paths to search for view files.\n   * Defaults to [{basePath}/resources/views]\n   */\n  paths?: string[];\n\n  /**\n   * File extensions to try, in order.\n   * Defaults to ['.html', '.orchestr.html']\n   */\n  extensions?: string[];\n}\n\nexport class ViewServiceProvider extends ServiceProvider {\n  /**\n   * Register view services\n   */\n  register(): void {\n    this.app.singleton('view', () => {\n      const config = this.getConfig();\n\n      const engine = new TemplateEngine();\n      const factory = new ViewFactory(engine, config.paths, config.extensions);\n\n      // Wire the engine back to the factory so @include / @extends work\n      engine.setResolver(factory);\n\n      return factory;\n    });\n  }\n\n  /**\n   * Get the view configuration\n   */\n  protected getConfig(): Required<ViewConfig> {\n    const basePath = this.app.getBasePath();\n\n    try {\n      const configService = this.app.make('config') as any;\n      const viewConfig = configService?.items?.view || configService?.get?.('view');\n\n      if (viewConfig) {\n        return {\n          paths: viewConfig.paths ?? [join(basePath, 'resources/views')],\n          extensions: viewConfig.extensions ?? ['.html', '.orchestr.html'],\n        };\n      }\n    } catch {\n      // Config service not available yet\n    }\n\n    return {\n      paths: [join(basePath, 'resources/views')],\n      extensions: ['.html', '.orchestr.html'],\n    };\n  }\n}\n"],"mappings":"8MA0BA,IAAa,EAAb,cAAyC,CAAgB,CAIvD,UAAiB,CACf,KAAK,IAAI,UAAU,WAAc,CAC/B,IAAM,EAAS,KAAK,WAAW,CAEzB,EAAS,IAAI,EACb,EAAU,IAAI,EAAY,EAAQ,EAAO,MAAO,EAAO,WAAW,CAKxE,OAFA,EAAO,YAAY,EAAQ,CAEpB,GACP,CAMJ,WAA4C,CAC1C,IAAM,EAAW,KAAK,IAAI,aAAa,CAEvC,GAAI,CACF,IAAM,EAAgB,KAAK,IAAI,KAAK,SAAS,CACvC,EAAa,GAAe,OAAO,MAAQ,GAAe,MAAM,OAAO,CAE7E,GAAI,EACF,MAAO,CACL,MAAO,EAAW,OAAS,CAAC,EAAK,EAAU,kBAAkB,CAAC,CAC9D,WAAY,EAAW,YAAc,CAAC,QAAS,iBAAiB,CACjE,MAEG,EAIR,MAAO,CACL,MAAO,CAAC,EAAK,EAAU,kBAAkB,CAAC,CAC1C,WAAY,CAAC,QAAS,iBAAiB,CACxC"}

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(e&&(t=e(e=0)),t),s=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r},c=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},l=(n,r,a)=>(a=n==null?{}:e(i(n)),c(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),u=e=>a.call(e,`module.exports`)?e[`module.exports`]:c(t({},`__esModule`,{value:!0}),e);exports.__esmMin=o,exports.__exportAll=s,exports.__toCommonJS=u,exports.__toESM=l;

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1 @@
+import{createRequire as e}from"node:module";var t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,a=(e,t)=>()=>(e&&(t=e(e=0)),t),o=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r},s=(e,a,o,s)=>{if(a&&typeof a==`object`||typeof a==`function`)for(var c=r(a),l=0,u=c.length,d;l<u;l++)d=c[l],!i.call(e,d)&&d!==o&&t(e,d,{get:(e=>a[e]).bind(null,d),enumerable:!(s=n(a,d))||s.enumerable});return e},c=e=>i.call(e,`module.exports`)?e[`module.exports`]:s(t({},`__esModule`,{value:!0}),e),l=e(import.meta.url);export{a as __esmMin,o as __exportAll,l as __require,c as __toCommonJS};