@_linked/translation 0.2.2

package/src/shapes/TranslationRelease.ts

@@ -0,0 +1,114 @@
+import { Shape } from '@_linked/core/shapes/Shape';
+import { literalProperty, objectProperty } from '@_linked/core/shapes/SHACL';
+import { xsd } from '@_linked/core/ontologies/xsd';
+import { Server } from '@_linked/server-utils/utils/Server';
+import { tr } from '../ontologies/translation.js';
+import { linkedShape } from '../package.js';
+import type { TranslationReleaseRecord } from '../records.js';
+
+/**
+ * Graph metadata for an immutable translation release. Key/language selections
+ * live in the content-addressed manifest rather than repeated RDF predicates.
+ */
+@linkedShape
+export class TranslationRelease extends Shape {
+  static targetClass = tr.TranslationRelease;
+
+  @objectProperty({ path: tr.ofApplication, maxCount: 1 })
+  get ofApplication(): string {
+    return '';
+  }
+
+  @objectProperty({ path: tr.branch, maxCount: 1 })
+  get branch(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.releaseId, maxCount: 1 })
+  get releaseId(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.buildId, maxCount: 1 })
+  get buildId(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.channel, maxCount: 1 })
+  get channel(): string {
+    return 'preview';
+  }
+
+  @literalProperty({ path: tr.status, maxCount: 1 })
+  get status(): string {
+    return 'draft';
+  }
+
+  @literalProperty({ path: tr.contractSetHash, maxCount: 1 })
+  get contractSetHash(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.manifestHash, maxCount: 1 })
+  get manifestHash(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.hotfixSequence, datatype: xsd.integer, maxCount: 1 })
+  get hotfixSequence(): number {
+    return 0;
+  }
+
+  @literalProperty({ path: tr.createdAt, datatype: xsd.dateTime, maxCount: 1 })
+  get createdAt(): Date {
+    return new Date(0);
+  }
+
+  @literalProperty({ path: tr.publishedAt, datatype: xsd.dateTime, maxCount: 1 })
+  get publishedAt(): Date {
+    return new Date(0);
+  }
+
+  @literalProperty({ path: tr.supportedUntil, datatype: xsd.dateTime, maxCount: 1 })
+  get supportedUntil(): Date {
+    return new Date(0);
+  }
+
+  /** Canonical JSON summary; the full per-language detail also lives in the manifest. */
+  @literalProperty({ path: tr.qualitySummary, maxCount: 1 })
+  get qualitySummary(): string {
+    return '';
+  }
+
+  @objectProperty({ path: tr.supersedes, shape: TranslationRelease, maxCount: 1 })
+  get supersedes(): TranslationRelease {
+    return undefined as any;
+  }
+
+  static list(data: { appId: string }) {
+    return Server.call(this, 'listReleases', data) as Promise<
+      TranslationReleaseRecord[]
+    >;
+  }
+
+  static createRelease(
+    data: Omit<TranslationReleaseRecord, 'id' | 'createdAt'> & {
+      createdAt?: string;
+    },
+  ) {
+    return Server.call(this, 'createRelease', data) as Promise<
+      TranslationReleaseRecord
+    >;
+  }
+
+  static advanceHotfix(data: {
+    id: string;
+    expectedSequence: number;
+    hotfixSequence: number;
+    manifestHash: string;
+  }) {
+    return Server.call(this, 'advanceReleaseHotfix', data) as Promise<
+      TranslationReleaseRecord
+    >;
+  }
+}

package/src/shapes/TranslationRevision.ts

