pyoq-sql 1.0.0__tar.gz → 1.0.2__tar.gz

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/Cargo.lock

@@ -94,7 +94,7 @@ dependencies = [
 
 [[package]]
 name = "pyoq-native"
-version = "1.0.0"
+version = "1.0.2"
 dependencies = [
  "pyo3",
 ]

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "pyoq-native"
-version = "1.0.0"
+version = "1.0.2"
 edition = "2024"
 description = "Native runtime for the PyOQ SQL toolkit"
 license = "MPL-2.0"

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.5
 Name: pyoq-sql
-Version: 1.0.0
+Version: 1.0.2
 Summary: A fully typed, database-first SQL toolkit for Python.
+Project-URL: Homepage, https://teqpod.com/pyoq-sql/
+Project-URL: Documentation, https://teqpod.com/pyoq-sql/overview/
+Project-URL: Issues, https://github.com/Teqpod/pyoq-sql/issues
+Project-URL: Security, https://github.com/Teqpod/pyoq-sql/security/advisories/new
 License-Expression: MPL-2.0
 License-File: LICENSE
 Keywords: database,query-builder,sql,typing
@@ -99,6 +103,7 @@ flowchart TD
     Package --> Query[query]
     Package --> Runtime[runtime]
     Package --> Schema[schema]
+    Package --> Serving[serving]
     Package --> Errors[errors]
     Package --> Naming[naming]
     Runtime --> Native[private native extension]
@@ -112,8 +117,8 @@ surfaces.
 ## Configuration
 
 Configuration is read from `pyproject.toml`. Generated code always lives in a
-dedicated directory below the project root. Database credentials are referenced
-by environment variable name and are never stored in the configuration file.
+dedicated directory below the project root. Use a complete environment
+reference when a data source name contains credentials.
 
 ```toml
 [tool.pyoq]
@@ -123,32 +128,43 @@ selected-profile = "default"
 
 [tool.pyoq.profiles.default]
 dialect = "postgres"
-dsn-environment = "DATABASE_URL"
+host = "localhost"
+port = 5432
+database = "${POSTGRES_DATABASE}"
+username = "${POSTGRES_USERNAME}"
+password = "${POSTGRES_PASSWORD}"
+minimum-pool-size = 1
+maximum-pool-size = 8
+pool-checkout-timeout = 3.0
 
 [tool.pyoq.profiles.testing]
 dialect = "sqlite"
 database-path = "database/testing.sqlite"
 ```
 
-Load the selected profile through the fully typed configuration API:
+Open the selected profile through the fully typed lifecycle API:
 
 ```python
-from pathlib import Path
+from pyoq import connect
+from application.database.tables import ACCOUNT
 
-from pyoq.config import load_configuration
 
-configuration = load_configuration(Path.cwd())
-profile = configuration.active_profile
-
-if profile.dsn_environment is not None:
-    database_url = profile.dsn_environment.resolve()
-    connect_value = database_url.reveal()
+with connect(profile="default") as database:
+    rows = database.select_from(ACCOUNT).limit(10).fetch_all()
 ```
 
+Omit `profile` to use `selected-profile`. The context creates one process-owned
+pool from the profile limits and closes it on exit. A framework-free
+application can instead pass a data source directly with
+`connect(dsn, dialect=Dialect.MYSQL)`. An explicit `pool_policy` replaces the
+complete profile pool policy for one call.
+
 SQLite file paths use `database-path`. They are resolved relative to the project
 root, must remain inside it, and are opened read-only during inspection. An
-environment reference may be used instead when the database location should be
-supplied by the process environment. A profile cannot define both settings.
+environment reference in the exact `${VARIABLE_NAME}` form may be used for any
+structured server or pool value. Any other string is literal. Server profiles
+may alternatively define one `dsn`, but cannot combine it with structured
+connection fields.
 
 `SecretValue` renders as `[REDACTED]`; access to its underlying value is always
 explicit. An explicit `Configuration` object takes precedence over the file,
@@ -317,7 +333,7 @@ python -m pip install "pyoq-sql[mysql-async]"
 Without them, PostgreSQL and MySQL query construction and compilation still
 work because they are pure Python. Only connecting requires a driver, and its
 absence raises an explicit error naming the extra to install. PostgreSQL and
-MySQL profiles supply their connection string through `dsn-environment`, and
+PostgreSQL and MySQL profiles supply their connection string through `dsn`, and
 inspection opens the connection read-only.
 
 A MySQL connection string names one database, which is reflected as the

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/README.md

@@ -59,6 +59,7 @@ flowchart TD
     Package --> Query[query]
     Package --> Runtime[runtime]
     Package --> Schema[schema]
+    Package --> Serving[serving]
     Package --> Errors[errors]
     Package --> Naming[naming]
     Runtime --> Native[private native extension]
@@ -72,8 +73,8 @@ surfaces.
 ## Configuration
 
 Configuration is read from `pyproject.toml`. Generated code always lives in a
-dedicated directory below the project root. Database credentials are referenced
-by environment variable name and are never stored in the configuration file.
+dedicated directory below the project root. Use a complete environment
+reference when a data source name contains credentials.
 
 ```toml
 [tool.pyoq]
@@ -83,32 +84,43 @@ selected-profile = "default"
 
 [tool.pyoq.profiles.default]
 dialect = "postgres"
-dsn-environment = "DATABASE_URL"
+host = "localhost"
+port = 5432
+database = "${POSTGRES_DATABASE}"
+username = "${POSTGRES_USERNAME}"
+password = "${POSTGRES_PASSWORD}"
+minimum-pool-size = 1
+maximum-pool-size = 8
+pool-checkout-timeout = 3.0
 
 [tool.pyoq.profiles.testing]
 dialect = "sqlite"
 database-path = "database/testing.sqlite"
 ```
 
-Load the selected profile through the fully typed configuration API:
+Open the selected profile through the fully typed lifecycle API:
 
 ```python
-from pathlib import Path
+from pyoq import connect
+from application.database.tables import ACCOUNT
 
-from pyoq.config import load_configuration
 
-configuration = load_configuration(Path.cwd())
-profile = configuration.active_profile
-
-if profile.dsn_environment is not None:
-    database_url = profile.dsn_environment.resolve()
-    connect_value = database_url.reveal()
+with connect(profile="default") as database:
+    rows = database.select_from(ACCOUNT).limit(10).fetch_all()
 ```
 
+Omit `profile` to use `selected-profile`. The context creates one process-owned
+pool from the profile limits and closes it on exit. A framework-free
+application can instead pass a data source directly with
+`connect(dsn, dialect=Dialect.MYSQL)`. An explicit `pool_policy` replaces the
+complete profile pool policy for one call.
+
 SQLite file paths use `database-path`. They are resolved relative to the project
 root, must remain inside it, and are opened read-only during inspection. An
-environment reference may be used instead when the database location should be
-supplied by the process environment. A profile cannot define both settings.
+environment reference in the exact `${VARIABLE_NAME}` form may be used for any
+structured server or pool value. Any other string is literal. Server profiles
+may alternatively define one `dsn`, but cannot combine it with structured
+connection fields.
 
 `SecretValue` renders as `[REDACTED]`; access to its underlying value is always
 explicit. An explicit `Configuration` object takes precedence over the file,
@@ -277,7 +289,7 @@ python -m pip install "pyoq-sql[mysql-async]"
 Without them, PostgreSQL and MySQL query construction and compilation still
 work because they are pure Python. Only connecting requires a driver, and its
 absence raises an explicit error naming the extra to install. PostgreSQL and
-MySQL profiles supply their connection string through `dsn-environment`, and
+PostgreSQL and MySQL profiles supply their connection string through `dsn`, and
 inspection opens the connection read-only.
 
 A MySQL connection string names one database, which is reflected as the

pyoq_sql-1.0.2/docs/web/README.md

@@ -0,0 +1,83 @@
+# PyOQ documentation site
+
+The landing page lives in `src/pages/index.astro`. Documentation is Markdown
+in `src/content/docs`, one file per guide. Its reading order lives in
+`src/nav.ts`, because a reader following the site from the top is walking a
+path somebody chose rather than a directory listing.
+
+## Running it
+
+```bash
+bun install
+bun run dev       # http://localhost:4321, with reload
+bun run build     # static site into dist/, then the search index
+bun run preview   # serve what was built
+bun run check     # types across the Astro components
+```
+
+Search is built by Pagefind from the finished HTML, so `bun run dev` has no
+index and the field says so. Run `bun run build` to search.
+
+## Adding a page
+
+1. Write `src/content/docs/<name>.md` with `title` and `summary` at the top.
+2. Add it to the right group in `src/nav.ts`, with the same title and summary.
+3. Link it from the nearest existing guide so a reader has a reason to find it.
+4. Add checked SQL and Python pairs where rendered SQL is part of the lesson.
+
+A page that exists but is not in the navigation is not built, which is
+deliberate: an unreachable page is worse than a missing one, because nobody
+finds out it went stale.
+
+## Writing a guide
+
+Start with the reader's task and the smallest complete example. Explain
+ownership, failure behavior, and dialect limits beside the feature rather than
+in a distant caveat. Use supported public imports and show bound values outside
+SQL text.
+
+Cross-link concepts instead of copying their full explanation into several
+pages. A page may summarize a related contract, but its authoritative details
+should have one home. Use Mermaid when a process or state transition needs a
+diagram.
+
+The Python suite validates local links, documented imports, and every adjacent
+`sql pair` and Python block. The site check validates components and routes.
+Both are required because either one alone can miss a broken guide.
+
+## Where things are
+
+| Path | Holds |
+| --- | --- |
+| `src/pages/index.astro` | the product landing page |
+| `src/content/docs` | every page, as Markdown |
+| `src/nav.ts` | the order, and which group each page is in |
+| `src/layouts/Doc.astro` | the page shell |
+| `src/layouts/app.css` | the whole design |
+| `src/components` | sidebar, search, on-this-page, prev and next |
+
+## Checking a change
+
+From this directory:
+
+```bash
+bun run check
+bun run build
+```
+
+From the repository root:
+
+```bash
+uv run --no-sync pytest tests/distribution/test_documentation_links.py \
+  tests/distribution/test_documentation_imports.py \
+  tests/distribution/test_documentation_pairs.py
+```
+
+## Deploying
+
+`dist/` is a directory of files. It needs no server of its own, so any static
+host will do. Set `DOCS_BASE` when it is served from a subdirectory:
+
+```bash
+DOCS_BASE=/docs/ bun run build
+```

pyoq_sql-1.0.2/docs/web/astro.config.mjs

@@ -0,0 +1,50 @@
+// @ts-check
+import { unified } from "@astrojs/markdown-remark";
+import { defineConfig } from "astro/config";
+
+import { remarkBase } from "./src/remark-base.mjs";
+import { remarkCodeShell } from "./src/remark-code-shell.mjs";
+import { remarkLicence } from "./src/remark-licence.mjs";
+import { remarkMermaid } from "./src/remark-mermaid.mjs";
+import { remarkPairs } from "./src/remark-pairs.mjs";
+
+// The site is a directory of files when it is built, so it works from a
+// bucket, a static host, or a laptop without anything running behind it.
+export default defineConfig({
+  // Both are read from the environment and neither is written down here, so
+  // the build carries no host and no assumption about where it is served.
+  // DOCS_BASE is the path the site is published under; every internal link is
+  // built from it through src/links.ts. Unset means the root, which is what a
+  // local `astro dev` wants.
+  site: process.env.DOCS_SITE,
+  base: process.env.DOCS_BASE ?? "/",
+  build: { format: "directory" },
+  vite: {
+    // The package metadata sits above this directory, and src/project.ts reads
+    // the licence straight out of it.
+    server: { fs: { allow: [".", "../.."] } },
+    build: {
+      rollupOptions: {
+        // Astro names a bundled asset after the specifier that imported it,
+        // and a relative one leaves ".." in the filename. Static servers read
+        // that as a walk out of the directory and refuse to serve it.
+        output: { assetFileNames: "_astro/[name].[hash][extname]" },
+      },
+    },
+  },
+  markdown: {
+    processor: unified({ remarkPlugins: [
+      remarkMermaid,
+      remarkLicence,
+      remarkCodeShell,
+      remarkPairs,
+      remarkBase,
+    ] }),
+    shikiConfig: {
+      // The themes the editor this UI is modelled on renders with, so a
+      // snippet here is coloured exactly as it is there.
+      themes: { light: "light-plus", dark: "dark-plus" },
+      wrap: false,
+    },
+  },
+});

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/docs/web/bun.lock

@@ -7,12 +7,15 @@
       "dependencies": {
         "@astrojs/markdown-remark": "^7.2.4",
         "@fontsource/cascadia-code": "^5.3.0",
+        "@monaco-editor/loader": "^1.7.0",
         "astro": "^7.2.6",
+        "beautiful-mermaid": "^1.1.3",
         "pagefind": "^1.5.2",
       },
       "devDependencies": {
         "@astrojs/check": "^0.9.10",
         "@types/node": "^26.3.0",
+        "monaco-editor": "^0.52.2",
         "typescript": "^6",
       },
     },
