polen 0.11.0-next.24 → 0.11.0-next.26

package/src/template/routes/reference.tsx

@@ -7,20 +7,28 @@ import { Lifecycles } from '#lib/lifecycles/$'
 import { route, useLoaderData } from '#lib/react-router-effect/react-router-effect'
 import { Schema } from '#lib/schema/$'
 import { Version } from '#lib/version/$'
+import { SegmentedControl, Text } from '@radix-ui/themes'
 import { Flex } from '@radix-ui/themes'
+import { Str } from '@wollybeard/kit'
 import { neverCase } from '@wollybeard/kit/language'
 import { HashMap, Option } from 'effect'
 import { Effect, Match } from 'effect'
 import React from 'react'
-import { useParams } from 'react-router'
+import { redirect, useParams } from 'react-router'
+import { templateConfig } from 'virtual:polen/project/config'
+import { IndexComponent } from 'virtual:polen/project/reference'
 import { schemasCatalog } from 'virtual:polen/project/schemas'
 import { Field } from '../components/Field.js'
 import { TypeKindIcon } from '../components/graphql/graphql.js'
 import { MissingSchema } from '../components/MissingSchema.js'
 import { NamedType } from '../components/NamedType.js'
 import { ReferenceVersionPicker } from '../components/ReferenceVersionPicker.js'
+import { ViewModeToggle } from '../components/ViewModeToggle.js'
 import { GraphqlLifecycleProvider } from '../contexts/GraphqlLifecycleContext.js'
+import { ReferenceConfigProvider } from '../contexts/ReferenceConfigContext.js'
+import { ViewModeProvider } from '../contexts/ViewModeContext.js'
 import { SidebarLayout } from '../layouts/index.js'
