@kanonak-protocol/cli 3.28.8 → 3.29.0

package/dist/index.js

@@ -108,7 +108,7 @@ Examples:
 
   # Materialize the JSON view (universal default unless overridden).
   $ kanonak derive my-publisher.com/my-package/my-resource --format json
-`).action(async(n,e)=>{try{await ss(n,e)}catch(t){console.error(`Error: ${t.message}`),process.exit(1)}})}async function ss(n,e){let t=x(n);if(!t||!t.instanceName)throw new Error(`Invalid resource URI "${n}". Expected publisher/package[@version]/instance.`);let o=new Xr,r=new Zr,a=await S(process.cwd(),o),s=await r.parseKanonaks(a),i=as(s,t);if(!i)throw new Error(`Resource ${t.publisher}/${t.packageName}${t.version?`@${t.version}`:""}/${t.instanceName} not found in the workspace or cache.`);console.log(`Resource: ${Mn(i)}`);let c=cs(e.format),l=ls(e.variant),m=Qr(i,c,l,s);if(!m)throw new Error(`No derivation found for resource ${Mn(i)} at (format=${e.format}, variant=${e.variant}). The class hierarchy declares no binding and no universal default applies.`);console.log(`Derivation: ${us(m)} \u2192 ${Vn(m.transformation)}`);let u=is(s,m.transformation);if(!u)throw new Error(`Transformation ${Vn(m.transformation)} not found in the workspace or cache. The binding pointed at a transformation the resolver cannot locate.`);let d=rs(e.format),y=await new es().run({transformation:u,instances:[i],allKanonaks:s,repository:a,parser:o,objectParser:r,outputFormat:d}),p=Yr(e.out);Gr(p,{recursive:!0});let g=os[e.format]??"";for(let f of y){let k=ps(f.fileName),b=Jr(p,`${k}${g}`);qr(b,f.content,"utf-8"),console.log(`  wrote ${b}`)}console.log(`Done. ${y.length} artifact(s) written to ${p}`)}function as(n,e){for(let t of n){if(!(t instanceof Bn)||t.name!==e.instanceName)continue;let o=t.namespace||"",r=`${e.publisher}/${e.packageName}@`;if(o.startsWith(r))if(e.version){if(o===`${e.publisher}/${e.packageName}@${e.version}`)return t}else return t}}function is(n,e){let t=`${e.publisher}/${e.package_}@${e.version}`;for(let o of n)if(o instanceof Bn&&o.name===e.name&&o.namespace===t)return o}function cs(n){if(n.includes("/")){let e=x(n);if(!e||!e.instanceName)throw new Error(`Invalid --format URI "${n}".`);return{publisher:e.publisher,package_:e.packageName,name:e.instanceName}}return{...ns,name:n}}function ls(n){if(n.includes("/")){let e=x(n);if(!e||!e.instanceName)throw new Error(`Invalid --variant URI "${n}".`);return{publisher:e.publisher,package_:e.packageName,name:e.instanceName}}return{...ts,name:n}}function Mn(n){return`${n.namespace}/${n.name}`}function Vn(n){return`${n.publisher}/${n.package_}@${n.version}/${n.name}`}function us(n){return n.source==="instance"?"instance override":`class ${n.source.publisher}/${n.source.package_}/${n.source.name}`}function ps(n){return n.replace(/[^a-zA-Z0-9._@-]+/g,"_")}import{Command as ms}from"commander";import{writeFileSync as se,mkdirSync as He}from"fs";import{join as F,resolve as Wn}from"path";import{KanonakParser as ds,KanonakObjectParser as fs,SubjectKanonak as gs,LookRenderer as hs}from"@kanonak-protocol/sdk";import{TransformationEngine as ks}from"@kanonak-protocol/sdk/transformations";import{readFileSync as ys}from"fs";var bs=[{format:{publisher:"kanonak.org",package_:"formats",name:"html"},fileExtension:".html"},{format:{publisher:"kanonak.org",package_:"formats",name:"stylesheet"},fileExtension:".css"},{format:{publisher:"kanonak.org",package_:"formats",name:"svg"},fileExtension:".svg"}];function qn(){return new ms("publish").description("Generate a static Kanonak site from the local workspace. Walks every resource and renders HTML + stylesheet via the engine. Writes to --out in the canonical Kanonak URL hierarchy.").option("--workspace <dir>","Workspace directory containing .kan.yml package files. Defaults to current directory.",process.cwd()).option("--out <dir>","Output directory for the generated site. Defaults to _site.","_site").action(async n=>{await ws(n)})}async function ws(n){let e=Wn(n.workspace),t=Wn(n.out),o=new ds,r=new fs,a=[];q(e,a),a.length===0&&(console.error(`No .kan.yml files found under ${e}`),process.exit(1)),console.log(`Found ${a.length} local package file(s) under ${e}`);let s=new Set;for(let p of a)try{let g=ys(p,"utf-8"),k=o.parse(g).metadata?.namespace_;if(!k)continue;let b=k.version;s.add(`${k.publisher}/${k.package_}@${b.major}.${b.minor}.${b.patch}`)}catch(g){console.warn(`  warning: failed to parse ${p}: ${g.message}`)}console.log(`Local namespaces: ${[...s].join(", ")}`);let i=await S(e,o),c=await r.parseKanonaks(i),l=c.filter(p=>{if(!(p instanceof gs)||!s.has(p.namespace||""))return!1;let f=(p.namespace||"").split("/")[1]?.split("@")[0];return p.name!==f});console.log(`Publishing ${l.length} resource(s) to ${t}`);let m=new ks(i,o,r),u=new hs(c),d=0,h=0;for(let p of l){let g=p.namespace||"",[f,k]=g.split("/");if(!f||!k)continue;let[b,w]=k.split("@");if(!b||!w)continue;let $=F(t,b,w);He($,{recursive:!0});let v=u.findCascadedLook(p),K=v&&!(v.sourceClass.publisher==="kanonak.org"&&v.sourceClass.package_==="core-rdf"&&v.sourceClass.name==="Resource"),j=w.split(".").map(Number),ee=j.length===3&&j.every(I=>!Number.isNaN(I))?{major:j[0],minor:j[1],patch:j[2]}:void 0,W=u.renderRawMarkdown(p);W!==void 0&&(se(F($,`${p.name}.md`),W,"utf-8"),d+=1);for(let I of bs){let O=I.format.name;try{let N,E;if(K&&(O==="html"||O==="stylesheet"))N=O==="html"?u.renderDocument(p):u.renderStylesheet(p),E=`${p.name}${I.fileExtension}`;else if(O==="svg")N=u.renderSvg(p),E=`${p.name}${I.fileExtension}`;else{let Ht={publisher:f,package_:b,name:p.name,...ee?{version:ee}:{}},ce=await m.render({resource:Ht,format:I.format});N=ce.content,O==="html"?E=`${p.name}${I.fileExtension}`:E=ce.filename.includes(".")?ce.filename:`${ce.filename}${I.fileExtension}`}let ie=F($,E);se(ie,N,"utf-8"),d+=1}catch(N){console.warn(`  ${f}/${b}@${w}/${p.name} [${O}]: ${N.message}`),h+=1}}}console.log(`Done. ${d} artifact(s) written, ${h} skipped.`),h>0&&console.log("Skipped artifacts are typically resources with no derivation binding for the requested format (e.g. an instance class without an html transformation). This is expected for vocabulary-only packages \u2014 they have no instances to render.");let y=$s(t,l);console.log(`Wrote ${y} version-form redirect stub(s).`)}function $s(n,e){let t=new Map;for(let r of e){let a=r.namespace||"",[,s]=a.split("/");if(!s)continue;let[i,c]=s.split("@");if(!i||!c)continue;let l=c.split(".").map(Number);if(l.length!==3||l.some(u=>Number.isNaN(u)))continue;let m=`${i}/${r.name}`;t.has(m)||t.set(m,[]),t.get(m).push({verStr:c,major:l[0],minor:l[1],patch:l[2]})}let o=0;for(let[r,a]of t){let[s,i]=r.split("/");a.sort((u,d)=>d.major-u.major||d.minor-u.minor||d.patch-u.patch);let c=a[0];se(F(n,s,`${i}.html`),Fe(`/${s}/${c.verStr}/${i}`),"utf-8"),o+=1;let l=new Set;for(let u of a){if(l.has(u.major))continue;l.add(u.major);let d=F(n,s,String(u.major));He(d,{recursive:!0}),se(F(d,`${i}.html`),Fe(`/${s}/${u.verStr}/${i}`),"utf-8"),o+=1}let m=new Set;for(let u of a){let d=`${u.major}.${u.minor}`;if(m.has(d))continue;m.add(d);let h=F(n,s,d);He(h,{recursive:!0}),se(F(h,`${i}.html`),Fe(`/${s}/${u.verStr}/${i}`),"utf-8"),o+=1}}return o}function Fe(n){let e=n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");return`<!doctype html>
+`).action(async(n,e)=>{try{await ss(n,e)}catch(t){console.error(`Error: ${t.message}`),process.exit(1)}})}async function ss(n,e){let t=x(n);if(!t||!t.instanceName)throw new Error(`Invalid resource URI "${n}". Expected publisher/package[@version]/instance.`);let o=new Xr,r=new Zr,a=await S(process.cwd(),o),s=await r.parseKanonaks(a),i=as(s,t);if(!i)throw new Error(`Resource ${t.publisher}/${t.packageName}${t.version?`@${t.version}`:""}/${t.instanceName} not found in the workspace or cache.`);console.log(`Resource: ${Mn(i)}`);let c=cs(e.format),l=ls(e.variant),m=Qr(i,c,l,s);if(!m)throw new Error(`No derivation found for resource ${Mn(i)} at (format=${e.format}, variant=${e.variant}). The class hierarchy declares no binding and no universal default applies.`);console.log(`Derivation: ${us(m)} \u2192 ${Vn(m.transformation)}`);let u=is(s,m.transformation);if(!u)throw new Error(`Transformation ${Vn(m.transformation)} not found in the workspace or cache. The binding pointed at a transformation the resolver cannot locate.`);let d=rs(e.format),y=await new es().run({transformation:u,instances:[i],allKanonaks:s,repository:a,parser:o,objectParser:r,outputFormat:d}),p=Yr(e.out);Gr(p,{recursive:!0});let g=os[e.format]??"";for(let f of y){let k=ps(f.fileName),b=Jr(p,`${k}${g}`);qr(b,f.content,"utf-8"),console.log(`  wrote ${b}`)}console.log(`Done. ${y.length} artifact(s) written to ${p}`)}function as(n,e){for(let t of n){if(!(t instanceof Bn)||t.name!==e.instanceName)continue;let o=t.namespace||"",r=`${e.publisher}/${e.packageName}@`;if(o.startsWith(r))if(e.version){if(o===`${e.publisher}/${e.packageName}@${e.version}`)return t}else return t}}function is(n,e){let t=`${e.publisher}/${e.package_}@${e.version}`;for(let o of n)if(o instanceof Bn&&o.name===e.name&&o.namespace===t)return o}function cs(n){if(n.includes("/")){let e=x(n);if(!e||!e.instanceName)throw new Error(`Invalid --format URI "${n}".`);return{publisher:e.publisher,package_:e.packageName,name:e.instanceName}}return{...ns,name:n}}function ls(n){if(n.includes("/")){let e=x(n);if(!e||!e.instanceName)throw new Error(`Invalid --variant URI "${n}".`);return{publisher:e.publisher,package_:e.packageName,name:e.instanceName}}return{...ts,name:n}}function Mn(n){return`${n.namespace}/${n.name}`}function Vn(n){return`${n.publisher}/${n.package_}@${n.version}/${n.name}`}function us(n){return n.source==="instance"?"instance override":`class ${n.source.publisher}/${n.source.package_}/${n.source.name}`}function ps(n){return n.replace(/[^a-zA-Z0-9._@-]+/g,"_")}import{Command as ms}from"commander";import{writeFileSync as se,mkdirSync as He}from"fs";import{join as F,resolve as Wn}from"path";import{KanonakParser as ds,KanonakObjectParser as fs,SubjectKanonak as gs,LookRenderer as hs}from"@kanonak-protocol/sdk";import{TransformationEngine as ks}from"@kanonak-protocol/sdk/transformations";import{readFileSync as ys}from"fs";var bs=[{format:{publisher:"kanonak.org",package_:"formats",name:"html"},fileExtension:".html"},{format:{publisher:"kanonak.org",package_:"formats",name:"stylesheet"},fileExtension:".css"},{format:{publisher:"kanonak.org",package_:"formats",name:"svg"},fileExtension:".svg"}];function qn(){return new ms("publish").description("Generate a static Kanonak site from the local workspace. Walks every resource and renders HTML + stylesheet via the engine. Writes to --out in the canonical Kanonak URL hierarchy.").option("--workspace <dir>","Workspace directory containing .kan.yml package files. Defaults to current directory.",process.cwd()).option("--out <dir>","Output directory for the generated site. Defaults to _site.","_site").action(async n=>{await ws(n)})}async function ws(n){let e=Wn(n.workspace),t=Wn(n.out),o=new ds,r=new fs,a=[];q(e,a),a.length===0&&(console.error(`No .kan.yml files found under ${e}`),process.exit(1)),console.log(`Found ${a.length} local package file(s) under ${e}`);let s=new Set;for(let p of a)try{let g=ys(p,"utf-8"),k=o.parse(g).metadata?.namespace_;if(!k)continue;let b=k.version;s.add(`${k.publisher}/${k.package_}@${b.major}.${b.minor}.${b.patch}`)}catch(g){console.warn(`  warning: failed to parse ${p}: ${g.message}`)}console.log(`Local namespaces: ${[...s].join(", ")}`);let i=await S(e,o),c=await r.parseKanonaks(i),l=c.filter(p=>!(!(p instanceof gs)||!s.has(p.namespace||"")));console.log(`Publishing ${l.length} resource(s) to ${t}`);let m=new ks(i,o,r),u=new hs(c),d=0,h=0;for(let p of l){let g=p.namespace||"",[f,k]=g.split("/");if(!f||!k)continue;let[b,w]=k.split("@");if(!b||!w)continue;let $=F(t,b,w);He($,{recursive:!0});let v=u.findCascadedLook(p),K=v&&!(v.sourceClass.publisher==="kanonak.org"&&v.sourceClass.package_==="core-rdf"&&v.sourceClass.name==="Resource"),j=w.split(".").map(Number),ee=j.length===3&&j.every(I=>!Number.isNaN(I))?{major:j[0],minor:j[1],patch:j[2]}:void 0,W=u.renderRawMarkdown(p);W!==void 0&&(se(F($,`${p.name}.md`),W,"utf-8"),d+=1);for(let I of bs){let O=I.format.name;try{let N,E;if(K&&(O==="html"||O==="stylesheet"))N=O==="html"?u.renderDocument(p):u.renderStylesheet(p),E=`${p.name}${I.fileExtension}`;else if(O==="svg")N=u.renderSvg(p),E=`${p.name}${I.fileExtension}`;else{let Ht={publisher:f,package_:b,name:p.name,...ee?{version:ee}:{}},ce=await m.render({resource:Ht,format:I.format});N=ce.content,O==="html"?E=`${p.name}${I.fileExtension}`:E=ce.filename.includes(".")?ce.filename:`${ce.filename}${I.fileExtension}`}let ie=F($,E);se(ie,N,"utf-8"),d+=1}catch(N){console.warn(`  ${f}/${b}@${w}/${p.name} [${O}]: ${N.message}`),h+=1}}}console.log(`Done. ${d} artifact(s) written, ${h} skipped.`),h>0&&console.log("Skipped artifacts are typically resources with no derivation binding for the requested format (e.g. an instance class without an html transformation). This is expected for vocabulary-only packages \u2014 they have no instances to render.");let y=$s(t,l);console.log(`Wrote ${y} version-form redirect stub(s).`)}function $s(n,e){let t=new Map;for(let r of e){let a=r.namespace||"",[,s]=a.split("/");if(!s)continue;let[i,c]=s.split("@");if(!i||!c)continue;let l=c.split(".").map(Number);if(l.length!==3||l.some(u=>Number.isNaN(u)))continue;let m=`${i}/${r.name}`;t.has(m)||t.set(m,[]),t.get(m).push({verStr:c,major:l[0],minor:l[1],patch:l[2]})}let o=0;for(let[r,a]of t){let[s,i]=r.split("/");a.sort((u,d)=>d.major-u.major||d.minor-u.minor||d.patch-u.patch);let c=a[0];se(F(n,s,`${i}.html`),Fe(`/${s}/${c.verStr}/${i}`),"utf-8"),o+=1;let l=new Set;for(let u of a){if(l.has(u.major))continue;l.add(u.major);let d=F(n,s,String(u.major));He(d,{recursive:!0}),se(F(d,`${i}.html`),Fe(`/${s}/${u.verStr}/${i}`),"utf-8"),o+=1}let m=new Set;for(let u of a){let d=`${u.major}.${u.minor}`;if(m.has(d))continue;m.add(d);let h=F(n,s,d);He(h,{recursive:!0}),se(F(h,`${i}.html`),Fe(`/${s}/${u.verStr}/${i}`),"utf-8"),o+=1}}return o}function Fe(n){let e=n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");return`<!doctype html>
 <meta charset="utf-8">
 <title>Redirecting\u2026</title>
 <meta http-equiv="refresh" content="0; url=${e}">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanonak-protocol/cli",
-  "version": "3.28.8",
+  "version": "3.29.0",
   "description": "Kanonak Protocol CLI - Validate and resolve Kanonak ontology packages",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,8 +34,8 @@
     "semantic-web"
   ],
   "dependencies": {
-    "@kanonak-protocol/sdk": "^3.28.8",
-    "@kanonak-protocol/types": "^3.28.8",
+    "@kanonak-protocol/sdk": "^3.29.0",
+    "@kanonak-protocol/types": "^3.29.0",
     "commander": "^13.0.0",
     "js-yaml": "^4.1.1"
   },