@canonical/pragma-cli 0.18.0

package/src/testing/dsFixtures.ts

@@ -0,0 +1,506 @@
+/**
+ * Design-system-specific TTL fixtures for testing shared operations.
+ *
+ * Richer than ke's generic fixtures — includes the full vocabulary
+ * that D3 operations query against.
+ *
+ * All @prefix declarations derived from {@link TTL_PREFIXES} so that
+ * a namespace rename in PREFIX_MAP propagates here automatically.
+ */
+
+import { PREFIX_MAP, TTL_PREFIXES } from "../domains/shared/prefixes.js";
+
+/** Turtle @prefix block for ds: only (most data fixtures). */
+const dsPrefix = `@prefix ds: <${PREFIX_MAP.ds}> .`;
+
+/** Turtle @prefix block for cs: only (standards fixtures). */
+const csPrefix = `@prefix cs: <${PREFIX_MAP.cs}> .`;
+
+// =============================================================================
+// Ontology (TBox) — class and property definitions
+// =============================================================================
+
+export const DS_ONTOLOGY_TTL = `
+${TTL_PREFIXES}
+
+# ---- Classes ----
+
+ds:UIBlock a owl:Class ;
+  rdfs:label "UI Block" .
+
+ds:Component a owl:Class ;
+  rdfs:subClassOf ds:UIBlock ;
+  rdfs:label "Component" .
+
+ds:Pattern a owl:Class ;
+  rdfs:subClassOf ds:UIBlock ;
+  rdfs:label "Pattern" .
+
+ds:Tier a owl:Class ;
+  rdfs:label "Tier" .
+
+ds:ModifierFamily a owl:Class ;
+  rdfs:label "Modifier Family" .
+
+ds:Modifier a owl:Class ;
+  rdfs:label "Modifier" .
+
+ds:Token a owl:Class ;
+  rdfs:label "Design Token" .
+
+ds:TokenType a owl:Class ;
+  rdfs:label "Token Type" .
+
+ds:ImplementationLibrary a owl:Class ;
+  rdfs:label "Implementation Library" .
+
+ds:ImplementationObject a owl:Class ;
+  rdfs:label "Implementation Object" .
+
+ds:BlockProperty a owl:Class ;
+  rdfs:label "Block Property" .
+
+ds:Subcomponent a owl:Class ;
+  rdfs:subClassOf ds:UIBlock ;
+  rdfs:label "Subcomponent" .
+
+cs:CodeStandard a owl:Class ;
+  rdfs:label "Code Standard" .
+
+cs:Category a owl:Class ;
+  rdfs:label "Standard Category" .
+
+# ---- Properties ----
+
+ds:name a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:tier a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock .
+
+ds:release a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock .
+
+ds:hasModifierFamily a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range ds:ModifierFamily .
+
+ds:modifierFamily a owl:ObjectProperty ;
+  rdfs:domain ds:Modifier ;
+  rdfs:range ds:ModifierFamily .
+
+ds:tokenId a owl:DatatypeProperty ;
+  rdfs:domain ds:Token ;
+  rdfs:range xsd:string .
+
+ds:tokenType a owl:ObjectProperty ;
+  rdfs:domain ds:Token ;
+  rdfs:range ds:TokenType .
+
+ds:tokenTier a owl:ObjectProperty ;
+  rdfs:domain ds:Token .
+
+ds:valueLight a owl:DatatypeProperty ;
+  rdfs:domain ds:Token ;
+  rdfs:range xsd:string .
+
+ds:valueDark a owl:DatatypeProperty ;
+  rdfs:domain ds:Token ;
+  rdfs:range xsd:string .
+
+ds:platform a owl:DatatypeProperty ;
+  rdfs:domain ds:ImplementationLibrary ;
+  rdfs:range xsd:string .
+
+ds:libraryName a owl:DatatypeProperty ;
+  rdfs:domain ds:ImplementationLibrary ;
+  rdfs:range xsd:string .
+
+ds:hasImplementation a owl:ObjectProperty ;
+  rdfs:domain ds:ImplementationLibrary ;
+  rdfs:range ds:ImplementationObject .
+
+ds:implementsBlock a owl:ObjectProperty ;
+  rdfs:domain ds:ImplementationObject ;
+  rdfs:range ds:UIBlock .
+
+ds:headLink a owl:DatatypeProperty ;
+  rdfs:domain ds:ImplementationObject ;
+  rdfs:range xsd:string .
+
+ds:usesToken a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range ds:Token .
+
+ds:anatomyNode a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock .
+
+ds:summary a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:whenToUse a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:whenNotToUse a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:guidelines a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:anatomyDsl a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:anatomyClassic a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:figmaLink a owl:DatatypeProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range xsd:string .
+
+ds:hasProperty a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range ds:BlockProperty .
+
+ds:propertyType a owl:DatatypeProperty ;
+  rdfs:domain ds:BlockProperty ;
+  rdfs:range xsd:string .
+
+ds:optional a owl:DatatypeProperty ;
+  rdfs:domain ds:BlockProperty ;
+  rdfs:range xsd:boolean .
+
+ds:defaultValue a owl:DatatypeProperty ;
+  rdfs:domain ds:BlockProperty ;
+  rdfs:range xsd:string .
+
+ds:constraints a owl:DatatypeProperty ;
+  rdfs:domain ds:BlockProperty ;
+  rdfs:range xsd:string .
+
+ds:hasSubcomponent a owl:ObjectProperty ;
+  rdfs:domain ds:UIBlock ;
+  rdfs:range ds:Subcomponent .
+
+cs:name a owl:DatatypeProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range xsd:string .
+
+cs:hasCategory a owl:ObjectProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range cs:Category .
+
+cs:slug a owl:DatatypeProperty ;
+  rdfs:domain cs:Category ;
+  rdfs:range xsd:string .
+
+cs:description a owl:DatatypeProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range xsd:string .
+
+cs:Example a owl:Class .
+
+cs:do a owl:ObjectProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range cs:Example .
+
+cs:dont a owl:ObjectProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range cs:Example .
+
+cs:language a owl:DatatypeProperty ;
+  rdfs:domain cs:Example ;
+  rdfs:range xsd:string .
+
+cs:code a owl:DatatypeProperty ;
+  rdfs:domain cs:Example ;
+  rdfs:range xsd:string .
+
+cs:extends a owl:ObjectProperty ;
+  rdfs:domain cs:CodeStandard ;
+  rdfs:range cs:CodeStandard .
+`;
+
+// =============================================================================
+// Tier instances
+// =============================================================================
+
+export const DS_TIERS_TTL = `
+${dsPrefix}
+
+ds:global a ds:Tier ;
+  ds:name "global" .
+
+ds:apps a ds:Tier ;
+  ds:name "apps" .
+
+ds:apps_lxd a ds:Tier ;
+  ds:name "apps/lxd" .
+`;
+
+// =============================================================================
+// Release channels
+// =============================================================================
+
+export const DS_RELEASES_TTL = `
+${dsPrefix}
+
+ds:stable a ds:ReleaseChannel .
+ds:experimental a ds:ReleaseChannel .
+ds:alpha a ds:ReleaseChannel .
+ds:beta a ds:ReleaseChannel .
+`;
+
+// =============================================================================
+// Component instances
+// =============================================================================
+
+export const DS_COMPONENTS_TTL = `
+${dsPrefix}
+
+ds:global.component.button a ds:Component ;
+  ds:name "Button" ;
+  ds:tier ds:global ;
+  ds:release ds:stable ;
+  ds:summary "Primary action trigger with optional icon and label." ;
+  ds:whenToUse "Use for high-priority actions in forms and flows." ;
+  ds:whenNotToUse "Avoid for low-emphasis tertiary actions." ;
+  ds:guidelines "Keep labels concise and pair icons with text when possible." ;
+  ds:anatomyDsl "root: button; children: label, icon" ;
+  ds:anatomyClassic "button > label + icon" ;
+  ds:figmaLink "https://figma.com/design/example/Button" ;
+  ds:hasModifierFamily ds:modifier_family.importance ;
+  ds:hasModifierFamily ds:modifier_family.density ;
+  ds:usesToken ds:token.color.primary ;
+  ds:anatomyNode ds:global.component.button.node.root ;
+  ds:anatomyNode ds:global.component.button.node.label ;
+  ds:anatomyNode ds:global.component.button.node.icon ;
+  ds:hasProperty [
+    a ds:BlockProperty ;
+    ds:name "disabled" ;
+    ds:propertyType "boolean" ;
+    ds:optional true ;
+    ds:defaultValue "false" ;
+    ds:constraints "Disables click and keyboard activation."
+  ] , [
+    a ds:BlockProperty ;
+    ds:name "loading" ;
+    ds:propertyType "boolean" ;
+    ds:optional true ;
+    ds:defaultValue "false" ;
+    ds:constraints "Shows busy state and suppresses duplicate actions."
+  ] ;
+  ds:hasSubcomponent ds:global.subcomponent.button.icon .
+
+ds:global.component.button.node.root a ds:AnatomyNode ;
+  ds:name "button" .
+
+ds:global.component.button.node.label a ds:AnatomyNode ;
+  ds:name "label" .
+
+ds:global.component.button.node.icon a ds:AnatomyNode ;
+  ds:name "icon" .
+
+ds:global.subcomponent.button.icon a ds:Subcomponent ;
+  ds:name "Button Icon" ;
+  ds:tier ds:global ;
+  ds:release ds:stable .
+
+ds:global.component.card a ds:Component ;
+  ds:name "Card" ;
+  ds:tier ds:global ;
+  ds:release ds:stable ;
+  ds:summary "Contained surface for related content and actions." ;
+  ds:anatomyDsl "root: card; children: header, body" ;
+  ds:hasProperty [
+    a ds:BlockProperty ;
+    ds:name "padding" ;
+    ds:propertyType "dimension" ;
+    ds:optional true ;
+    ds:defaultValue "spacing.md" ;
+    ds:constraints "Use design token references for spacing values."
+  ] .
+
+ds:apps.lxd.component.panel a ds:Component ;
+  ds:name "LXD Panel" ;
+  ds:tier ds:apps_lxd ;
+  ds:release ds:stable .
+
+ds:global.component.beta-widget a ds:Component ;
+  ds:name "Beta Widget" ;
+  ds:tier ds:global ;
+  ds:release ds:beta .
+`;
+
+// =============================================================================
+// Implementation libraries and objects
+// =============================================================================
+
+export const DS_IMPLEMENTATIONS_TTL = `
+${dsPrefix}
+
+ds:impl.react a ds:ImplementationLibrary ;
+  ds:libraryName "@canonical/react-ds-global" ;
+  ds:platform "react" ;
+  ds:hasImplementation [
+    a ds:ImplementationObject ;
+    ds:implementsBlock ds:global.component.button ;
+    ds:headLink "src/lib/Button/Button.tsx"
+  ] , [
+    a ds:ImplementationObject ;
+    ds:implementsBlock ds:global.component.card ;
+    ds:headLink "src/lib/Card/Card.tsx"
+  ] .
+
+ds:impl.svelte a ds:ImplementationLibrary ;
+  ds:libraryName "@canonical/svelte-ds-global" ;
+  ds:platform "svelte" .
+`;
+
+// =============================================================================
+// Standards
+// =============================================================================
+
+export const DS_STANDARDS_TTL = `
+${csPrefix}
+
+cs:react_category a cs:Category ;
+  cs:slug "react" .
+
+cs:code_category a cs:Category ;
+  cs:slug "code" .
+
+cs:react_folder a cs:CodeStandard ;
+  cs:name "react/component/folder-structure" ;
+  cs:hasCategory cs:react_category ;
+  cs:description "Components must follow the standard folder layout" ;
+  cs:do [
+    cs:description "Place component files in src/lib/ComponentName/" ;
+    cs:language "typescript" ;
+    cs:code "src/lib/Button/Button.tsx"
+  ] ;
+  cs:do [
+    cs:description "Include index.ts barrel export" ;
+    cs:language "typescript" ;
+    cs:code "export { default } from './Button.js';"
+  ] ;
+  cs:dont [
+    cs:description "Use flat directory with all components at same level" ;
+    cs:language "typescript" ;
+    cs:code "src/lib/Button.tsx"
+  ] .
+
+cs:react_props a cs:CodeStandard ;
+  cs:name "react/component/props" ;
+  cs:hasCategory cs:react_category ;
+  cs:extends cs:react_folder ;
+  cs:description "Props must extend the base HTML element type" ;
+  cs:do [
+    cs:description "Extend HTMLAttributes<HTMLElement>" ;
+    cs:language "typescript" ;
+    cs:code "interface ButtonProps extends HTMLAttributes<HTMLButtonElement> {}"
+  ] ;
+  cs:dont [
+    cs:description "Define props without extending HTML attributes" ;
+    cs:language "typescript" ;
+    cs:code "interface ButtonProps { onClick: () => void }"
+  ] .
+
+cs:code_purity a cs:CodeStandard ;
+  cs:name "code/function/purity" ;
+  cs:hasCategory cs:code_category ;
+  cs:description "Functions should be pure where possible" ;
+  cs:do [
+    cs:description "Return same output for same input" ;
+    cs:language "typescript" ;
+    cs:code "function add(a: number, b: number) { return a + b; }"
+  ] ;
+  cs:dont [
+    cs:description "Modify external state without annotation" ;
+    cs:language "typescript" ;
+    cs:code "let count = 0; function increment() { count++; }"
+  ] .
+`;
+
+// =============================================================================
+// Modifier families and modifier instances
+// =============================================================================
+
+export const DS_MODIFIERS_TTL = `
+${dsPrefix}
+
+ds:modifier_family.importance a ds:ModifierFamily ;
+  ds:name "importance" .
+
+ds:mod_importance_default a ds:Modifier ;
+  ds:name "default" ;
+  ds:modifierFamily ds:modifier_family.importance .
+
+ds:mod_importance_primary a ds:Modifier ;
+  ds:name "primary" ;
+  ds:modifierFamily ds:modifier_family.importance .
+
+ds:mod_importance_secondary a ds:Modifier ;
+  ds:name "secondary" ;
+  ds:modifierFamily ds:modifier_family.importance .
+
+ds:modifier_family.density a ds:ModifierFamily ;
+  ds:name "density" .
+
+ds:mod_density_default a ds:Modifier ;
+  ds:name "default" ;
+  ds:modifierFamily ds:modifier_family.density .
+
+ds:mod_density_compact a ds:Modifier ;
+  ds:name "compact" ;
+  ds:modifierFamily ds:modifier_family.density .
+`;
+
+// =============================================================================
+// Tokens
+// =============================================================================
+
+export const DS_TOKENS_TTL = `
+${dsPrefix}
+
+ds:token_type.color a ds:TokenType ;
+  rdfs:label "Color" .
+
+ds:token_type.dimension a ds:TokenType ;
+  rdfs:label "Dimension" .
+
+ds:token.color.primary a ds:Token ;
+  ds:tokenId "color.primary" ;
+  ds:tokenType ds:token_type.color ;
+  ds:tokenTier ds:token_tier.semantic ;
+  ds:valueLight "#0066cc" ;
+  ds:valueDark "#4d9aff" .
+
+ds:token.spacing.sm a ds:Token ;
+  ds:tokenId "spacing.sm" ;
+  ds:tokenType ds:token_type.dimension ;
+  ds:tokenTier ds:token_tier.primitive ;
+  ds:valueLight "8px" ;
+  ds:valueDark "8px" .
+`;
+
+// =============================================================================
+// Convenience: all fixtures concatenated
+// =============================================================================
+
+export const DS_ALL_TTL = [
+  DS_ONTOLOGY_TTL,
+  DS_TIERS_TTL,
+  DS_RELEASES_TTL,
+  DS_COMPONENTS_TTL,
+  DS_IMPLEMENTATIONS_TTL,
+  DS_STANDARDS_TTL,
+  DS_MODIFIERS_TTL,
+  DS_TOKENS_TTL,
+].join("\n");

package/src/testing/fixtures/canonical-config.json

@@ -0,0 +1,4 @@
+{
+  "tier": "global",
+  "channel": "normal"
+}