@things-factory/figure-service 10.1.178 → 10.1.180

package/server/service/figure/figure-public.ts

@@ -0,0 +1,60 @@
+import { In, Like, Not } from 'typeorm'
+
+import { getRepository } from '@things-factory/shell'
+
+import { Figure } from './figure.js'
+import { FigureHistory } from './figure-history.js'
+
+/*
+ * Public figures (LV figure-server design G2): a figure its domain made public is read by every domain -- its releases,
+ * its picture, the files its releases draw from -- and drawn by its full name {namespace}/{type}, which points at one
+ * figure on the server because a namespace belongs to one domain (G1). Its draft stays its domain's. Writing it stays
+ * its domain's (G3). Each reader asks its own domain and its parent first; a public figure is the last place looked.
+ */
+
+type Reader = { id: string; parentId?: string | null }
+
+/** The domains a reader reads as its own: itself and its parent. */
+export const ownScope = (domain: Reader) => In([domain.id, domain.parentId].filter(Boolean) as string[])
+
+/** A figure the reader may read the releases of: its own or its parent's, or any domain's public one. */
+export async function readableFigure(domain: Reader, id: string, select?: Record<string, unknown>): Promise<Figure | null> {
+  return getRepository(Figure).findOne({
+    where: [
+      { domain: { id: ownScope(domain) }, id },
+      { public: true, id }
+    ],
+    relations: { domain: true },
+    ...(select ? { select } : {})
+  })
+}
+
+/** Whether the figure is another domain's public one: the reader sees its releases, never its draft. */
+export function foreignPublic(domain: Reader, figure: Figure): boolean {
+  const owner = figure.domain?.id ?? figure.domainId
+  return !!figure.public && owner !== domain.id && owner !== domain.parentId
+}
+
+/** The public figure of a full name, in whatever domain owns its namespace. */
+export async function publicFigureOfName(namespace: string, type: string): Promise<Figure | null> {
+  return getRepository(Figure).findOne({ where: { namespace, type, public: true }, relations: { domain: true } })
+}
+
+/**
+ * The domains whose kept file this is, among the public figures whose releases draw from it -- the places a reader may
+ * be given that file from beyond its own domain and its parent.
+ */
+export async function publicDomainsOfFile(hash: string, reader: Reader): Promise<string[]> {
+  const figures = await getRepository(Figure).find({
+    where: { public: true, domain: { id: Not(ownScope(reader)) } },
+    relations: { domain: true },
+    select: { id: true, domain: { id: true } }
+  })
+  if (!figures.length) return []
+  const histories = await getRepository(FigureHistory).find({
+    where: { originalId: In(figures.map(figure => figure.id)), state: 'released', source: Like(`%${hash}%`) },
+    select: { originalId: true }
+  })
+  const drawing = new Set(histories.map(history => history.originalId))
+  return [...new Set(figures.filter(figure => drawing.has(figure.id)).map(figure => figure.domain!.id))]
+}

package/server/service/figure/figure-query.ts

@@ -21,6 +21,8 @@ import { FigureReplacedDraft } from './figure-replaced-draft.js'
 import { replacedDraftsOf } from './figure-revert.js'
 import { proposalOutcomeOf } from './figure-proposal.js'
 import { meshSummaryOf } from './figure-mesh-store.js'
+import { readableFigure, publicFigureOfName } from './figure-public.js'
+import { figureCategories } from './figure-categories.js'
 
 @Resolver(Figure)
 @UseMiddleware(SpeakRefusals)
@@ -61,6 +63,28 @@ export class FigureQuery {
     return { items, total }
   }
 
