@contember/cli 1.1.0-alpha.8 → 1.1.0-beta.2

package/dist/src/utils/schema/collectReferences.d.ts

@@ -0,0 +1,10 @@
+import { Model } from '@contember/schema';
+export declare type ReferenceMapEntry = {
+    owningEntity: Model.Entity;
+    owningRelation: Model.OneHasOneOwningRelation | Model.ManyHasOneRelation;
+    targetEntity: Model.Entity;
+    targetRelation: Model.OneHasOneInverseRelation | Model.OneHasManyRelation | null;
+};
+export declare type ReferencesMap = Record<string, ReferenceMapEntry[]>;
+export declare const collectReferences: (model: Model.Schema) => ReferencesMap;
+//# sourceMappingURL=collectReferences.d.ts.map

package/dist/src/utils/schema/collectReferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectReferences.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/collectReferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEzC,oBAAY,iBAAiB,GAAG;IAC/B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAA;IAC1B,cAAc,EAAE,KAAK,CAAC,uBAAuB,GAAG,KAAK,CAAC,kBAAkB,CAAA;IACxE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAA;IAC1B,cAAc,EAAE,KAAK,CAAC,wBAAwB,GAAG,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAA;CAChF,CAAA;AACD,oBAAY,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;AAE/D,eAAO,MAAM,iBAAiB,UAAW,MAAM,MAAM,KAAG,aA6BvD,CAAA"}

package/dist/src/utils/schema/collectReferences.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectReferences = void 0;
+const collectReferences = (model) => {
+    const entityReferences = Object.fromEntries(Object.keys(model.entities).map(it => [it, []]));
+    for (const entity of Object.values(model.entities)) {
+        for (const field of Object.values(entity.fields)) {
+            switch (field.type) {
+                case 'OneHasOne':
+                    const targetEntity = model.entities[field.target];
+                    if (!('ownedBy' in field)) {
+                        entityReferences[field.target].push({
+                            owningEntity: entity,
+                            owningRelation: field,
+                            targetEntity: targetEntity,
+                            targetRelation: field.inversedBy ? targetEntity.fields[field.inversedBy] : null,
+                        });
+                    }
+                    break;
+                case 'ManyHasOne':
+                    const targetEntity2 = model.entities[field.target];
+                    entityReferences[field.target].push({
+                        owningEntity: entity,
+                        owningRelation: field,
+                        targetEntity: targetEntity2,
+                        targetRelation: field.inversedBy ? targetEntity2.fields[field.inversedBy] : null,
+                    });
+                    break;
+            }
+        }
+    }
+    return entityReferences;
+};
+exports.collectReferences = collectReferences;
+//# sourceMappingURL=collectReferences.js.map

package/dist/src/utils/schema/collectReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectReferences.js","sourceRoot":"","sources":["../../../../src/utils/schema/collectReferences.ts"],"names":[],"mappings":";;;AAUO,MAAM,iBAAiB,GAAG,CAAC,KAAmB,EAAiB,EAAE;IACvE,MAAM,gBAAgB,GAAkB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3G,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACjD,QAAQ,KAAK,CAAC,IAAI,EAAE;gBACnB,KAAK,WAAW;oBACf,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;oBACjD,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE;wBAC1B,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;4BACnC,YAAY,EAAE,MAAM;4BACpB,cAAc,EAAE,KAAK;4BACrB,YAAY,EAAE,YAAY;4BAC1B,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAmC,CAAC,CAAC,CAAC,IAAI;yBACjH,CAAC,CAAA;qBACF;oBACD,MAAK;gBACN,KAAK,YAAY;oBAChB,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;oBAClD,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;wBACnC,YAAY,EAAE,MAAM;wBACpB,cAAc,EAAE,KAAK;wBACrB,YAAY,EAAE,aAAa;wBAC3B,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAA6B,CAAC,CAAC,CAAC,IAAI;qBAC5G,CAAC,CAAA;oBACF,MAAK;aACN;SACD;KACD;IACD,OAAO,gBAAgB,CAAA;AACxB,CAAC,CAAA;AA7BY,QAAA,iBAAiB,qBA6B7B"}