@@ -0,0 +1,105 @@
+import { Shape } from '@_linked/core/shapes/Shape';
+import { literalProperty, objectProperty } from '@_linked/core/shapes/SHACL';
+import { xsd } from '@_linked/core/ontologies/xsd';
+import { tr } from '../ontologies/translation.js';
+import { linkedShape } from '../package.js';
+import { TranslationKey } from './TranslationKey.js';
+import { TranslationKeyVersion } from './TranslationKeyVersion.js';
+
+/**
+ * One authored value for a (key, language) cell — append-only (Plan 017 AD-P).
+ * A single primitive powers three workflows: change HISTORY (every direct edit
+ * records a `status:'applied'` revision), translator PROPOSALS (`proposed`,
+ * decided by a reviewer), and MT SUGGESTIONS (`suggested`, authorKind
+ * `machine`). The {@link TranslationUnit} stays the fast runtime/grid read
+ * path; revisions are never updated in place except their decision fields
+ * (`status`, `decidedAt`, `decidedBy`).
+ */
+@linkedShape
+export class TranslationRevision extends Shape {
+  static targetClass = tr.TranslationRevision;
+
+  /** IRI of the owning Application (same app-scoping law as Key/Unit). */
+  @objectProperty({ path: tr.ofApplication, maxCount: 1 })
+  get ofApplication(): string {
+    return '';
+  }
+
+  /** The key, NOT the unit — revisions can exist before any unit does. */
+  @objectProperty({ path: tr.ofKey, shape: TranslationKey, maxCount: 1 })
+  get ofKey(): TranslationKey {
+    return undefined as any;
+  }
+
+  @objectProperty({
+    path: tr.ofKeyVersion,
+    shape: TranslationKeyVersion,
+    maxCount: 1,
+  })
+  get ofKeyVersion(): TranslationKeyVersion {
+    return undefined as any;
+  }
+
+  /** BCP-47 language tag, e.g. "es", "zh-Hans". */
+  @literalProperty({ path: tr.language, maxCount: 1 })
+  get language(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.text, maxCount: 1 })
+  get text(): string {
+    return '';
+  }
+
+  /** applied | proposed | suggested | accepted | rejected | superseded. */
+  @literalProperty({ path: tr.status, maxCount: 1 })
+  get status(): string {
+    return 'applied';
+  }
+
+  /** WebID of the human author, or the MT provider IRI. */
+  @objectProperty({ path: tr.author, maxCount: 1 })
+  get author(): string {
+    return '';
+  }
+
+  /** 'human' | 'machine'. */
+  @literalProperty({ path: tr.authorKind, maxCount: 1 })
+  get authorKind(): string {
+    return 'human';
+  }
+
+  /** MT provider key ('claude', 'deepl', …) when authorKind is 'machine'. */
+  @literalProperty({ path: tr.mtProvider, maxCount: 1 })
+  get mtProvider(): string {
+    return '';
+  }
+
+  /** The unit's text when this revision was authored (conflict detection). */
+  @literalProperty({ path: tr.basedOnText, maxCount: 1 })
+  get basedOnText(): string {
+    return '';
+  }
+
+  /** Free-text translator/reviewer comment. */
+  @literalProperty({ path: tr.note, maxCount: 1 })
+  get note(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.createdAt, datatype: xsd.dateTime, maxCount: 1 })
+  get createdAt(): Date {
+    return new Date(0);
+  }
+
+  @literalProperty({ path: tr.decidedAt, datatype: xsd.dateTime, maxCount: 1 })
+  get decidedAt(): Date {
+    return new Date(0);
+  }
+
+  /** WebID of the reviewer who accepted/rejected a pending revision. */
+  @objectProperty({ path: tr.decidedBy, maxCount: 1 })
+  get decidedBy(): string {
+    return '';
+  }
+}

package/src/shapes/TranslationUnit.ts

@@ -0,0 +1,72 @@
+import { Shape } from '@_linked/core/shapes/Shape';
+import { literalProperty, objectProperty } from '@_linked/core/shapes/SHACL';
+import { xsd } from '@_linked/core/ontologies/xsd';
+import { tr } from '../ontologies/translation.js';
+import { linkedShape } from '../package.js';
+import { TranslationKey } from './TranslationKey.js';
+import { TranslationKeyVersion } from './TranslationKeyVersion.js';
+
+/**
+ * One language's value for a {@link TranslationKey} (Plan 014 AD-H). Explicit
+ * per-language node (not `rdf:langString`) so it can be filtered per-language
+ * through the LINKED DSL AND carry management metadata — review `state` and
+ * provenance — that a bare literal cannot hold.
+ */
+@linkedShape
+export class TranslationUnit extends Shape {
+  static targetClass = tr.TranslationUnit;
+
+  /** IRI of the owning Application (explicitly app-scoped per Plan 014 AD-I). */
+  @objectProperty({ path: tr.ofApplication, maxCount: 1 })
+  get ofApplication(): string {
+    return '';
+  }
+
+  @objectProperty({ path: tr.ofKey, shape: TranslationKey, maxCount: 1 })
+  get ofKey(): TranslationKey {
+    return undefined as any;
+  }
+
+  @objectProperty({
+    path: tr.ofKeyVersion,
+    shape: TranslationKeyVersion,
+    maxCount: 1,
+  })
+  get ofKeyVersion(): TranslationKeyVersion {
+    return undefined as any;
+  }
+
+  /** BCP-47 language tag, e.g. "es", "zh-Hans". */
+  @literalProperty({ path: tr.language, maxCount: 1 })
+  get language(): string {
+    return '';
+  }
+
+  @literalProperty({ path: tr.text, maxCount: 1 })
+  get text(): string {
+    return '';
+  }
+
+  /** untranslated | machine | reviewed | stale. */
+  @literalProperty({ path: tr.state, maxCount: 1 })
+  get state(): string {
+    return 'untranslated';
+  }
+
+  @literalProperty({ path: tr.updatedAt, datatype: xsd.dateTime, maxCount: 1 })
+  get updatedAt(): Date {
+    return new Date(0);
+  }
+
+  /** WebID (IRI) of the last editor. */
+  @objectProperty({ path: tr.updatedBy, maxCount: 1 })
+  get updatedBy(): string {
+    return '';
+  }
+
+  /** Current-value provenance (`tm` for exact translation-memory reuse). */
+  @literalProperty({ path: tr.origin, maxCount: 1 })
+  get origin(): string {
+    return '';
+  }
+}