@@ -220,6 +223,8 @@
 
     "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
 
+    "@monaco-editor/loader": ["@monaco-editor/loader@1.7.0", "", { "dependencies": { "state-local": "^1.0.6" } }, "sha512-gIwR1HrJrrx+vfyOhYmCZ0/JcWqG5kbfG7+d3f/C1LXk2EvzAbHSg3MQ5lO2sMlo9izoAZ04shohfKLVT6crVA=="],
+
     "@napi-rs/wasm-runtime": ["@napi-rs/wasm-runtime@1.2.3", "", { "dependencies": { "@tybys/wasm-util": "^0.10.3" }, "peerDependencies": { "@emnapi/core": "^1.7.1 || ^2.0.0-alpha.4", "@emnapi/runtime": "^1.7.1 || ^2.0.0-alpha.4" } }, "sha512-UMduMbqO5s5zF2NkNacMT/yK5Y5QiKvWr2+50bzIIxFDwVJ2h49b+oyjaCGPhJxd2/gC2x39EHv/gHVuu36x2Q=="],
 
     "@oslojs/encoding": ["@oslojs/encoding@1.1.0", "", {}, "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ=="],
@@ -352,6 +357,8 @@
 
     "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],
 
+    "beautiful-mermaid": ["beautiful-mermaid@1.1.3", "", { "dependencies": { "elkjs": "^0.11.0", "entities": "^7.0.1" } }, "sha512-TItrtrAyHp1vwFfFVYauWGrquouk/6SS21Aq3RsxindSYZODcN4xYrPZD6BiZRU+o5mKJzDPz9MUSMvELdylyg=="],
+
     "boolbase": ["boolbase@1.0.0", "", {}, "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww=="],
 
     "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="],