+  /**
+   * Other domains' public figures (LV figure-server design G2): what this domain may read, package and draw besides its
+   * own and its parent's. The rows carry their domain, so a screen says whose each is. Their drafts are not opened.
+   */
+  @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
+  @Query(returns => FigureList, { description: "Other domains' public figures. Read only: their releases, never their drafts." })
+  async publicFigures(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureList> {
+    const { domain } = context.state
+    const mine = [domain.id, domain.parentId].filter(Boolean)
+    const queryBuilder = getQueryBuilderFromListParams({
+      repository: getRepository(Figure),
+      params,
+      alias: 'figure',
+      searchables: ['type', 'name', 'description', 'category', 'tags']
+    })
+      .leftJoinAndSelect('figure.domain', 'owner')
+      .andWhere('figure.public = :public', { public: true })
+      .andWhere('owner.id NOT IN (:...mine)', { mine })
+    const [items, total] = await queryBuilder.getManyAndCount()
+    return { items, total }
+  }
+
   /**
    * 등록된 타입 이름 목록.
    *
@@ -80,8 +104,10 @@ export class FigureQuery {
   async figureVersions(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory[]> {
     const { domain } = context.state
 
+    /* Its own, its parent's, or another domain's public figure (G2): releases are what a public figure shows. */
+    if (!(await readableFigure(domain, id, { id: true, public: true, domain: { id: true } }))) return []
     return await getRepository(FigureHistory).find({
-      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },
+      where: { originalId: id },
       relations: ['updater'],
       order: { version: 'DESC' },
       take: 10
@@ -125,8 +151,9 @@ export class FigureQuery {
   async figureReleased(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory> {
     const { domain } = context.state
 
+    if (!(await readableFigure(domain, id, { id: true, public: true, domain: { id: true } }))) return null
     return await getRepository(FigureHistory).findOne({
-      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },
+      where: { originalId: id },
       order: { version: 'DESC' }
     })
   }
@@ -168,7 +195,7 @@ export class FigureQuery {
       .limit(1)
       .getOne()
 
-    return inspectSource(figure.source, released?.source, context.t, figure.type)
+    return inspectSource(figure.source, released?.source, context.t, figure.type, figure.category)
   }
 
   /**
@@ -202,7 +229,15 @@ export class FigureQuery {
       .limit(1)
       .getOne()
 
-    return inspectSource(source, released?.source, context.t, figure.type)
+    return inspectSource(source, released?.source, context.t, figure.type, figure.category)
+  }
+
+  /** The categories this server allows (G5), or null when a category is free text: the modeller offers them to choose from. */
+  @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
+  @Query(returns => [String], { nullable: true, description: 'The categories this server allows, or null when a category is free text.' })
+  async figureCategories(): Promise<string[] | null> {
+    const codes = figureCategories()
+    return codes ? [...codes] : null
   }
 
   @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
@@ -357,7 +392,9 @@ export class FigureQuery {
         continue
       }
       const found =
-        (await releasedSourceOfName(domain.id, name)) ?? (domain.parentId ? await releasedSourceOfName(domain.parentId, name) : null)
+        (await releasedSourceOfName(domain.id, name)) ??
+        (domain.parentId ? await releasedSourceOfName(domain.parentId, name) : null) ??
+        (await publicReleasedSourceOf(name))
       if (!found) {
         refuse(type, new Refusal('figure-not-released', { type }, 'no release is published here.'))
         continue
@@ -388,6 +425,12 @@ async function releasedSourceOfName(domainId: string, name: FigureName) {
   return found && found.figure.namespace === name.namespace ? found : null
 }
 
+/** The released source of another domain's public figure by full name (G2): looked at after the reader's own. */
+async function publicReleasedSourceOf(name: FigureName) {
+  const figure = await publicFigureOfName(name.namespace, name.type)
+  return figure?.domain ? releasedSourceOfName(figure.domain.id, name) : null
+}
+
 /** One numbered release of a figure, or null when it has none by that number. */
 async function releaseNumbered(figure: Figure, version: number): Promise<{ figure: Figure; source: string; version: number } | null> {
   const row = await getRepository(FigureHistory).findOne({

package/server/service/figure/figure-release-check.test.ts

@@ -0,0 +1,63 @@
+/**
+ * Release checks an app adds (LV figure-server design G10): they see the asset, the row's type and category and the
+ * reader's words, and their findings join the gate's -- a blocking one blocks, a said one does not; a check that
+ * throws blocks by name rather than being skipped; one taken off is gone.
+ */
+import { createFigureAsset, addFigureBox, serializeFigureAsset, applyFigureAuthoring, proposeFigureOccupancy } from '@hatiolab/figure-model'
+
+import { inspectSource, registerFigureReleaseCheck } from './figure-format'
+
+const source = () => {
+  let asset = addFigureBox(createFigureAsset('Mixer'), { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+  asset = applyFigureAuthoring(asset, { kind: 'attach', part: 'body', face: 'bottom', to: { plane: 'mounting-plane' } })
+  return serializeFigureAsset(applyFigureAuthoring(asset, { kind: 'declare-occupancy', proposal: proposeFigureOccupancy(asset, { over: 'range' }), placement: 'floor' }))
+}
+const codes = (inspection: { findings: { code: string; blocking: boolean }[] }) => inspection.findings.map(f => [f.code, f.blocking])
+
+describe('release checks an app adds', () => {
+  const off: Array<() => void> = []
+  afterEach(() => off.splice(0).forEach(take => take()))
+
+  it('none: the gate as it was', () => {
+    const inspection = inspectSource(source(), null, undefined, 'mixer', 'EQUIPMENT')
+    expect(inspection.blocked).toBe(false)
+    expect(inspection.findings.filter(f => f.code.startsWith('app-'))).toEqual([])
+  })
+
+  it('see the asset, the type and the category; a blocking finding blocks, a said one does not', () => {
+    const seen: unknown[] = []
+    off.push(
+      registerFigureReleaseCheck(input => {
+        seen.push([input.asset.version, input.type, input.category])
+        return input.category === 'CARRIER'
+          ? [{ code: 'app-carrier-one-part', message: 'a carrier is one part', blocking: false }]
+          : [{ code: 'app-origin-off', message: 'the origin is off the middle', blocking: true }]
+      })
+    )
+    const equipment = inspectSource(source(), null, undefined, 'mixer', 'EQUIPMENT')
+    expect(codes(equipment)).toContainEqual(['app-origin-off', true])
+    expect(equipment.blocked).toBe(true)
+    const carrier = inspectSource(source(), null, undefined, 'roll', 'CARRIER')
+    expect(codes(carrier)).toContainEqual(['app-carrier-one-part', false])
+    expect(carrier.blocked).toBe(false)
+    expect(seen).toEqual([['figure-asset-1', 'mixer', 'EQUIPMENT'], ['figure-asset-1', 'roll', 'CARRIER']])
+  })
+
+  it('a check that throws blocks by name; one taken off is gone', () => {
+    const take = registerFigureReleaseCheck(() => {
+      throw new Error('no budget table')
+    })
+    const inspection = inspectSource(source(), null, undefined, 'mixer', 'EQUIPMENT')
+    expect(codes(inspection)).toContainEqual(['release-check-failed', true])
+    expect(inspection.findings.find(f => f.code === 'release-check-failed')?.message).toMatch(/no budget table/)
+    take()
+    expect(inspectSource(source(), null, undefined, 'mixer', 'EQUIPMENT').blocked).toBe(false)
+  })
+
+  it('a source the kernel refuses is not shown to them', () => {
+    let called = false
+    off.push(registerFigureReleaseCheck(() => ((called = true), [])))
+    expect(inspectSource('{"version":"figure-asset-1"}', null, undefined, 'x', null).blocked).toBe(true)
+    expect(called).toBe(false)
+  })
+})

package/server/service/figure/figure-release-record-db.test.ts

@@ -10,6 +10,7 @@ const authBase = require('@things-factory/auth-base')
 const settingBase = require('@things-factory/setting-base')
 const { createFigureAsset, addFigureBox, serializeFigureAsset, applyFigureAuthoring, proposeFigureOccupancy, palletizerRobotFigure, FIGURE_KERNEL_VERSION } = require('@hatiolab/figure-model')
 
+let FigureNamespace: any
 let dataSource: DataSource | null = null
 let Figure: any
 let FigureHistory: any
@@ -28,6 +29,7 @@ function loadCompiled(modulePath: string): any {
 
 beforeAll(async () => {
   Figure = loadCompiled('service/figure/figure').Figure
+  FigureNamespace = loadCompiled('service/figure/figure-namespace-entity').FigureNamespace
   FigureHistory = loadCompiled('service/figure/figure-history').FigureHistory
   Subscriber = loadCompiled('service/figure/event-subscriber').FigureHistoryEntitySubscriber
   FigureMutation = loadCompiled('service/figure/figure-mutation').FigureMutation
@@ -38,7 +40,7 @@ beforeAll(async () => {
     synchronize: true,
     dropSchema: true,
     namingStrategy: new shell.NamingStrategy(),
-    entities: [...shell.entities, ...authBase.entities, ...settingBase.entities, Figure, FigureHistory],
+    entities: [...shell.entities, ...authBase.entities, ...settingBase.entities, Figure, FigureHistory, FigureNamespace],
     subscribers: [Subscriber],
     logging: false
   })
@@ -50,9 +52,9 @@ afterAll(async () => {
   dataSource = null
 })
 
-/** The domain setting every figure here is created under (ADR-0114). */
+/** The domain's own default namespace, its subdomain, that every figure here is created and released under (G1). */
 async function namespaced(domain: any) {
-  await dataSource!.getRepository(settingBase.Setting).save({ domain, name: 'figure-namespace', category: 'figure', value: 'system' })
+  await dataSource!.getRepository(FigureNamespace).save({ domain, name: domain.subdomain, state: 'active', isDefault: true })
   return domain
 }
 
@@ -94,7 +96,7 @@ describe('releaseFigure records it', () => {
     const domain = await namespaced(await dataSource!.getRepository(shell.Domain).save({ name: 'release-door', subdomain: 'release-door' }))
     const tx = dataSource!.manager
     const context = { state: { domain, user: undefined, tx } }
-    const figure = await dataSource!.getRepository(Figure).save({ namespace: 'system', type: 'RELEASE_DOOR', name: 'door', source: releasable(100), state: 'draft', version: 0, domain })
+    const figure = await dataSource!.getRepository(Figure).save({ namespace: domain.subdomain, type: 'RELEASE_DOOR', name: 'door', source: releasable(100), state: 'draft', version: 0, domain })
     await new FigureMutation().releaseFigure(figure.id, 'one', context)
     await dataSource!.getRepository(Figure).save({ ...(await dataSource!.getRepository(Figure).findOneOrFail({ where: { id: figure.id } })), domain, source: releasable(300), state: 'draft' })
     await new FigureMutation().releaseFigure(figure.id, 'two', context)
@@ -125,7 +127,7 @@ describe('a release of a figure that moves keeps its joint list', () => {
   it('schema 2, the wrist following -(j2 + j3), controls with both units; another axis is refused', async () => {
     const domain = await namespaced(await dataSource!.getRepository(shell.Domain).save({ name: 'release-joints', subdomain: 'release-joints' }))
     const context = { state: { domain, user: undefined, tx: dataSource!.manager } }
-    const figure = await dataSource!.getRepository(Figure).save({ namespace: 'system', type: 'PALLETIZER', name: 'palletizer', source: palletizer(), state: 'draft', version: 0, domain })
+    const figure = await dataSource!.getRepository(Figure).save({ namespace: domain.subdomain, type: 'PALLETIZER', name: 'palletizer', source: palletizer(), state: 'draft', version: 0, domain })
     await new FigureMutation().releaseFigure(figure.id, 'one', context)
 
     const [row] = await dataSource!.getRepository(FigureHistory).find({ where: { originalId: figure.id } })

package/server/service/figure/figure-rename-db.test.ts

@@ -15,6 +15,7 @@ const shell = require('@things-factory/shell')
 const authBase = require('@things-factory/auth-base')
 const settingBase = require('@things-factory/setting-base')
 
+let FigureNamespace: any
 let dataSource: DataSource | null = null
 let Figure: any
 let FigureHistory: any
@@ -38,6 +39,7 @@ function loadCompiled(modulePath: string): any {
 
 beforeAll(async () => {
   Figure = loadCompiled('service/figure/figure').Figure
+  FigureNamespace = loadCompiled('service/figure/figure-namespace-entity').FigureNamespace
   FigureHistory = loadCompiled('service/figure/figure-history').FigureHistory
   renameFacts = loadCompiled('service/figure/figure-rename').renameFacts
 
@@ -47,7 +49,7 @@ beforeAll(async () => {
     synchronize: true,
     dropSchema: true,
     namingStrategy: new shell.NamingStrategy(),
-    entities: [...shell.entities, ...authBase.entities, ...settingBase.entities, Figure, FigureHistory],
+    entities: [...shell.entities, ...authBase.entities, ...settingBase.entities, Figure, FigureHistory, FigureNamespace],
     logging: false
   })
 
@@ -69,9 +71,9 @@ afterAll(async () => {
   dataSource = null
 })
 
-/** The domain setting every figure here is created under (ADR-0114). */
+/** The domain's own default namespace, its subdomain, that every figure here is created and released under (G1). */
 async function namespaced(domain: any) {
-  await dataSource!.getRepository(settingBase.Setting).save({ domain, name: 'figure-namespace', category: 'figure', value: 'system' })
+  await dataSource!.getRepository(FigureNamespace).save({ domain, name: domain.subdomain, state: 'active', isDefault: true })
   return domain
 }
 
@@ -108,7 +110,7 @@ describe('이름을 바꾸기 전에 읽는 사실', () => {
   it('★ 판본 질의가 실제로 돈다 — 칸 이름이 틀리면 여기서 던진다', async () => {
     const figure = await seedFigure()
 
-    expect(await facts(figure, 'robot-arm')).toEqual({ version: 0, hasHistory: false, takenByAnother: false })
+    expect(await facts(figure, 'robot-arm')).toEqual({ version: 0, hasHistory: false, takenByAnother: false, releasedBefore: false })
   })
 
   it('★ 판본이 있으면 그것을 읽어 온다', async () => {
@@ -189,3 +191,47 @@ describe('처음 저장에 타입 이름을 받는다', () => {
     expect(model.isPlaceholderType(saved.type)).toBe(true)
   })
 })
+
+/*
+ * A type released and then deleted before deleting a released figure was refused (LV figure-server design G4): taking that
+ * name again would number from 1, and one reference `ns/type@n` would name two contents.
+ */
+describe('발행한 뒤 지운 이름은 다시 쓰지 않는다', () => {
+  let FigureMutation: any
+  let FIGURE_SOURCE: string
+  beforeAll(() => {
+    FigureMutation = loadCompiled('service/figure/figure-mutation').FigureMutation
+    const model = require('@hatiolab/figure-model')
+    FIGURE_SOURCE = model.serializeFigureAsset(
+      model.addFigureBox(model.createFigureAsset('상자'), { id: 'box', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+    )
+  })
+  const releasedThenDeleted = async (type: string) => {
+    const figure = await seedFigure({ type, name: type, version: 1, state: 'released' })
+    await dataSource!.getRepository(FigureHistory).save({ originalId: figure.id, version: 1, type, name: type, source: '{}', domain: DOMAIN })
+    await dataSource!.getRepository(Figure).softDelete({ id: figure.id })
+    return figure
+  }
+  const context = () => ({ state: { domain: DOMAIN, user: undefined, tx: dataSource!.manager } })
+
+  it('사실: 발행한 뒤 지운 같은 이름이 있으면 releasedBefore, 발행 없이 지운 것은 아니다', async () => {
+    await releasedThenDeleted('shipped-gone')
+    const draftGone = await seedFigure({ type: 'draft-gone', name: 'draft-gone' })
+    await dataSource!.getRepository(Figure).softDelete({ id: draftGone.id })
+    const fresh = await seedFigure({ type: 'fresh-one', name: 'fresh-one' })
+    expect((await facts(fresh, 'shipped-gone')).releasedBefore).toBe(true)
+    expect((await facts(fresh, 'draft-gone')).releasedBefore).toBe(false)
+    expect((await facts(fresh, 'never-used')).releasedBefore).toBe(false)
+  })
+
+  it('이름 바꾸기로도, 처음 저장으로도, 새로 만들기로도 그 이름을 받지 않는다', async () => {
+    await releasedThenDeleted('gone-mixer')
+    const draft = await seedFigure({ type: 'mixer-draft', name: 'mixer-draft' })
+    await expect(new FigureMutation().updateFigure(draft.id, { type: 'gone-mixer' }, context())).rejects.toMatchObject({ code: 'type-released-before' })
+    await expect(
+      new FigureMutation().saveFigure(FIGURE_SOURCE, context(), undefined, undefined, '7c3d4e5f-6a7b-4c8d-9e0f-a1b2c3d4e5f6', undefined, 'gone-mixer')
+    ).rejects.toThrow(/발행한 뒤 지운/)
+    await expect(new FigureMutation().createFigure({ type: 'gone-mixer', name: 'again', source: FIGURE_SOURCE }, context())).rejects.toThrow(/발행한 뒤 지운/)
+    expect(await dataSource!.getRepository(Figure).count({ where: { type: 'gone-mixer' } })).toBe(0)
+  })
+})

package/server/service/figure/figure-rename.ts

@@ -1,3 +1,4 @@
+import { In, IsNull, Not } from 'typeorm'
 import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'
 /**
  * 초안의 타입을 고치는 규칙 — ADR-0063 결정 4.
@@ -29,11 +30,38 @@ export interface RenameFacts {
   hasHistory: boolean
   /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 도형이 있나. */
   takenByAnother: boolean
+  /**
+   * 같은 도메인에서 그 이름으로 발행한 뒤 지워진 도형이 있나. 발행한 도형을 지울 수 없게 되기(G4) 전에 지워진 것이다.
+   * 그 이름을 다시 쓰면 판 번호가 1부터 다시 매겨져 같은 `ns/type@n` 이 다른 내용을 가리킨다.
+   */
+  releasedBefore?: boolean
 }
 
+/** Whether a figure of this type was released and then deleted in the domain (deleted before G4 refused it). */
+export async function typeReleasedBefore(
+  repositories: {
+    figures: { find(options: any): Promise<{ id?: string }[]> }
+    histories: { count(options: any): Promise<number> }
+  },
+  domain: { id: string },
+  type: string
+): Promise<boolean> {
+  const deleted = await repositories.figures.find({
+    where: { domain: { id: domain.id }, type, deletedAt: Not(IsNull()) },
+    withDeleted: true,
+    select: ['id']
+  })
+  const ids = deleted.map(figure => figure.id).filter(Boolean)
+  return ids.length > 0 && (await repositories.histories.count({ where: { originalId: In(ids) } })) > 0
+}
+
+/** Said when a type was released and deleted before: a new figure may not take it. */
+export const releasedBeforeMessage = (type: string) =>
+  `type 「${type}」 는 이 도메인에서 발행한 뒤 지운 도형의 이름이다 — 다시 쓰면 같은 판 번호가 다른 내용을 가리키므로 다른 이름을 고른다`
+
 export class FigureRenameRefused extends Error {
   constructor(
-    readonly code: 'empty-type' | 'malformed-type' | 'already-released' | 'type-taken',
+    readonly code: 'empty-type' | 'malformed-type' | 'already-released' | 'type-taken' | 'type-released-before',
     message: string
   ) {
     super(message)
@@ -80,6 +108,10 @@ export function renameDraftType(
     throw new FigureRenameRefused('type-taken', `type 「${next}」 는 이 도메인에서 이미 쓰고 있다`)
   }
 
+  if (facts.releasedBefore) {
+    throw new FigureRenameRefused('type-released-before', releasedBeforeMessage(next))
+  }
+
   /* The asset carries no `type`: the name a board uses is the row's alone, so only the row changes. */
   return { type: next, source: current.source }
 }
@@ -94,7 +126,7 @@ export function renameDraftType(
  */
 export async function renameFacts(
   repositories: {
-    figures: { findOne(options: any): Promise<{ id?: string } | null> }
+    figures: { findOne(options: any): Promise<{ id?: string } | null>; find(options: any): Promise<{ id?: string }[]> }
     histories: { count(options: any): Promise<number> }
   },
   figure: { id?: string; version?: number },
@@ -105,5 +137,7 @@ export async function renameFacts(
   const hasHistory = (await repositories.histories.count({ where: { originalId: figure.id } })) > 0
   const taken = next ? await repositories.figures.findOne({ where: { domain: { id: domain.id }, type: next } }) : null
 
-  return { version: figure.version, hasHistory, takenByAnother: !!taken && taken.id !== figure.id }
+  const releasedBefore = next ? await typeReleasedBefore(repositories, domain, next) : false
+
+  return { version: figure.version, hasHistory, takenByAnother: !!taken && taken.id !== figure.id, releasedBefore }
 }

package/server/service/figure/figure-tools.ts

@@ -415,7 +415,7 @@ function figureToolSpecs(): ToolSpec[] {
         const current = sourceForTool(row, ctx?.host)
         const { inspectSource } = getDeps()
         /* Inspected whole, here; only what the model is told is held to its budget. */
-        return { ...findingsWithinBudget(inspectSource(current.source ? JSON.stringify(current.source) : null, null, undefined, row.type)), draft: current.draft }
+        return { ...findingsWithinBudget(inspectSource(current.source ? JSON.stringify(current.source) : null, null, undefined, row.type, row.category)), draft: current.draft }
       }
     },
     {

package/server/service/figure/figure-type.ts

@@ -38,6 +38,9 @@ export class NewFigure {
 
   @Field({ nullable: true, description: 'A base64 encoded thumbnail image.' })
   thumbnail?: string
+
+  @Field({ nullable: true, description: "The domain's namespace to create it under; the domain's default when none." })
+  namespace?: string
 }
 
 /**

package/server/service/figure/figure.ts

@@ -113,6 +113,14 @@ export class Figure {
   @Field({ nullable: true, description: 'The type to use instead of a retired figure.' })
   supersededBy?: string
 
+  /*
+    공개(LV figure-server design G2). 다른 도메인도 이 figure 의 **발행본**을 읽고 꾸러미에 담고 도면에서 정식 이름으로
+    부른다. 초안은 소유 도메인만 본다. 고치고 발행하는 것은 소유 도메인뿐이다(G3). `setFigurePublic` 이 정한다.
+  */
+  @Column({ nullable: true, default: false })
+  @Field({ nullable: true, description: 'Public: other domains read its releases, put them in packages and draw them by full name. Only its domain changes it.' })
+  public?: boolean
+
   /**
    * 분류 하나. **팔레트에서 묶어 보이는 기준이다.**
    *

package/server/service/figure/index.ts

@@ -2,11 +2,12 @@ import { Figure } from './figure.js'
 import { FigureHistory } from './figure-history.js'
 import { FigureReplacedDraft } from './figure-replaced-draft.js'
 import { FigureProposalRecord } from './figure-proposal-record.js'
+import { FigureNamespace } from './figure-namespace-entity.js'
 import { FigureQuery } from './figure-query.js'
 import { FigureMutation } from './figure-mutation.js'
 import { FigureNamespaceResolver } from './figure-namespace-resolver.js'
 import { FigureHistoryEntitySubscriber } from './event-subscriber.js'
 
-export const entities = [Figure, FigureHistory, FigureReplacedDraft, FigureProposalRecord]
+export const entities = [Figure, FigureHistory, FigureReplacedDraft, FigureProposalRecord, FigureNamespace]
 export const resolvers = [FigureQuery, FigureMutation, FigureNamespaceResolver]
 export const subscribers = [FigureHistoryEntitySubscriber]

package/translations/en.json

@@ -97,8 +97,7 @@
   "figure.gate.origin-off-centre.message": "The origin is off the middle of the declared room: {off}.",
   "figure.gate.origin-off-centre.why": "A drawing that places figures by the middle of their room puts this one that far from where it is drawn.",
   "figure.gate.origin-off-centre.how": "Keep it when the figure is fastened there, as a door at its hinge. Move the origin to the middle to place it by its room.",
-  "error.figure-namespace-missing": "this domain has no valid figure namespace ({value}). set {setting} first, for example hatiolab.com.",
-  "error.figure-namespace-changed": "the figure namespace of this domain is {namespace} and cannot change. set {setting} back to {namespace}.",
+  "error.figure-namespace-missing": "this domain has no default figure namespace. add one first.",
   "error.figure-namespace-invalid": "{value} is not a figure namespace. use lower-case letters, digits, dots and hyphens, for example hatiolab.com.",
   "error.figure-type-malformed": "{type} is not a figure type. use lower-case letters, digits and single hyphens, {min} to {max} characters, starting with a letter.",
   "error.figure-name-malformed": "{type} is not a full figure name of the form namespace/type.",
@@ -152,5 +151,15 @@
   "figure.gate.contract.slot-anchor-moved.why": "Every slot on it, and what sits there, stands on the new face after this release.",
   "figure.proposal.label-create": "Make {name}",
   "figure.proposal.label-revise": "Revise {name}",
-  "figure.proposal.reason": "{steps} commands · grade {grade} · {triangles} triangles · made in {attempts} tries"
+  "figure.proposal.reason": "{steps} commands · grade {grade} · {triangles} triangles · made in {attempts} tries",
+  "error.figure-released-not-deletable": "{type} has been released and cannot be deleted.",
+  "error.figure-namespace-taken": "the figure namespace {namespace} is already taken on this server.",
+  "error.figure-namespace-not-owned": "this domain does not own the figure namespace {namespace}.",
+  "error.figure-namespace-suspended": "the figure namespace {namespace} is suspended.",
+  "error.figure-namespace-default-suspended": "the default namespace {namespace} cannot be suspended. make another the default first.",
+  "error.figure-namespace-state": "{state} is not a namespace state. use active or suspended.",
+  "error.figure-public-unreleased": "{type} has no release yet: only released figures are made public.",
+  "error.figure-category-fixed": "the category {category} is set once and does not change.",
+  "error.figure-category-unknown": "{category} is not a category here. use one of {allowed}.",
+  "error.figure-category-missing": "{type} has no category. choose one of {allowed} before releasing."
 }

package/translations/es.json

@@ -97,8 +97,7 @@
   "figure.gate.origin-off-centre.message": "El origen está desplazado del centro del espacio declarado: {off}.",
   "figure.gate.origin-off-centre.why": "Un plano que coloca las figuras por el centro de su espacio sitúa esta a esa distancia de donde está dibujada.",
   "figure.gate.origin-off-centre.how": "Manténgalo si la figura se fija en ese punto, como una puerta por su bisagra. Mueva el origen al centro para colocarla por su espacio.",
-  "error.figure-namespace-missing": "este dominio no tiene un namespace de figura válido ({value}). Defina primero {setting}, por ejemplo hatiolab.com.",
-  "error.figure-namespace-changed": "el namespace de figura de este dominio es {namespace} y no se puede cambiar. Restablezca {setting} a {namespace}.",
+  "error.figure-namespace-missing": "este dominio no tiene un namespace de figura predeterminado. agregue uno primero.",
   "error.figure-namespace-invalid": "{value} no es un namespace de Figure. Use minúsculas, dígitos, puntos y guiones, por ejemplo hatiolab.com.",
   "error.figure-type-malformed": "{type} no es un tipo de figura. Use letras minúsculas, dígitos y guiones simples, de {min} a {max} caracteres, empezando por una letra.",
   "error.figure-name-malformed": "{type} no es un nombre completo de figura con el formato namespace/type.",
@@ -152,5 +151,15 @@
   "figure.gate.contract.slot-anchor-moved.why": "Cada ranura sobre él, y lo que contiene, queda en la nueva cara tras esta publicación.",
   "figure.proposal.label-create": "Crear {name}",
   "figure.proposal.label-revise": "Corregir {name}",
-  "figure.proposal.reason": "{steps} comandos · grado {grade} · {triangles} triángulos · hecho en {attempts} intentos"
+  "figure.proposal.reason": "{steps} comandos · grado {grade} · {triangles} triángulos · hecho en {attempts} intentos",
+  "error.figure-released-not-deletable": "{type} ya se publicó y no se puede eliminar.",
+  "error.figure-namespace-taken": "el namespace de figura {namespace} ya está en uso en este servidor.",
+  "error.figure-namespace-not-owned": "este dominio no posee el namespace de figura {namespace}.",
+  "error.figure-namespace-suspended": "el namespace de figura {namespace} está suspendido.",
+  "error.figure-namespace-default-suspended": "el namespace predeterminado {namespace} no se puede suspender. primero haga predeterminado otro.",
+  "error.figure-namespace-state": "{state} no es un estado de namespace. use active o suspended.",
+  "error.figure-public-unreleased": "{type} aún no se ha publicado: solo las figuras publicadas se pueden hacer públicas.",
+  "error.figure-category-fixed": "la categoría {category} se fija una vez y no cambia.",
+  "error.figure-category-unknown": "{category} no es una categoría aquí. use una de {allowed}.",
+  "error.figure-category-missing": "{type} no tiene categoría. elija una de {allowed} antes de publicar."
 }

package/translations/ja.json

@@ -97,8 +97,7 @@
   "figure.gate.origin-off-centre.message": "原点が宣言された空間の中央からずれています: {off}。",
   "figure.gate.origin-off-centre.why": "空間の中央で Figure を配置する図面では、描画した位置からその分だけ離れて配置されます。",
   "figure.gate.origin-off-centre.how": "ドアの蝶番のように、Figure をそこで取り付ける場合はそのままにしてください。空間の中央で配置するには、原点を中央に移動してください。",
-  "error.figure-namespace-missing": "このドメインには有効な Figure namespace がありません({value})。先に {setting} を設定してください。例: hatiolab.com。",
-  "error.figure-namespace-changed": "このドメインの Figure namespace は {namespace} で、変更できません。{setting} を {namespace} に戻してください。",
+  "error.figure-namespace-missing": "このドメインには既定の Figure namespace がありません。先に namespace を追加してください。",
   "error.figure-namespace-invalid": "Figure namespace の形式ではありません({value})。英小文字・数字・ドット・ハイフンで入力してください。例: hatiolab.com",
   "error.figure-type-malformed": "{type} は Figure type ではありません。英小文字で始め、英小文字・数字・単一のハイフンのみを使って {min}〜{max} 文字で指定してください。",
   "error.figure-name-malformed": "{type} は namespace/type 形式の正式な Figure 名ではありません。",
@@ -152,5 +151,15 @@
   "figure.gate.contract.slot-anchor-moved.why": "その上のすべてのスロットと置かれたものは、このリリース以降新しい面に立ちます。",
   "figure.proposal.label-create": "{name} を作る",
   "figure.proposal.label-revise": "{name} を直す",
-  "figure.proposal.reason": "コマンド {steps} 件 · 等級 {grade} · 三角形 {triangles} · {attempts} 回で作成"
+  "figure.proposal.reason": "コマンド {steps} 件 · 等級 {grade} · 三角形 {triangles} · {attempts} 回で作成",
+  "error.figure-released-not-deletable": "{type} は発行済みの Figure のため削除できません。",
+  "error.figure-namespace-taken": "Figure namespace {namespace} はこのサーバーで既に使われています。",
+  "error.figure-namespace-not-owned": "このドメインは Figure namespace {namespace} を所有していません。",
+  "error.figure-namespace-suspended": "Figure namespace {namespace} は停止中です。",
+  "error.figure-namespace-default-suspended": "既定の namespace {namespace} は停止できません。先に別の namespace を既定にしてください。",
+  "error.figure-namespace-state": "{state} は namespace の状態ではありません。active か suspended を使ってください。",
+  "error.figure-public-unreleased": "{type} はまだ発行されていません。公開できるのは発行済みの Figure だけです。",
+  "error.figure-category-fixed": "分類 {category} は一度決めたら変えません。",
+  "error.figure-category-unknown": "{category} はここで使う分類ではありません。{allowed} のいずれかを選んでください。",
+  "error.figure-category-missing": "{type} に分類がありません。発行する前に {allowed} のいずれかを選んでください。"
 }

package/translations/ko.json

@@ -97,8 +97,7 @@
   "figure.gate.origin-off-centre.message": "원점이 차지 공간 가운데에서 비켜 있습니다: {off}.",
   "figure.gate.origin-off-centre.why": "공간 가운데로 도형을 놓는 도면에서는 그린 자리에서 그만큼 떨어져 놓입니다.",
   "figure.gate.origin-off-centre.how": "문의 경첩처럼 붙이는 자리라면 그대로 둡니다. 공간 가운데로 놓이게 하려면 원점을 가운데로 옮깁니다.",
-  "error.figure-namespace-missing": "이 도메인에 Figure namespace 가 없거나 형식이 맞지 않습니다({value}). 설정 {setting} 에 예를 들어 hatiolab.com 을 먼저 입력해 주세요.",
-  "error.figure-namespace-changed": "이 도메인의 Figure namespace 는 {namespace} 이며 바꿀 수 없습니다. 설정 {setting} 을 {namespace} 로 되돌려 주세요.",
+  "error.figure-namespace-missing": "이 도메인에는 기본 Figure namespace 가 없습니다. 먼저 namespace 를 추가해 주세요.",
   "error.figure-namespace-invalid": "Figure namespace 형식이 아닙니다({value}). 영문 소문자·숫자·점·하이픈으로 입력해 주세요. 예: hatiolab.com",
   "error.figure-type-malformed": "{type} 은 Figure type 이 아닙니다. 소문자로 시작하고 소문자·숫자·하이픈 하나씩만 써서 {min}~{max}자로 정해 주세요.",
   "error.figure-name-malformed": "{type} 은 namespace/type 형식의 정식 이름이 아닙니다.",
@@ -152,5 +151,15 @@
   "figure.gate.contract.slot-anchor-moved.why": "발행 후 해당 기준면의 모든 슬롯과 배치된 항목이 새 기준면으로 이동합니다.",
   "figure.proposal.label-create": "{name} 만들기",
   "figure.proposal.label-revise": "{name} 고치기",
-  "figure.proposal.reason": "명령 {steps}개 · 등급 {grade} · 삼각형 {triangles} · {attempts}번에 만들었다"
+  "figure.proposal.reason": "명령 {steps}개 · 등급 {grade} · 삼각형 {triangles} · {attempts}번에 만들었다",
+  "error.figure-released-not-deletable": "{type} 은 발행한 Figure 라 지울 수 없습니다.",
+  "error.figure-namespace-taken": "Figure namespace {namespace} 는 이 서버에서 이미 쓰고 있습니다.",
+  "error.figure-namespace-not-owned": "이 도메인은 Figure namespace {namespace} 를 갖고 있지 않습니다.",
+  "error.figure-namespace-suspended": "Figure namespace {namespace} 는 쉬는 중입니다.",
+  "error.figure-namespace-default-suspended": "기본 namespace {namespace} 는 쉬게 할 수 없습니다. 먼저 다른 namespace 를 기본으로 정해 주세요.",
+  "error.figure-namespace-state": "{state} 는 namespace 상태가 아닙니다. active 나 suspended 를 쓰세요.",
+  "error.figure-public-unreleased": "{type} 은 아직 발행하지 않았습니다. 발행한 Figure 만 공개할 수 있습니다.",
+  "error.figure-category-fixed": "분류 {category} 는 한 번 정하면 바꾸지 않습니다.",
+  "error.figure-category-unknown": "{category} 는 여기서 쓰는 분류가 아닙니다. {allowed} 가운데 하나를 고르세요.",
+  "error.figure-category-missing": "{type} 에 분류가 없습니다. 발행하기 전에 {allowed} 가운데 하나를 고르세요."
 }