+import { MdxProvider } from '../providers/mdx.js'
 
 const routeSchema = S.Struct({
   catalog: Catalog.Catalog,
@@ -28,6 +36,17 @@ const routeSchema = S.Struct({
 })
 
 const referenceLoader = ({ params }: any) => {
+  // Check if reference is enabled
+  if (!templateConfig.reference.enabled) {
+    throw new Response('Reference documentation is disabled', { status: 404 })
+  }
+
+  // Check if no type is selected (index route) and no custom index exists
+  if (!params.type && !params.version && !IndexComponent) {
+    // Redirect to Query type which is guaranteed to exist
+    throw redirect('/reference/Query')
+  }
+
   // This should never be called when schemasCatalog is null
   // because the route won't be added to the router
   // But we return an Effect.fail for safety
@@ -97,7 +116,7 @@ const ReferenceView = () => {
   for (const [title, types] of kindEntries) {
     sidebarItems.push({
       type: `ItemSection` as const,
-      title,
+      title: Str.Case.title(Str.Case.snake(title)),
       pathExp: `reference-${title.toLowerCase()}`,
       isLinkToo: false,
       links: types.map(type => {
@@ -130,7 +149,16 @@ const ReferenceView = () => {
 
   const content: React.ReactNode = (() => {
     if (viewType === 'index') {
-      return <div>Select a type from the sidebar to view its documentation.</div>
+      // Render custom index component if available
+      if (IndexComponent) {
+        return (
+          <MdxProvider schema={schema.definition}>
+            <IndexComponent />
+          </MdxProvider>
+        )
+      }
+      // Fallback message (shouldn't reach here due to redirect)
+      return <Text>Select a type from the sidebar to view its documentation.</Text>
     } else if (viewType === 'type-missing' || viewType === 'field-missing') {
       return <MissingSchema />
     } else if (viewType === 'type') {
@@ -151,26 +179,42 @@ const ReferenceView = () => {
     }
   })()
 
+  const referenceConfig = {
+    descriptionsView: templateConfig.reference.descriptionsView,
+    nullabilityRendering: templateConfig.reference.nullabilityRendering,
+  }
+
   return (
-    <GraphqlLifecycleProvider lifecycle={lifecycle} schema={schema}>
-      <SidebarLayout
-        sidebar={sidebarItems}
-        basePath={basePath}
-        topContent={(() => {
-          const version = Schema.getVersion(schema)
-          return catalog._tag === 'CatalogVersioned' && version
-            ? (
-              <ReferenceVersionPicker
-                data={Catalog.Versioned.getVersions(catalog)}
-                current={version}
-              />
-            )
-            : null
-        })()}
-      >
-        {content}
-      </SidebarLayout>
-    </GraphqlLifecycleProvider>
+    <ReferenceConfigProvider config={referenceConfig}>
+      <ViewModeProvider defaultMode={referenceConfig.descriptionsView.defaultMode}>
+        <GraphqlLifecycleProvider lifecycle={lifecycle} schema={schema}>
+          <SidebarLayout
+            sidebar={sidebarItems}
+            basePath={basePath}
+            topContent={(() => {
+              const version = Schema.getVersion(schema)
+              const versionPicker = catalog._tag === 'CatalogVersioned' && version
+                ? (
+                  <ReferenceVersionPicker
+                    data={Catalog.Versioned.getVersions(catalog)}
+                    current={version}
+                  />
+                )
+                : null
+
+              return (
+                <Flex gap='3' align='center'>
+                  {versionPicker}
+                  {referenceConfig.descriptionsView.showControl && <ViewModeToggle />}
+                </Flex>
+              )
+            })()}
+          >
+            {content}
+          </SidebarLayout>
+        </GraphqlLifecycleProvider>
+      </ViewModeProvider>
+    </ReferenceConfigProvider>
   )
 }
 
@@ -207,7 +251,7 @@ const typeAndFieldRoutes = [
  * - Single ReferenceView component handles all variations
  */
 
-export const reference = !schemasCatalog
+export const reference = !schemasCatalog || !templateConfig.reference.enabled
   ? null
   : route({
     path: `reference`,

package/src/types/virtual-modules.d.ts

@@ -35,6 +35,11 @@ declare module 'virtual:polen/project/examples' {
   export const IndexComponent: React.ComponentType | null
 }
 
+declare module 'virtual:polen/project/reference' {
+  export const referenceCatalog: import('#api/reference/catalog').Catalog
+  export const IndexComponent: React.ComponentType | null
+}
+
 declare module 'virtual:polen/project/config' {
   export const templateConfig: import('#api/config-template/template').TemplateConfig
 }

package/src/vite/plugins/core.ts

@@ -10,6 +10,7 @@ import { Examples } from './examples.js'
 import { Hooks, viProjectHooks } from './hooks.js'
 import { Navbar, viProjectNavbar } from './navbar.js'
 import { Pages, viProjectRoutes } from './pages.js'
+import { Reference, viProjectReference } from './reference.js'
 import { Schemas, viProjectSchema } from './schemas.js'
 
 export interface ProjectRoutesModule {
@@ -44,6 +45,10 @@ export const Core = (config: Api.Config.Config): Vite.PluginOption[] => {
     schemaReader: schemasArea.reader,
     dependentVirtualModules: [viProjectConfig, viProjectNavbar],
   })
+  const referenceArea = Reference({
+    config,
+    dependentVirtualModules: [viProjectConfig, viProjectNavbar],
+  })
   const configPlugin = ConfigPlugin({
     config,
     schemaReader: schemasArea.reader,
@@ -62,6 +67,7 @@ export const Core = (config: Api.Config.Config): Vite.PluginOption[] => {
     ...conditionalPlugins,
     ...examplesArea.plugins,
     ...schemasArea.plugins,
+    ...referenceArea.plugins,
     ...pagesArea.plugins,
     configPlugin,
     navbarPlugin,

package/src/vite/plugins/examples.ts

@@ -83,8 +83,6 @@ export const Examples = ({
   const getControlForDiagnostic = (diagnostic: ExamplesModule.Diagnostic) => {
     if (diagnostic.source === 'examples-scanner') {
       switch (diagnostic.name) {
-        case 'unused-default':
-          return config.examples.diagnostics?.unusedVersions
         case 'duplicate-content':
           return config.examples.diagnostics?.duplicateContent
         case 'missing-versions':
@@ -123,6 +121,8 @@ export const Examples = ({
             || file.endsWith('.gql')
             || file.endsWith('index.md')
             || file.endsWith('index.mdx')
+            || (file.endsWith('.md') && !file.endsWith('index.md'))
+            || (file.endsWith('.mdx') && !file.endsWith('index.mdx'))
           )
         },
       },
@@ -181,6 +181,16 @@ export const Examples = ({
               s`export const IndexComponent = null`
             }
 
+            // Export description components for each example
+            for (const example of scanExamplesResult.catalog.examples) {
+              if (example.description?.path) {
+                s``
+                s`export { default as DescriptionComponent_${
+                  example.name.replace(/-/g, '_')
+                } } from '${example.description.path}'`
+              }
+            }
+
             // Encode the catalog to ensure HashMap and other Effect types are properly serialized
             const encodedCatalog = Catalog.encodeSync(catalogWithIndex)
 

package/src/vite/plugins/index.ts

@@ -4,5 +4,6 @@ export { Core } from './core.js'
 export { Examples } from './examples.js'
 export { Main } from './main.js'
 export { Pages } from './pages.js'
+export { Reference } from './reference.js'
 export { Schemas } from './schemas.js'
 export { Serve } from './serve.js'

package/src/vite/plugins/navbar.ts

@@ -46,7 +46,10 @@ export const Navbar = ({
             >,
           )
 
-          if (loadedSchemaCatalog?.data) {
+          // Check if reference is enabled (explicitly or auto-detected via schema presence)
+          const referenceEnabled = config.reference.enabled ?? Boolean(loadedSchemaCatalog?.data)
+
+          if (referenceEnabled && loadedSchemaCatalog?.data) {
             // IMPORTANT: Always ensure paths start with '/' for React Router compatibility.
             // Without the leading slash, React Router treats paths as relative, which causes
             // hydration mismatches between SSR (where base path is prepended) and client

package/src/vite/plugins/reference.ts

@@ -0,0 +1,130 @@
+import type { Api } from '#api/$'
+import * as ReferenceModule from '#api/reference/$'
+import * as Catalog from '#api/reference/catalog'
+import { Diagnostic } from '#lib/diagnostic/$'
+import { ViteReactive } from '#lib/vite-reactive/$'
+import { type AssetReader, createAssetReader } from '#lib/vite-reactive/reactive-asset-plugin'
+import { ViteVirtual } from '#lib/vite-virtual'
+import { debugPolen } from '#singletons/debug'
+import { FileSystem } from '@effect/platform'
+import * as NodeFileSystem from '@effect/platform-node/NodeFileSystem'
+import { Str } from '@wollybeard/kit'
+import { Effect } from 'effect'
+import type * as Vite from 'vite'
+import { polenVirtual } from '../vi.js'
+
+// Virtual modules provided by this plugin
+export const viProjectReference = polenVirtual([`project`, `reference`])
+
+export interface Options {
+  config: Api.Config.Config
+  dependentVirtualModules?: ViteVirtual.Identifier.Identifier[]
+}
+
+/**
+ * Reference plugin for handling reference documentation
+ */
+export const Reference = ({
+  config,
+  dependentVirtualModules = [],
+}: Options): {
+  plugins: Vite.Plugin[]
+  reader: AssetReader<ReferenceModule.ScanResult, Error, FileSystem.FileSystem>
+} => {
+  const debug = debugPolen.sub(`vite-reference`)
+
+  const reader = createAssetReader<ReferenceModule.ScanResult, Error, FileSystem.FileSystem>(() => {
+    return ReferenceModule.scan({
+      dir: config.paths.project.rootDir,
+    })
+  })
+
+  const scanReference = async () => {
+    return await Effect.runPromise(
+      reader.read().pipe(Effect.provide(NodeFileSystem.layer)),
+    )
+  }
+
+  // Map diagnostic to its control configuration
+  const getControlForDiagnostic = (diagnostic: any) => {
+    return config.reference.diagnostics?.validation
+  }
+
+  // Report diagnostics
+  const reportDiagnostics = (
+    diagnostics: any[],
+    phase: 'dev' | 'build' = 'dev',
+  ) => {
+    Diagnostic.filterAndReport(diagnostics, getControlForDiagnostic, phase)
+  }
+
+  // Check if a file is the reference index file
+  const isReferenceIndexFile = (file: string): boolean => {
+    return file.endsWith('/reference/index.md') || file.endsWith('/reference/index.mdx')
+  }
+
+  const plugins: Vite.Plugin[] = [
+    ViteReactive.ReactiveAssetPlugin<ReferenceModule.ScanResult, Error, FileSystem.FileSystem>({
+      name: 'polen:reference-reactive',
+      reader,
+      filePatterns: {
+        watch: ['reference'],
+        isRelevant: (file: string) => {
+          return isReferenceIndexFile(file)
+        },
+      },
+      dependentVirtualModules: [viProjectReference, ...dependentVirtualModules],
+      hooks: {
+        async shouldFullReload() {
+          // Trigger full reload for reference changes
+          return true
+        },
+        async onDiagnostics(data: any) {
+          // Report diagnostics with DiagnosticControl filtering
+          reportDiagnostics(data.diagnostics, 'dev')
+        },
+      },
+    }),
+    {
+      name: 'polen:reference-virtual',
+      ...ViteVirtual.IdentifiedLoader.toHooks(
+        {
+          identifier: viProjectReference,
+          async loader() {
+            debug(`Loading viProjectReference virtual module`)
+
+            const scanReferenceResult = await scanReference()
+
+            reportDiagnostics(scanReferenceResult.diagnostics, 'dev')
+
+            // Generate the module code with both catalog and component exports
+            const s = Str.Builder()
+            s`import { Effect } from 'effect'`
+            s`import * as Catalog from '#api/reference/catalog'`
+
+            const indexFilePath = scanReferenceResult.catalog.index?.path
+            if (indexFilePath) {
+              s``
+              s`export { default as IndexComponent } from '${indexFilePath}'`
+            } else {
+              s``
+              s`export const IndexComponent = null`
+            }
+
+            // Encode the catalog to ensure proper serialization
+            const encodedCatalog = Catalog.encodeSync(scanReferenceResult.catalog)
+
+            s``
+            s`const catalogData = ${JSON.stringify(encodedCatalog)}`
+            s``
+            s`export const referenceCatalog = Catalog.decodeSync(catalogData)`
+
+            return s.render()
+          },
+        },
+      ),
+    },
+  ]
+
+  return { plugins, reader }
+}

package/src/vite/plugins/schemas.ts

@@ -1,6 +1,8 @@
 import { Api } from '#api/$'
 import { Schema } from '#api/schema/$'
+import type { Diagnostic as AugmentationDiagnostic } from '#api/schema/augmentations/diagnostics/diagnostic'
 import { Catalog } from '#lib/catalog/$'
+import { Diagnostic } from '#lib/diagnostic/$'
 import { ViteReactive } from '#lib/vite-reactive/$'
 import { createAssetReader } from '#lib/vite-reactive/reactive-asset-plugin'
 import { ViteVirtual } from '#lib/vite-virtual/$'
@@ -39,7 +41,40 @@ export const Schemas = ({
   // Self-contained Schema Reader
   // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  const reader = createAssetReader(() => Schema.loadOrNull(config))
+  let lastDiagnostics: AugmentationDiagnostic[] = []
+
+  const reader = createAssetReader(() =>
+    Schema.loadOrNull(config).pipe(
+      Effect.map((result) => {
+        // Store diagnostics for reporting
+        if (result?.diagnostics) {
+          lastDiagnostics = result.diagnostics
+        }
+        return result
+      }),
+    )
+  )
+
+  // Map diagnostic to its control configuration
+  const getControlForDiagnostic = (diagnostic: AugmentationDiagnostic) => {
+    if (diagnostic.source === 'schema-augmentations') {
+      // All augmentation errors are always enabled with error severity
+      return {
+        enabled: true,
+        dev: { severity: 'error' as const },
+        build: { severity: 'error' as const },
+      }
+    }
+    return undefined
+  }
+
+  // Report diagnostics
+  const reportDiagnostics = (
+    diagnostics: AugmentationDiagnostic[],
+    phase: 'dev' | 'build' = 'dev',
+  ) => {
+    Diagnostic.filterAndReport(diagnostics, getControlForDiagnostic, phase)
+  }
 
   // Helper to check if a file is a schema file that should trigger regeneration
   const isSchemaFile = (file: string): boolean => {
@@ -102,7 +137,7 @@ export const Schemas = ({
         // @claude in what case can data be null?
         serializer: (loadedCatalog) =>
           Effect.gen(function*() {
-            if (!loadedCatalog.data) throw new Error('No schema data to serialize')
+            if (!loadedCatalog?.data) throw new Error('No schema data to serialize')
             const encoded = yield* Catalog.encode(loadedCatalog.data)
             return JSON.stringify(encoded, null, 2)
           }),
@@ -113,6 +148,14 @@ export const Schemas = ({
         isRelevant: isSchemaFile,
       },
       dependentVirtualModules,
+      hooks: {
+        async onDiagnostics(data) {
+          // Report augmentation diagnostics
+          if (data?.diagnostics) {
+            reportDiagnostics(data.diagnostics as AugmentationDiagnostic[], 'dev')
+          }
+        },
+      },
     }),
     {
       name: 'polen:schemas-virtual',
@@ -126,6 +169,12 @@ export const Schemas = ({
             const schemaResult = await Effect.runPromise(
               reader.read().pipe(Effect.provide(NodeFileSystem.layer)),
             )
+
+            // Report diagnostics if any
+            if (schemaResult?.diagnostics && schemaResult.diagnostics.length > 0) {
+              reportDiagnostics(schemaResult.diagnostics, 'dev')
+            }
+
             if (!schemaResult?.data) {
               return `export const schemasCatalog = null`
             }

package/build/api/examples/diagnostic/unused-default.d.ts

@@ -1,49 +0,0 @@
-import { S } from '#lib/kit-temp/effect';
-export declare const DiagnosticUnusedDefault: S.Struct<{
-    _tag: S.tag<"Diagnostic">;
-} & Omit<{
-    _tag: S.Literal<["Diagnostic"]>;
-    source: typeof S.String;
-    name: typeof S.String;
-    severity: S.Enums<{
-        readonly error: "error";
-        readonly warning: "warning";
-        readonly info: "info";
-    }>;
-    message: typeof S.String;
-}, "_tag" | "name" | "source" | "severity"> & {
-    name: S.Literal<["unused-default"]>;
-    source: S.Literal<["examples-scanner"]>;
-    severity: S.Literal<["warning"]>;
-} & {
-    example: S.Struct<{
-        name: typeof S.String;
-        path: typeof S.String;
-    }>;
-    versions: S.Array$<typeof S.String>;
-}>;
-export declare const makeDiagnosticUnusedDefault: import("#lib/kit-temp/effect").EffectKit.Schema.ConstructorUsingOmitLiteral1Algo<S.Struct<{
-    _tag: S.tag<"Diagnostic">;
-} & Omit<{
-    _tag: S.Literal<["Diagnostic"]>;
-    source: typeof S.String;
-    name: typeof S.String;
-    severity: S.Enums<{
-        readonly error: "error";
-        readonly warning: "warning";
-        readonly info: "info";
-    }>;
-    message: typeof S.String;
-}, "_tag" | "name" | "source" | "severity"> & {
-    name: S.Literal<["unused-default"]>;
-    source: S.Literal<["examples-scanner"]>;
-    severity: S.Literal<["warning"]>;
-} & {
-    example: S.Struct<{
-        name: typeof S.String;
-        path: typeof S.String;
-    }>;
-    versions: S.Array$<typeof S.String>;
-}>>;
-export type DiagnosticUnusedDefault = S.Schema.Type<typeof DiagnosticUnusedDefault>;
-//# sourceMappingURL=unused-default.d.ts.map

package/build/api/examples/diagnostic/unused-default.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"unused-default.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unused-default.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAclC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;GAAiD,CAAA;AAEzF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

package/build/api/examples/diagnostic/unused-default.js

@@ -1,19 +0,0 @@
-import { Diagnostic } from '#lib/diagnostic/$';
-import { S } from '#lib/kit-temp/effect';
-export const DiagnosticUnusedDefault = Diagnostic.create({
-    source: 'examples-scanner',
-    name: 'unused-default',
-    severity: 'warning',
-    context: {
-        example: S.Struct({
-            name: S.String,
-            path: S.String,
-        }),
-        versions: S.Array(S.String),
-    },
-}).annotations({
-    identifier: 'DiagnosticUnusedDefault',
-    description: 'Default example file that is never used because explicit versions exist for all schema versions',
-});
-export const makeDiagnosticUnusedDefault = Diagnostic.createMake(DiagnosticUnusedDefault);
-//# sourceMappingURL=unused-default.js.map

package/build/api/examples/diagnostic/unused-default.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unused-default.js","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unused-default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,MAAM,CAAC;IACvD,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,IAAI,EAAE,CAAC,CAAC,MAAM;SACf,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;KAC5B;CACF,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,iGAAiG;CAC/G,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAA"}

package/build/api/schema/augmentations/augmentations/description.d.ts

@@ -1,26 +0,0 @@
-import type { GrafaidOld } from '#lib/grafaid-old';
-import { S } from '#lib/kit-temp/effect';
-export declare const PlacementSchema: S.Literal<["before", "after", "over"]>;
-export type Placement = S.Schema.Type<typeof PlacementSchema>;
-export declare const DescriptionAugmentationSchema: S.Struct<{
-    type: S.Literal<["description"]>;
-    on: S.Union<[S.Struct<{
-        type: S.Literal<["TargetType"]>;
-        name: typeof S.String;
-    }>, S.Struct<{
-        type: S.Literal<["TargetField"]>;
-        name: typeof S.String;
-        targetType: typeof S.String;
-    }>]>;
-    placement: S.Literal<["before", "after", "over"]>;
-    content: typeof S.String;
-}>;
-export type DescriptionAugmentation = S.Schema.Type<typeof DescriptionAugmentationSchema>;
-export declare const Placement: {
-    Before: "before";
-    After: "after";
-    Over: "over";
-};
-export declare const applyDescriptionContent: (type: GrafaidOld.Groups.Describable, augmentation: DescriptionAugmentation) => void;
-export declare const apply: (schema: GrafaidOld.Schema.Schema, augmentation: DescriptionAugmentation) => void;
-//# sourceMappingURL=description.d.ts.map

package/build/api/schema/augmentations/augmentations/description.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../../../../../src/api/schema/augmentations/augmentations/description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AASxC,eAAO,MAAM,eAAe,wCAAuC,CAAA;AACnE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAKxC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAMzF,eAAO,MAAM,SAAS;;;;CAIrB,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,MAAM,UAAU,CAAC,MAAM,CAAC,WAAW,EACnC,cAAc,uBAAuB,SAiBtC,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,QAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,uBAAuB,SAe5F,CAAA"}

package/build/api/schema/augmentations/augmentations/description.js

@@ -1,55 +0,0 @@
-import { S } from '#lib/kit-temp/effect';
-import { neverCase } from '@wollybeard/kit/language';
-import { TargetSchema } from '../target.js';
-import { locateTargetField, locateTargetType } from '../target.js';
-// ============================================================================
-// Schema
-// ============================================================================
-export const PlacementSchema = S.Literal('before', 'after', 'over');
-export const DescriptionAugmentationSchema = S.Struct({
-    type: S.Literal('description'),
-    on: TargetSchema,
-    placement: PlacementSchema,
-    content: S.String,
-});
-// ============================================================================
-// Constants
-// ============================================================================
-export const Placement = {
-    Before: `before`,
-    After: `after`,
-    Over: `over`,
-};
-export const applyDescriptionContent = (type, augmentation) => {
-    const existingDescription = type.description ?? ``;
-    switch (augmentation.placement) {
-        case `before`:
-            type.description = `${augmentation.content}\n\n${existingDescription}`;
-            break;
-        case `after`:
-            type.description = `${existingDescription}\n\n${augmentation.content}`;
-            break;
-        case `over`:
-            type.description = augmentation.content;
-            break;
-        default:
-            neverCase(augmentation.placement);
-    }
-};
-export const apply = (schema, augmentation) => {
-    switch (augmentation.on.type) {
-        case `TargetType`: {
-            const type = locateTargetType(schema, augmentation.on);
-            applyDescriptionContent(type, augmentation);
-            break;
-        }
-        case `TargetField`: {
-            const field = locateTargetField(schema, augmentation.on);
-            applyDescriptionContent(field, augmentation);
-            break;
-        }
-        default:
-            neverCase(augmentation.on);
-    }
-};
-//# sourceMappingURL=description.js.map

package/build/api/schema/augmentations/augmentations/description.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"description.js","sourceRoot":"","sources":["../../../../../src/api/schema/augmentations/augmentations/description.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAElE,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAGnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,EAAE,EAAE,YAAY;IAChB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM;CAClB,CAAC,CAAA;AAIF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,QAAiB;IACzB,KAAK,EAAE,OAAgB;IACvB,IAAI,EAAE,MAAe;CACtB,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAmC,EACnC,YAAqC,EACrC,EAAE;IACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA;IAElD,QAAQ,YAAY,CAAC,SAAS,EAAE,CAAC;QAC/B,KAAK,QAAQ;YACX,IAAI,CAAC,WAAW,GAAG,GAAG,YAAY,CAAC,OAAO,OAAO,mBAAmB,EAAE,CAAA;YACtE,MAAK;QACP,KAAK,OAAO;YACV,IAAI,CAAC,WAAW,GAAG,GAAG,mBAAmB,OAAO,YAAY,CAAC,OAAO,EAAE,CAAA;YACtE,MAAK;QACP,KAAK,MAAM;YACT,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC,OAAO,CAAA;YACvC,MAAK;QACP;YACE,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAgC,EAAE,YAAqC,EAAE,EAAE;IAC/F,QAAQ,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC7B,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,CAAA;YACtD,uBAAuB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;YAC3C,MAAK;QACP,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,CAAA;YACxD,uBAAuB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;YAC5C,MAAK;QACP,CAAC;QACD;YACE,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC,CAAA"}

package/build/api/schema/augmentations/schema-augmentation.d.ts

@@ -1,20 +0,0 @@
-import type { GrafaidOld } from '#lib/grafaid-old';
-import { S } from '#lib/kit-temp/effect';
-import * as AugmentationDescription from './augmentations/description.js';
-export { AugmentationDescription };
-export declare const AugmentationSchema: S.Struct<{
-    type: S.Literal<["description"]>;
-    on: S.Union<[S.Struct<{
-        type: S.Literal<["TargetType"]>;
-        name: typeof S.String;
-    }>, S.Struct<{
-        type: S.Literal<["TargetField"]>;
-        name: typeof S.String;
-        targetType: typeof S.String;
-    }>]>;
-    placement: S.Literal<["before", "after", "over"]>;
-    content: typeof S.String;
-}>;
-export type Augmentation = S.Schema.Type<typeof AugmentationSchema>;
-export declare const apply: (schema: GrafaidOld.Schema.Schema, augmentations: readonly Augmentation[]) => GrafaidOld.Schema.Schema;
-//# sourceMappingURL=schema-augmentation.d.ts.map

package/build/api/schema/augmentations/schema-augmentation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-augmentation.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/schema-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,OAAO,KAAK,uBAAuB,MAAM,gCAAgC,CAAA;AAEzE,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAMlC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAAwD,CAAA;AAEvF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,eAAO,MAAM,KAAK,GAChB,QAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAChC,eAAe,SAAS,YAAY,EAAE,KACrC,UAAU,CAAC,MAAM,CAAC,MAapB,CAAA"}