@@ -424,11 +431,13 @@
 
     "dset": ["dset@3.1.4", "", {}, "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA=="],
 
+    "elkjs": ["elkjs@0.11.1", "", {}, "sha512-zxxR9k+rx5ktMwT/FwyLdPCrq7xN6e4VGGHH8hA01vVYKjTFik7nHOxBnAYtrgYUB1RpAiLvA1/U2YraWxyKKg=="],
+
     "emmet": ["emmet@2.4.11", "", { "dependencies": { "@emmetio/abbreviation": "^2.3.3", "@emmetio/css-abbreviation": "^2.1.8" } }, "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ=="],
 
     "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
 
-    "entities": ["entities@6.0.1", "", {}, "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g=="],
+    "entities": ["entities@7.0.1", "", {}, "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA=="],
 
     "es-module-lexer": ["es-module-lexer@2.3.2", "", {}, "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw=="],
 
@@ -636,6 +645,8 @@
 
     "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="],
 
+    "monaco-editor": ["monaco-editor@0.52.2", "", {}, "sha512-GEQWEZmfkOGLdd3XK8ryrfWz3AIP8YymVXiPHEdewrUq7mh0qrKrfHLNCXcbB6sTnMLnOZ3ztSiKcciFUkIJwQ=="],
+
     "mrmime": ["mrmime@2.0.1", "", {}, "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ=="],
 
     "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
