chore(website): make extensions a top level section

src/documentBuilder/InferResult/OutputObject.ts

@@ -1,45 +1,40 @@
 import type { Simplify } from 'type-fest'
-import { type StringKeyof } from '../../lib/prelude.js'
+import type { StringKeyof } from '../../lib/prelude.js'
 import type { TSErrorDescriptive } from '../../lib/ts-error.js'
 import type { Schema } from '../../types/Schema/__.js'
 import type { Select } from '../Select/__.js'
 import type { Alias } from './Alias.js'
 import type { OutputField } from './OutputField.js'
 import type { ScalarsWildcard } from './ScalarsWildcard.js'
 
-// dprint-ignore
 export type Object<$SelectionSet, $Schema extends Schema, $Node extends Schema.OutputObject> =
   Select.SelectScalarsWildcard.IsSelectScalarsWildcard<$SelectionSet> extends true
     // todo what about when scalars wildcard is combined with other fields like relations?
-    ? ScalarsWildcard<$SelectionSet, $Schema,$Node>
-    :
-      Simplify<
-        & SelectionNonSelectAlias<$SelectionSet, $Schema, $Node>
-        & Alias<$Schema, $Node, $SelectionSet>
-      >
+    ? ScalarsWildcard<$SelectionSet, $Schema, $Node>
+    : Simplify<
+      & SelectionNonSelectAlias<$SelectionSet, $Schema, $Node>
+      & Alias<$Schema, $Node, $SelectionSet>
+    >
 
-// dprint-ignore
-type SelectionNonSelectAlias<$SelectionSet , $Schema extends Schema, $SchemaNode extends Schema.OutputObject> =
-  {
-    [$Key in PickSelectsPositiveIndicatorAndNotSelectAlias<$SelectionSet>]:
-      $Key extends keyof $SchemaNode['fields']
-        ? OutputField<$SelectionSet[$Key], $SchemaNode['fields'][$Key], $Schema>
-        : Errors.UnknownFieldName<$Key, $SchemaNode>
-  }
+type SelectionNonSelectAlias<$SelectionSet, $Schema extends Schema, $Node extends Schema.OutputObject> = {
+  [$Key in PickSelectsPositiveIndicatorAndNotSelectAlias<$SelectionSet>]: $Key extends keyof $Node['fields']
+    ? OutputField<$SelectionSet[$Key], $Node['fields'][$Key], $Schema>
+    : Errors.UnknownFieldName<$Key, $Node>
+}
 
-// dprint-ignore
 export namespace Errors {
-  export type UnknownFieldName<$FieldName extends string, $Object extends Schema.StandardTypes.RootType | Schema.OutputObject> =
-    TSErrorDescriptive<'Object', `field "${$FieldName}" does not exist on object "${$Object['name']}"`>
+  export type UnknownFieldName<
+    $FieldName extends string,
+    $Object extends Schema.StandardTypes.RootType | Schema.OutputObject,
+  > = TSErrorDescriptive<'Object', `field "${$FieldName}" does not exist on object "${$Object['name']}"`>
 }
 
-// dprint-ignore
-export type PickSelectsPositiveIndicatorAndNotSelectAlias<$SelectionSet> = StringKeyof<{
-  [
-    $FieldName in keyof $SelectionSet as $SelectionSet[$FieldName] extends Select.Indicator.Negative
-      ? never
-      : $SelectionSet[$FieldName] extends any[]
-      ? never
-       : $FieldName
-  ]: 0
-}>
+export type PickSelectsPositiveIndicatorAndNotSelectAlias<$SelectionSet> = StringKeyof<
+  {
+    [
+      $FieldName in keyof $SelectionSet as $SelectionSet[$FieldName] extends Select.Indicator.Negative ? never
+        : $SelectionSet[$FieldName] extends any[] ? never
+        : $FieldName
+    ]: 0
+  }
+>

website/.vitepress/config.ts

@@ -48,6 +48,17 @@ const sidebars = fixLinks(generateSidebar([
     useTitleFromFileHeading: true,
     keepMarkdownSyntaxFromTitle: true,
   },
+  {
+    hyphenToSpace: true,
+    capitalizeEachWords: true,
+    scanStartPath: 'content/extensions',
+    resolvePath: '/extensions/',
+    prefixSeparator: '_',
+    removePrefixAfterOrdering: true,
+    useTitleFromFrontmatter: true,
+    useTitleFromFileHeading: true,
+    keepMarkdownSyntaxFromTitle: true,
+  },
 ]) as SidebarMulti)
 
 sidebars['/examples/'].items.find(_ => _.text === 'About')!.items!.unshift({ text: 'Introduction', link: '/' })
@@ -128,6 +139,7 @@ export default defineConfig({
     nav: [
       { text: 'Guides', link: '/guides' },
       { text: 'Examples', link: '/examples' },
+      { text: 'Extensions', link: '/extensions' },
     ],
     sidebar: {
       ...sidebars,

website/content/extensions/index.md

@@ -0,0 +1,5 @@
+# Extensions
+
+Welcome to Graffle's collection of extensions.
+
+TODO

website/content/extensions/introspection.md

@@ -0,0 +1 @@
+<!--@include: @../../src/extensions/Introspection/documentation.md-->

website/content/extensions/opentelemetry.md

@@ -0,0 +1 @@
+<!--@include: @/../../src/extensions/Opentelemetry/documentation.md-->

website/content/extensions/schema-errors.md

@@ -0,0 +1 @@
+<!--@include: @/../../src/extensions/schemaErrors/documentation.md-->

website/content/extensions/throws.md

@@ -0,0 +1 @@
+<!--@include: @/../../src/extensions/Throws/documentation.md-->

website/content/extensions/upload.md

@@ -0,0 +1,3 @@
+<!--@include: @/../../src/extensions/Upload/documentation.md-->
+
+test

website/content/guides/35_document-builder/10_graphql-feature-mapping.md

@@ -0,0 +1,17 @@
+# GraphQL Feature Mapping
+
+## Aliases
+
+## Arguments
+
+## Custom Scalars
+
+## Directives
+
+## Enums
+
+## Inline Fragments
+
+### Field Groups
+
+### Type Conditions