package/package.json

@@ -1,28 +1,32 @@
 {
   "name": "@contember/cli",
-  "version": "1.1.0-alpha.8",
+  "version": "1.1.0-beta.2",
   "license": "Apache-2.0",
   "bin": {
     "contember": "./dist/src/run.js"
   },
   "scripts": {
+    "build": "tailwindcss -i ./src/utils/project/resources/style.css -o ./dist/src/utils/project/resources/out.css",
     "test": "echo 'No tests'"
   },
   "devDependencies": {
     "@types/fs-extra": "^9.0.3",
     "@types/js-yaml": "^4.0.1",
-    "@types/prompts": "^2.0.1"
+    "@types/prompts": "^2.0.1",
+    "autoprefixer": "^10.4.5",
+    "postcss": "^8.4.12",
+    "tailwindcss": "^3.0.24"
   },
   "dependencies": {
-    "@contember/cli-common": "^1.1.0-alpha.8",
-    "@contember/config-loader": "^1.1.0-alpha.8",
-    "@contember/database-migrations": "^1.1.0-alpha.8",
-    "@contember/dic": "^1.1.0-alpha.8",
-    "@contember/engine-content-api": "^1.1.0-alpha.8",
-    "@contember/schema": "^1.1.0-alpha.8",
-    "@contember/schema-definition": "^1.1.0-alpha.8",
-    "@contember/schema-migrations": "^1.1.0-alpha.8",
-    "@contember/schema-utils": "^1.1.0-alpha.8",
+    "@contember/cli-common": "^1.1.0-beta.2",
+    "@contember/config-loader": "^1.1.0-beta.2",
+    "@contember/database-migrations": "^1.1.0-beta.2",
+    "@contember/dic": "^1.1.0-beta.2",
+    "@contember/engine-content-api": "^1.1.0-beta.2",
+    "@contember/schema": "^1.1.0-beta.2",
+    "@contember/schema-definition": "^1.1.0-beta.2",
+    "@contember/schema-migrations": "^1.1.0-beta.2",
+    "@contember/schema-utils": "^1.1.0-beta.2",
     "@graphql-tools/merge": "^6.2.14",
     "chalk": "^4.1.0",
     "chalk-table": "^1.0.2",
@@ -33,6 +37,8 @@
     "js-yaml": "^4.1.0",
     "node-fetch": "^2.6.1",
     "pg": "^8.5.0",
+    "preact": "^10.7.1",
+    "preact-render-to-string": "^5.2.0",
     "prompts": "^2.2.1",
     "vm2": "^3.9.9",
     "yawn-yaml": "^1.5.0"

package/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+	plugins: {
+		tailwindcss: {},
+		autoprefixer: {},
+	},
+}

package/src/commands/migrations/MigrationAmendCommand.ts

@@ -13,7 +13,7 @@ import { resolveSystemApiClient } from './SystemApiClientResolver'
 import prompts from 'prompts'
 import { emptySchema } from '@contember/schema-utils'
 import { validateMigrations } from './MigrationValidationHelper'
-import { loadSchema } from '../../utils/project'
+import { loadSchema } from '../../utils/project/loadSchema'
 
 type Args = {
 	project: string

package/src/commands/migrations/MigrationDiffCommand.ts

@@ -8,7 +8,7 @@ import prompts from 'prompts'
 import { interactiveResolveApiToken, TenantClient } from '../../utils/tenant'
 import { interactiveResolveInstanceEnvironmentFromInput } from '../../utils/instance'
 import { SystemClient } from '../../utils/system'
-import { loadSchema } from '../../utils/project'
+import { loadSchema } from '../../utils/project/loadSchema'
 
 type Args = {
 	project: string

package/src/commands/project/ProjectGenerateDocumentation.ts

@@ -0,0 +1,44 @@
+import { Command, CommandConfiguration, Input, validateProjectName, Workspace } from '@contember/cli-common'
+import { validateSchemaAndPrintErrors } from '../../utils/schema'
+import { loadSchema } from '../../utils/project/loadSchema'
+import { renderProjectInfoHtml } from '../../utils/project/projectDescribe'
+import { writeFile } from 'fs/promises'
+import { join } from 'path'
+
+type Args = {
+	project: string
+}
+
+type Options = {
+	output?: string
+}
+
+export class ProjectGenerateDocumentation extends Command<Args, Options> {
+	protected configure(configuration: CommandConfiguration<Args, Options>): void {
+		configuration.description('Generates HTML documentation from project schema')
+		configuration.argument('project')
+		configuration.option('output').valueRequired().description('file name or "stdout"')
+	}
+
+	protected async execute(input: Input<Args, Options>): Promise<number> {
+		const projectName = input.getArgument('project')
+		const workspace = await Workspace.get(process.cwd())
+
+		validateProjectName(projectName)
+		const project = await workspace.projects.getProject(projectName, { fuzzy: true })
+		const schema = await loadSchema(project)
+		if (!validateSchemaAndPrintErrors(schema, 'Defined schema is invalid:')) {
+			return 1
+		}
+		const html = await renderProjectInfoHtml(schema, project.name)
+		const output = input.getOption('output') ?? `${project.name}.html`
+		if (output === 'stdout') {
+			console.log(html)
+		} else {
+			console.log(`Documentation saved to ${output}`)
+			await writeFile(join(process.cwd(), output), html)
+		}
+
+		return 0
+	}
+}

package/src/commands/project/ProjectPrintSchemaCommand.ts

@@ -11,7 +11,7 @@ import {
 } from '@contember/engine-content-api'
 import { DocumentNode, printSchema } from 'graphql'
 import { mergeSchemas } from '@graphql-tools/merge'
-import { loadSchema } from '../../utils/project'
+import { loadSchema } from '../../utils/project/loadSchema'
 
 type Args = {
 	project: string
@@ -19,14 +19,14 @@ type Args = {
 
 type Options = {
 	role?: string[]
-	format?: 'graphql' | 'introspection'
+	format?: 'graphql' | 'introspection' | 'schema'
 }
 
 export class ProjectPrintSchemaCommand extends Command<Args, Options> {
 	protected configure(configuration: CommandConfiguration<Args, Options>): void {
 		configuration.description('Prints project schema')
 		configuration.argument('project')
-		configuration.option('format').valueRequired().description('graphql|introspection')
+		configuration.option('format').valueRequired().description('graphql|introspection|schema')
 		configuration.option('role').valueArray()
 	}
 
@@ -42,7 +42,8 @@ export class ProjectPrintSchemaCommand extends Command<Args, Options> {
 			return 1
 		}
 		const permissionFactory = new PermissionFactory(schema.model)
-		const permissions = permissionFactory.create(schema.acl, input.getOption('role') || ['admin'])
+		const inputRoles = input.getOption('role')
+		const permissions = permissionFactory.create(schema.acl, inputRoles || ['admin'])
 		const schemaBuilderFactory = new GraphQlSchemaBuilderFactory()
 		const authorizator = new Authorizator(permissions, schema.acl.customPrimary ?? false)
 		const introspection = new IntrospectionSchemaFactory(
@@ -50,7 +51,12 @@ export class ProjectPrintSchemaCommand extends Command<Args, Options> {
 			new EntityRulesResolver(schema.validation, schema.model),
 			authorizator,
 		)
-		if (format === 'introspection') {
+		if (format === 'schema') {
+			if (inputRoles) {
+				throw `--roles option is not supported for "schema" format`
+			}
+			console.log(JSON.stringify(schema, null, '\t'))
+		} else if (format === 'introspection') {
 			console.log(JSON.stringify(introspection.create(), null, '\t'))
 		} else if (format === 'graphql') {
 			const contentSchema = schemaBuilderFactory.create(schema.model, authorizator).build()
@@ -64,7 +70,7 @@ export class ProjectPrintSchemaCommand extends Command<Args, Options> {
 			const printedSchema = printSchema(gqlSchema).replace('""""""\n', '') // remove empty comment
 			console.log(printedSchema)
 		} else {
-			throw new Error(`Unknown format ${format}`)
+			throw `Unknown format ${format}`
 		}
 
 		return 0

package/src/commands/project/ProjectValidateCommand.ts

@@ -3,7 +3,7 @@ import { MigrationsContainerFactory } from '../../MigrationsContainer'
 import { validateSchemaAndPrintErrors } from '../../utils/schema'
 import { emptySchema } from '@contember/schema-utils'
 import { validateMigrations } from '../migrations/MigrationValidationHelper'
-import { loadSchema } from '../../utils/project'
+import { loadSchema } from '../../utils/project/loadSchema'
 
 type Args = {
 	project: string

package/src/commands/project/index.ts

@@ -1,3 +1,4 @@
 export * from './ProjectCreateCommand'
+export * from './ProjectGenerateDocumentation'
 export * from './ProjectPrintSchemaCommand'
 export * from './ProjectValidateCommand'

package/src/run.ts

@@ -11,6 +11,7 @@ import {
 	MigrationRebaseCommand,
 	MigrationStatusCommand,
 	ProjectCreateCommand,
+	ProjectGenerateDocumentation,
 	ProjectPrintSchemaCommand,
 	ProjectValidateCommand,
 	ResetPasswordCommand,
@@ -35,6 +36,7 @@ import {
 		['project:create']: () => new ProjectCreateCommand(),
 		['project:validate']: () => new ProjectValidateCommand(),
 		['project:print-schema']: () => new ProjectPrintSchemaCommand(),
+		['project:generate-doc']: () => new ProjectGenerateDocumentation(),
 		['tenant:sign-in']: () => new SignInCommand(),
 		['tenant:create-api-key']: () => new CreateApiKeyCommand(),
 		['tenant:invite']: () => new InviteCommand(),

package/src/tsconfig.json

@@ -1,7 +1,11 @@
 {
 	"extends": "../tsconfig.settings.json",
 	"compilerOptions": {
-		"outDir": "../dist/src"
+		"outDir": "../dist/src",
+		"jsx": "react",
+		"jsxFactory": "h",
+		"lib": ["dom"],
+		"jsxFragmentFactory": "Fragment"
 	},
 	"references": [
 		{

package/src/utils/project/components/EntityInfo.tsx

@@ -0,0 +1,82 @@
+import { Model, Schema } from '@contember/schema'
+import { ReferencesMap } from '../../schema/collectReferences'
+import { formatEntityAnchor, formatFieldAnchor } from './utils'
+import { SinglePermission } from './SinglePermission'
+import { FieldType } from './FieldType'
+import { FieldPermissions } from './FieldPermissions'
+import { OnDelete } from './OnDelete'
+import { Fragment, h } from 'preact'
+
+interface EntityInfoProps {
+	entity: Model.Entity
+	schema: Schema
+	references: ReferencesMap
+}
+
+export const EntityInfo = ({ entity, schema, references }: EntityInfoProps) => (
+	<div class={'m-4 border border-gray-400 rounded-lg group'}
+		 id={formatEntityAnchor(entity.name)}>
+		<div class={'font-bold text-gray-900 py-2 px-4 border-b border-gray-400 group-target:bg-yellow-100 rounded-t-lg'}>
+			{entity.name}
+		</div>
+		<div class={'px-2 py-2 flex flex-wrap '}>
+			<div>
+				<table>
+					<thead>
+						<tr>
+							<th class={'text-left px-2 text-gray-500 font-normal w-[180px] max-w-[180px]'}>Name</th>
+							<th class={'text-left px-2 text-gray-500 font-normal w-[340px] max-w-[340px]'}>Type</th>
+							{Object.keys(schema.acl.roles).map(role => <th
+								class={'text-left px-2 text-gray-500 font-normal w-[120px] max-w-[120px] text-xs truncate text-sm'}>{role}</th>)}
+						</tr>
+					</thead>
+					<tr>
+						<td></td>
+						<td></td>
+						{Object.values(schema.acl.roles).map(role => <td class={'px-2'}>
+							<SinglePermission value={'D'}
+											  predicate={role.entities[entity.name]?.operations.delete} />
+						</td>)}
+					</tr>
+					{Object.values(entity.fields).map(field => (
+						<tr class={'even:bg-gray-100 target:bg-yellow-100'}
+							id={formatFieldAnchor(entity.name, field.name)}>
+							<td class={'px-2 font-mono truncate  w-[180px] max-w-[180px]'} title={field.name}>
+								{field.name}
+							</td>
+							<td class={'text-gray-800 px-2 font-mono w-[420px] max-w-[420px]'}>
+								<FieldType field={field} />
+							</td>
+							{Object.values(schema.acl.roles).map(role => <td class={'px-2'}>
+								<FieldPermissions field={field.name}
+												  entityPermissions={role.entities[entity.name]} />
+							</td>)}
+						</tr>
+					))}
+
+				</table>
+			</div>
+			<div class={'px-2 py-2 w-1/2'}>
+				<h3 class={'text-lg text-gray-600'}>On delete behaviour:</h3>
+				<p class={'text-gray-500 text-sm'}>
+					(What happens when you attempt to delete entity {entity.name})</p>
+				<div class={'mt-2 text-sm '}>
+					<OnDelete references={references} entity={entity} />
+				</div>
+			</div>
+			{false && <div class={'px-2 py-2 w-1/2'}>
+				<h3 class={'text-lg text-gray-600'}>ACL predicates:</h3>
+				<div class={'mt-2 text-sm '}>
+					{Object.entries(schema.acl.roles).map(([roleName, role]) =>
+						Object.entries(role.entities[entity.name]?.predicates ?? {}).map(([predicateName, predicate]) => (
+							<Fragment>
+								<h4>{roleName}: {predicateName}</h4>
+								<code>{JSON.stringify(predicate)}</code>
+							</Fragment>
+						)),
+					)}
+				</div>
+			</div>}
+		</div>
+	</div>
+)

package/src/utils/project/components/EntityLink.tsx

@@ -0,0 +1,6 @@
+import { h } from 'preact'
+import { formatEntityAnchor } from './utils'
+
+export const EntityLink = ({ entity }: { entity: string }) => (
+	<a href={`#${formatEntityAnchor(entity)}`} class={'text-blue-500 hover:underline'}>{entity}</a>
+)

package/src/utils/project/components/FieldLink.tsx

@@ -0,0 +1,10 @@
+import { Fragment, h } from 'preact'
+import { EntityLink } from './EntityLink'
+import { formatFieldAnchor } from './utils'
+
+export const FieldLink = ({ entity, field, noEntityLabel }: { entity: string; field: string; noEntityLabel?: boolean }) => (
+	<Fragment>
+		{noEntityLabel ? '' : <Fragment><EntityLink entity={entity} />.</Fragment>}
+		<a href={`#${formatFieldAnchor(entity, field)}`} class={'text-blue-500 hover:underline'}>{field}</a>
+	</Fragment>
+)

package/src/utils/project/components/FieldPermissions.tsx

@@ -0,0 +1,14 @@
+import { Fragment, h } from 'preact'
+import { Acl } from '@contember/schema'
+import { SinglePermission } from './SinglePermission'
+
+export const FieldPermissions  = ({ entityPermissions, field }: { entityPermissions?: Acl.EntityPermissions; field: string }) => {
+	const readPermissions = entityPermissions?.operations.read?.[field]
+	const updatePermissions = entityPermissions?.operations.update?.[field]
+	const createPermissions = entityPermissions?.operations.create?.[field]
+	return <Fragment>
+		<SinglePermission value={'C'} predicate={createPermissions} />
+		<SinglePermission value={'R'} predicate={readPermissions} />
+		<SinglePermission value={'U'} predicate={updatePermissions} />
+	</Fragment>
+}

package/src/utils/project/components/FieldType.tsx

@@ -0,0 +1,54 @@
+import { Model } from '@contember/schema'
+import { h, Fragment } from 'preact'
+import { EntityLink } from './EntityLink'
+import { FieldLink } from './FieldLink'
+
+export const FieldType = ({ field }: { field: Model.AnyField }) => {
+	if (field.type === 'ManyHasMany') {
+		return <>
+			<EntityLink entity={field.target}/>[]{' '}
+			<TargetField field={field}/> (m:n)
+		</>
+
+	} else if (field.type === 'OneHasMany') {
+		return <>
+			<EntityLink entity={field.target}/>[]{' '}
+			<TargetField field={field}/> (1:n)
+		</>
+
+	} else if (field.type === 'OneHasOne') {
+		return <>
+			<NullableMark field={field} />
+			<EntityLink entity={field.target}/>{' '}
+			<TargetField field={field}/> (1:1)
+		</>
+
+	} else if (field.type === 'ManyHasOne') {
+		return <>
+			<NullableMark field={field} />
+			<EntityLink entity={field.target}/>{' '}
+			<TargetField field={field}/> (m:1)
+		</>
+
+	} else {
+		return <>
+			<NullableMark field={field} />
+			{field.type}
+		</>
+
+	}
+}
+
+const TargetField = ({ field }: {field: Model.AnyRelation}) => {
+	if ('ownedBy' in field) {
+		return <FieldLink entity={field.target} field={field.ownedBy} noEntityLabel />
+	}
+	if (field.inversedBy) {
+		return <FieldLink entity={field.target} field={field.inversedBy} noEntityLabel />
+	}
+	return null
+}
+
+const NullableMark = (props: { field: Model.NullableRelation | Model.AnyColumn }) => {
+	return props.field.nullable ? <span class={'font-bold color-black'}>? </span> : null
+}

package/src/utils/project/components/OnDelete.tsx

@@ -0,0 +1,72 @@
+import { h, Fragment } from 'preact'
+import { Model } from '@contember/schema'
+import { ReferenceMapEntry, ReferencesMap } from '../../schema/collectReferences'
+import { FieldLink } from './FieldLink'
+import { EntityLink } from './EntityLink'
+
+const sortReferences = (a: ReferenceMapEntry, b: ReferenceMapEntry) =>
+	a.owningRelation.joiningColumn.onDelete.localeCompare(b.owningRelation.joiningColumn.onDelete)
+	|| a.owningEntity.name.localeCompare(b.owningEntity.name)
+	|| a.owningRelation.name.localeCompare(b.owningRelation.name)
+
+export const OnDelete = ({ references, entity, visited = [] }: { references: ReferencesMap; entity: Model.Entity; visited?: Model.Entity[] }) => {
+	const referencedFrom = references[entity.name]
+	if (referencedFrom.length === 0) {
+		if (visited.length !== 0) {
+			return null
+		}
+		return (
+			<span class={'bg-green-200 text-gray-600 p-1 rounded'}>
+				This entity is not referenced from any other entity.
+			</span>
+		)
+	}
+
+	if (visited.includes(entity)) {
+		return (
+			<ul class={'ml-4'}>
+				<li class={'italic'}>(recursion)</li>
+			</ul>
+		)
+	}
+
+	return (
+		<ul class={visited.length > 0 ? 'ml-4' : ''}>
+			{referencedFrom
+				.sort(sortReferences)
+				.map(it => {
+					const inverseDescr = it.targetRelation
+						? <>see <FieldLink entity={entity.name} field={it.targetRelation.name} /></>
+						: 'no inverse side'
+					if (it.owningRelation.joiningColumn.onDelete === 'restrict') {
+						return (
+							<li>
+								<span class={'bg-black text-white px-1'}>Fails</span> when referenced from
+								{' '}<FieldLink entity={it.owningEntity.name} field={it.owningRelation.name} />
+								{' '}({inverseDescr})
+							</li>
+						)
+					}
+					if (it.owningRelation.joiningColumn.onDelete === 'set null') {
+						return (
+							<li>
+								<span class={'bg-blue-400 text-white px-1'}>Sets null</span> at
+								{' '}<FieldLink entity={it.owningEntity.name} field={it.owningRelation.name} />
+								{' '}({inverseDescr})
+							</li>
+						)
+					}
+					if (it.owningRelation.joiningColumn.onDelete === 'cascade') {
+						return (
+							<li>
+								<span class={'bg-red-400 text-white px-1'}>Deletes</span> <EntityLink entity={it.owningEntity.name} />
+								{' '}connected using
+								{' '}<FieldLink entity={it.owningEntity.name} field={it.owningRelation.name} noEntityLabel />
+								{' '}({inverseDescr})
+								<OnDelete entity={it.owningEntity} visited={[...visited, entity]} references={references} />
+							</li>
+						)
+					}
+				})}
+		</ul>)
+}

package/src/utils/project/components/ProjectInfo.tsx

@@ -0,0 +1,48 @@
+import { Schema } from '@contember/schema'
+import { h } from 'preact'
+import { collectReferences } from '../../schema/collectReferences'
+import { EntityLink } from './EntityLink'
+import { EntityInfo } from './EntityInfo'
+
+
+export const ProjectInfo = (props: { schema: Schema; projectName: string }) => {
+	const references = collectReferences(props.schema.model)
+
+	return (
+		<div class={'w-full'}>
+			<div class={'bg-gray-100 p-6 border-b border-gray-400'}>
+				<h1 class={'font-bold text-xl mb-1'}>{props.projectName}</h1>
+				<div class={'flex flex-column gap-4'}>
+					<div>
+						<h2 class={'font-semibold text-gray-500 mb-1'}>Entities</h2>
+						<ul class={'text-sm'}>
+							{Object.values(props.schema.model.entities).map(entity => (
+								<li>
+									<EntityLink entity={entity.name} />
+								</li>
+							))}
+						</ul>
+					</div>
+					<div>
+						<h2 class={'font-semibold text-gray-500 mb-1'}>Enums</h2>
+						<ul class={'text-sm'}>
+							{Object.entries(props.schema.model.enums).map(([name, values]) => (
+								<li class={'mb-2'}>
+									{name} <br />
+									<span class={'text-gray-700 ml-4'}>
+										{values.join(', ')}
+									</span>
+								</li>
+							))}
+						</ul>
+					</div>
+				</div>
+
+
+			</div>
+			{Object.values(props.schema.model.entities).map(entity => (
+				<EntityInfo entity={entity} schema={props.schema} references={references}/>
+			))}
+		</div>
+	)
+}

package/src/utils/project/components/SinglePermission.tsx

@@ -0,0 +1,13 @@
+import { h } from 'preact'
+import { Acl } from '@contember/schema'
+
+export const SinglePermission = ({ predicate, value }: { predicate?: Acl.Predicate; value: string }) => {
+	if (!predicate) {
+		return <span class={'bg-red-500 text-white font-semibold px-0.5'}>{value}</span>
+	}
+	if (predicate === true) {
+		return <span class={'bg-green-600 text-white font-semibold px-0.5'}>{value}</span>
+	}
+	return <span class={'bg-yellow-400 text-black font-semibold px-0.5'} title={predicate}>{value}</span>
+}
+

package/src/utils/project/components/utils.ts

@@ -0,0 +1,3 @@
+export const formatEntityAnchor = (name: string) => `entity-${name}`
+export const formatFieldAnchor = (entity: string, field: string) => `field-${entity}--${field}`
+

package/src/utils/project/projectDescribe.tsx

@@ -0,0 +1,26 @@
+import { Schema } from '@contember/schema'
+import { h } from 'preact'
+import render from 'preact-render-to-string'
+import { ProjectInfo } from './components/ProjectInfo'
+import { readFile } from 'fs/promises'
+
+export const renderProjectInfoHtml = async (schema: Schema, projectName: string) => {
+	const html = render(<ProjectInfo schema={schema} projectName={projectName} />)
+
+	const css = await readFile(__dirname + '/resources/out.css')
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<style>${css}</style>
+	<title>${projectName}</title>
+</head>
+<body>
+${html}
+</body>
+</html>
+`
+
+}
+

package/src/utils/project/resources/style.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;