@@ -756,6 +767,8 @@
 
     "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
 
+    "state-local": ["state-local@1.0.7", "", {}, "sha512-HTEHMNieakEnoe33shBYcZ7NX83ACUjCu8c40iOGEZsngj9zRnkqS9j1pqQPXwobB0ZcVTk27REb7COQ0UR59w=="],
+
     "string-width": ["string-width@8.2.2", "", { "dependencies": { "get-east-asian-width": "^1.5.0", "strip-ansi": "^7.1.2" } }, "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg=="],
 
     "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
@@ -898,6 +911,8 @@
 
     "dom-serializer/entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
 
+    "parse5/entities": ["entities@6.0.1", "", {}, "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g=="],
+
     "svgo/commander": ["commander@11.1.0", "", {}, "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ=="],
 
     "unstorage/chokidar": ["chokidar@5.0.0", "", { "dependencies": { "readdirp": "^5.0.0" } }, "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw=="],

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/docs/web/package.json

@@ -2,6 +2,7 @@
   "name": "pyoq-docs",
   "private": true,
   "type": "module",
+  "version": "1.0.2",
   "scripts": {
     "dev": "astro dev",
     "build": "astro build && pagefind --site dist",
@@ -11,12 +12,15 @@
   "dependencies": {
     "@astrojs/markdown-remark": "^7.2.4",
     "@fontsource/cascadia-code": "^5.3.0",
+    "@monaco-editor/loader": "^1.7.0",
     "astro": "^7.2.6",
+    "beautiful-mermaid": "^1.1.3",
     "pagefind": "^1.5.2"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",
     "@types/node": "^26.3.0",
+    "monaco-editor": "^0.52.2",
     "typescript": "^6"
   }
 }

