Release version 1.18.3

Author: ddebowczyk

config/docs.yaml

@@ -0,0 +1,50 @@
+# Documentation Configuration
+# This file configures the documentation generation system
+
+# Main docs section - manually curated landing pages
+main:
+  title: 'Instructor for PHP'
+  source: './docs'
+  # Files to include in the Main section (relative to source)
+  # These are the top-level conceptual docs, not package-specific
+  pages:
+    - index.md
+
+# Packages - autodiscovered from ./packages/*/docs/
+packages:
+  source_pattern: './packages/*/docs'
+  # Package descriptions (fallback to composer.json if not specified)
+  descriptions:
+    instructor: 'Core structured output extraction library'
+    polyglot: 'Unified LLM API abstraction layer'
+    http-client: 'Framework-agnostic HTTP client'
+    laravel: 'Laravel integration for Instructor'
+  # Target directory names in output (defaults to package name)
+  target_dirs:
+    http-client: 'http'
+  # Display order (packages not listed here appear alphabetically after)
+  order:
+    - instructor
+    - polyglot
+    - http-client
+    - laravel
+
+# Examples / Cookbook
+examples:
+  source: './examples'
+  intro_pages:
+    - cookbook/introduction.md
+    - cookbook/contributing.md
+
+# Release notes / Changelog
+changelog:
+  source: './docs/release-notes'
+
+# Output targets
+output:
+  mintlify:
+    target: './docs-build'
+    source_index: './docs/mint.json'
+  mkdocs:
+    target: './docs-mkdocs'
+    template: './docs/mkdocs.yml.template'

docs-build/cookbook/instructor/advanced/config_providers.mdx

@@ -12,7 +12,7 @@ Laravel).
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Adbar\Dot;

docs-build/cookbook/instructor/advanced/context_cache_structured.mdx

@@ -27,7 +27,7 @@ Let's start by defining the data model for the project details and the propertie
 that we want to extract or generate based on README file.
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Instructor\StructuredOutput;
@@ -59,7 +59,7 @@ We read the content of the README.md file and cache the context, so it can be re
 multiple requests.
 
 ```php
-<?php
+\<\?php
 $content = file_get_contents(__DIR__ . '/../../../README.md');
 
 $cached = (new StructuredOutput)->using('anthropic')->withCachedContext(
@@ -75,7 +75,7 @@ details from the README.md file into the `Project` data model.
 Let's start by asking the user to describe the project for a specific audience: P&C insurance CIOs.
 
 ```php
-<?php
+\<\?php
 // get StructuredOutputResponse object to get access to usage and other metadata
 $response1 = $cached->with(
     messages: 'Describe the project in a way compelling to my audience: P&C insurance CIOs.',
@@ -102,7 +102,7 @@ Anthropic API will use the context cached in the previous request to provide the
 which results in faster processing and lower costs.
 
 ```php
-<?php
+\<\?php
 // get StructuredOutputResponse object to get access to usage and other metadata
 $response2 = $cached->with(
     messages: "Describe the project in a way compelling to my audience: boutique CMS consulting company owner.",

docs-build/cookbook/instructor/advanced/context_cache_structured_oai.mdx

@@ -25,7 +25,7 @@ Let's start by defining the data model for the project details and the propertie
 that we want to extract or generate based on README file.
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Instructor\StructuredOutput;
@@ -57,7 +57,7 @@ We read the content of the README.md file and cache the context, so it can be re
 multiple requests.
 
 ```php
-<?php
+\<\?php
 $content = file_get_contents(__DIR__ . '/../../../README.md');
 
 $cached = (new StructuredOutput)->using('openai')->withCachedContext(
@@ -73,7 +73,7 @@ details from the README.md file into the `Project` data model.
 Let's start by asking the user to describe the project for a specific audience: P&C insurance CIOs.
 
 ```php
-<?php
+\<\?php
 // get StructuredOutputResponse object to get access to usage and other metadata
 $response1 = $cached->with(
     messages: 'Describe the project in a way compelling to my audience: P&C insurance CIOs.',
@@ -100,7 +100,7 @@ OpenAI API can reuse the cached prefix from the previous request to provide the
 which results in faster processing and lower costs when prompt caching applies.
 
 ```php
-<?php
+\<\?php
 // get StructuredOutputResponse object to get access to usage and other metadata
 $response2 = $cached->with(
     messages: "Describe the project in a way compelling to my audience: boutique CMS consulting company owner.",

docs-build/cookbook/instructor/advanced/custom_config.mdx

@@ -12,7 +12,7 @@ other LLMs which support OpenAI API.
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Config\Env;

docs-build/cookbook/instructor/advanced/custom_http_client.mdx

@@ -8,7 +8,7 @@ docname: 'custom_http_client'
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Events\Dispatchers\SymfonyEventDispatcher;

docs-build/cookbook/instructor/advanced/custom_http_client_laravel.mdx

@@ -8,7 +8,7 @@ docname: 'custom_http_client_laravel'
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Instructor\StructuredOutput;

docs-build/cookbook/instructor/advanced/custom_llm_with_dsn.mdx

@@ -12,7 +12,7 @@ CLI arguments or environment variables.
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Instructor\StructuredOutput;

docs-build/cookbook/instructor/advanced/custom_prompts.mdx

@@ -15,7 +15,7 @@ customize how LLM is instructed to process the input.
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Http\Events\HttpRequestSent;

docs-build/cookbook/instructor/advanced/demonstrations.mdx

@@ -15,7 +15,7 @@ is expected to be a JSON object.
 ## Example
 
 ```php
-<?php
+\<\?php
 require 'examples/boot.php';
 
 use Cognesy\Http\Events\HttpRequestSent;