pyoq_sql-1.0.2/docs/web/public/brand/pyoq-banner.svg

@@ -0,0 +1,51 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="banner-title">
+  <title id="banner-title">PyOQ, fully typed database-first SQL for Python</title>
+  <defs>
+    <linearGradient id="ground" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0c1220" />
+      <stop offset="1" stop-color="#131c2f" />
+    </linearGradient>
+    <radialGradient id="glow" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#1b6ef3" stop-opacity="0.42" />
+      <stop offset="0.55" stop-color="#1b6ef3" stop-opacity="0.13" />
+      <stop offset="1" stop-color="#1b6ef3" stop-opacity="0" />
+    </radialGradient>
+    <linearGradient id="rule" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#1b6ef3" />
+      <stop offset="1" stop-color="#1b6ef3" stop-opacity="0" />
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="630" fill="url(#ground)" />
+  <circle cx="1046" cy="118" r="392" fill="url(#glow)" />
+  <rect x="0" y="0" width="1200" height="6" fill="url(#rule)" />
+
+  <g transform="translate(96 128) scale(1.75)">
+    <rect x="2" y="2" width="60" height="60" rx="14" fill="#1b6ef3" />
+    <g fill="none" stroke="#fff" stroke-linecap="round" stroke-linejoin="round" stroke-width="7">
+      <path d="M18 49V16h17" />
+      <circle cx="35" cy="31" r="15" />
+      <path d="m45 42 7 7" />
+    </g>
+    <g fill="#fff">
+      <rect x="28" y="24" width="5" height="5" rx="1" />
+      <rect x="36" y="24" width="5" height="5" rx="1" />
+      <rect x="28" y="32" width="5" height="5" rx="1" />
+      <rect x="36" y="32" width="5" height="5" rx="1" />
+    </g>
+  </g>
+
+  <text x="232" y="196" font-family="Helvetica Neue, Helvetica, Arial, sans-serif" font-size="92" font-weight="700" fill="#ffffff" letter-spacing="-2">PyOQ</text>
+  <text x="236" y="238" font-family="Menlo, Consolas, monospace" font-size="21" fill="#7c9bd6" letter-spacing="3">PIP INSTALL PYOQ-SQL</text>
+
+  <text x="96" y="352" font-family="Helvetica Neue, Helvetica, Arial, sans-serif" font-size="52" font-weight="600" fill="#eef2f9" letter-spacing="-1">Fully typed, database-first SQL</text>
+  <text x="96" y="416" font-family="Helvetica Neue, Helvetica, Arial, sans-serif" font-size="52" font-weight="600" fill="#eef2f9" letter-spacing="-1">for Python.</text>
+
+  <rect x="96" y="470" width="1008" height="1" fill="#26324a" />
+
+  <text x="96" y="533" font-family="Menlo, Consolas, monospace" font-size="25" fill="#7f8ba3"
+    >dsl.<tspan fill="#6fb0ff">select</tspan>(TITLES.NAME).<tspan fill="#6fb0ff">from_</tspan>(TITLES)</text>
+
+  <text x="96" y="586" font-family="Helvetica Neue, Helvetica, Arial, sans-serif" font-size="23" fill="#5f6f8c"
+    >Generated types<tspan dx="20" fill="#3d4a63">·</tspan><tspan dx="20">Explicit execution</tspan><tspan dx="20" fill="#3d4a63">·</tspan><tspan dx="20">Native acceleration</tspan></text>
+</svg>

pyoq_sql-1.0.2/docs/web/public/brand/pyoq-mark.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title">
+  <title id="title">PyOQ</title>
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="#1b6ef3" />
+  <g fill="none" stroke="#fff" stroke-linecap="round" stroke-linejoin="round" stroke-width="7">
+    <path d="M18 49V16h17" />
+    <circle cx="35" cy="31" r="15" />
+    <path d="m45 42 7 7" />
+  </g>
+  <g fill="#fff">
+    <rect x="28" y="24" width="5" height="5" rx="1" />
+    <rect x="36" y="24" width="5" height="5" rx="1" />
+    <rect x="28" y="32" width="5" height="5" rx="1" />
+    <rect x="36" y="32" width="5" height="5" rx="1" />
+  </g>
+</svg>

pyoq_sql-1.0.2/docs/web/src/code-head.mjs

@@ -0,0 +1,49 @@
+/**
+ * The bar above a code block, written once.
+ *
+ * A snippet is labelled the same way whether it stands alone or sits beside
+ * the SQL it compiles to, so both the plugin that wraps a lone fence and the
+ * one that pairs two of them build their head from here.
+ */
+const LABELS = {
+  bash: "Shell",
+  console: "Console",
+  json: "JSON",
+  python: "Python",
+  sql: "SQL",
+  text: "Text",
+  toml: "Configuration",
+  yaml: "YAML",
+};
+
+const COPY_ICON =
+  '<svg class="i-copy" viewBox="0 0 16 16" aria-hidden="true"><rect x="5.6" y="5.6" width="7.9" height="7.9" rx="1.6" fill="none" stroke="currentColor" stroke-width="1.3"/><path d="M10.4 5.6V4.1A1.6 1.6 0 0 0 8.8 2.5H4.1A1.6 1.6 0 0 0 2.5 4.1v4.7a1.6 1.6 0 0 0 1.6 1.6h1.5" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>';
+
+const DONE_ICON =
+  '<svg class="i-done" viewBox="0 0 16 16" aria-hidden="true"><path d="m3.5 8.4 3 3 6-6.4" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/></svg>';
+
+/** Languages that are a session at a prompt rather than a file of code. */
+const TERMINALS = new Set(["bash", "sh", "shell", "zsh", "console"]);
+
+export function isTerminal(language) {
+  return TERMINALS.has((language ?? "").toLowerCase());
+}
+
+export function label(language) {
+  if (isTerminal(language)) return "Terminal";
+  if (!language) return "Text";
+  return LABELS[language] ?? language.toUpperCase();
+}
+
+export function codeHead(language) {
+  const named = label(language);
+  return (
+    '<div class="code-head">' +
+    `<span class="code-lang">${named}</span>` +
+    `<button class="code-copy" type="button" data-copy aria-label="Copy ${named} code">` +
+    COPY_ICON +
+    DONE_ICON +
+    "<span data-copy-label>Copy</span></button>" +
+    "</div>"
+  );
+}

pyoq_sql-1.0.2/docs/web/src/components/AppearanceToggle.astro

@@ -0,0 +1,19 @@
+<button id="appearance" type="button" aria-label="Switch appearance">
+  <svg viewBox="0 0 20 20" width="16" height="16" aria-hidden="true">
+    <path
+      fill="currentColor"
+      d="M10 2a8 8 0 1 0 0 16 8 8 0 0 0 0-16Zm0 1.6V16.4a6.4 6.4 0 0 1 0-12.8Z"
+    ></path>
+  </svg>
+</button>
+
+<script>
+  const root = document.documentElement;
+  document.getElementById("appearance")?.addEventListener("click", () => {
+    const next = root.dataset.appearance === "dark" ? "light" : "dark";
+    root.dataset.appearance = next;
+    try {
+      localStorage.setItem("pyoq-appearance", next);
+    } catch {}
+  });
+</script>

{pyoq_sql-1.0.0 → pyoq_sql-1.0.2}/docs/web/src/components/Assumed.astro

@@ -2,7 +2,7 @@
 // What every example on a page takes as already there. Written once, shown
 // on the pages that rely on it, so no example begins with a name the reader
 // has not met.
-const base = import.meta.env.BASE_URL;
+import { linkTo } from "../links";
 ---
 
 <aside class="assumed">
@@ -18,7 +18,7 @@ const base = import.meta.env.BASE_URL;
     </li>
   </ul>
   <p>
-    <a href={`${base}first-query/`.replace(/\/\/+/g, "/")}
+    <a href={linkTo("first-query/")}
       >Your first query</a
     > builds all three from nothing.
   </p>

pyoq_sql-1.0.2/docs/web/src/components/Brand.astro

@@ -0,0 +1,27 @@
+---
+interface Props {
+  variant: "landing" | "documentation";
+}
+
+import { linkTo } from "../links";
+
+const { variant } = Astro.props;
+
+const documentation = variant === "documentation";
+---
+
+<a
+  class={documentation ? "wordmark" : "landing-wordmark"}
+  href={linkTo()}
+  aria-label={documentation ? "PyOQ documentation home" : "PyOQ home"}
+>
+  <img
+    class="brand-image"
+    src={linkTo("brand/pyoq-mark.svg")}
+    width="30"
+    height="30"
+    alt=""
+  />
+  <span class="brand-name">PyOQ</span>
+  {documentation && <span class="brand-context">docs</span>}
+</a>