@synopackageland/cli 0.4.1 → 0.5.0

package/templates/native-go-vue/frontend/src/nas/i18n/m2/ko.json

@@ -0,0 +1,56 @@
+{
+  "title": "NAS 폴더 — File Station",
+  "ownPermissions": "자신의 DSM 세션과 현재 File Station 권한으로 작업합니다.",
+  "consent": "저장된 선택은 동의 기록이며 추가 DSM 권한을 부여하지 않습니다.",
+  "writable": "폴더 생성 및 파일 업로드 허용 (DSM 권한 필요)",
+  "readOnly": "읽기 전용",
+  "unsupported": "백그라운드 작업, 오프라인 접근, 스트리밍 및 원자적 게시를 지원하지 않습니다.",
+  "localOnly": "실험 기능: 로컬 테스트만 완료했으며 DSM 호환성은 검증되지 않았습니다.",
+  "identityRisk": "같은 사용자 이름과 UID로 계정을 다시 만들면 기존 선택이 유지될 수 있습니다.",
+  "pathRisk": "선택은 경로를 사용하며 inode 고정이나 심볼릭 링크 및 이름 변경 제한을 제공하지 않습니다.",
+  "choose": "폴더 선택",
+  "confirm": "선택 확인",
+  "emptySelections": "저장된 폴더가 없습니다. 폴더를 선택하세요.",
+  "refresh": "폴더 새로 고침",
+  "openFiles": "파일 탐색",
+  "revoke": "철회",
+  "confirmRevoke": "철회 확인",
+  "revokeWarning": "선택 철회는 새 작업을 거부합니다. 이미 기록된 데이터는 남으며 요청 취소가 작업 중단을 보장하지 않습니다.",
+  "loading": "불러오는 중…",
+  "emptyFolder": "빈 폴더입니다.",
+  "roots": "폴더",
+  "back": "뒤로",
+  "select": "{name} 선택",
+  "open": "{name} 열기",
+  "selected": "선택됨: {name}",
+  "cancel": "취소",
+  "close": "닫기",
+  "loadMore": "더 불러오기",
+  "inspect": "정보 보기",
+  "read": "파일 읽기",
+  "readComplete": "파일 읽기가 완료되었습니다. 아래에서 다운로드하세요.",
+  "create": "폴더 생성",
+  "folderName": "새 폴더 이름",
+  "upload": "업로드",
+  "uploadFile": "로컬 파일 선택",
+  "limit": "파일당 읽기 및 업로드 제한: 512 KiB. 새 파일을 생성하며 덮어쓰지 않습니다.",
+  "selectionAdded": "폴더 선택을 저장했습니다.",
+  "revokedNotice": "선택을 철회했습니다.",
+  "created": "폴더를 생성했습니다.",
+  "uploaded": "파일을 업로드했습니다.",
+  "accountChanged": "계정 또는 패키지가 변경되었습니다. 창을 닫고 다시 여세요.",
+  "errorSession": "DSM 세션이 만료되었습니다. DSM에 다시 로그인한 후 폴더를 새로 고치세요.",
+  "errorDenied": "현재 DSM 권한 또는 선택으로 접근이 거부되었습니다. 다른 폴더를 선택하세요.",
+  "errorNotFound": "파일 또는 폴더가 없습니다. 목록을 새로 고치세요.",
+  "errorConflict": "같은 이름의 파일 또는 폴더가 있습니다. 다른 이름을 사용하세요.",
+  "errorUncertain": "작업이 완료되었을 수 있습니다. 다시 제출하기 전에 선택 또는 대상 폴더를 새로 고쳐 결과를 확인하세요.",
+  "errorInvalid": "폴더, 파일 이름 또는 요청이 잘못되었습니다. 입력을 확인하세요.",
+  "errorUnavailable": "File Station을 사용할 수 없거나 패키지에 세션 adapter가 없습니다. 나중에 새로 고치세요.",
+  "errorLimit": "512 KiB 파일 제한 또는 서비스 제한을 초과했습니다. 더 작은 파일을 선택하세요.",
+  "errorCanceled": "요청이 취소되었습니다. 새로 고친 후 계속하세요.",
+  "errorTimeout": "요청 시간이 초과되었습니다. 목록을 새로 고치세요.",
+  "metadata": "정보",
+  "fileKind": "파일",
+  "directoryKind": "폴더",
+  "download": "파일 다운로드"
+}

package/templates/native-go-vue/frontend/src/nas/i18n/m2/zh-CN.json

@@ -0,0 +1,56 @@
+{
+  "title": "NAS 文件夹 — File Station",
+  "ownPermissions": "操作使用你自己的 DSM 会话与 File Station 实时权限。",
+  "consent": "保存选择仅记录你的同意，不会授予额外 DSM 权限。",
+  "writable": "允许创建文件夹和上传文件（仍须符合 DSM 权限）",
+  "readOnly": "只读",
+  "unsupported": "不支持后台任务、离线访问、流式传输和原子发布。",
+  "localOnly": "实验功能：仅通过本地测试，DSM 兼容性尚未验证。",
+  "identityRisk": "使用相同用户名和 UID 重建账号，可能保留已有选择。",
+  "pathRisk": "选择按路径操作，不固定 inode，也不限制符号链接和重命名。",
+  "choose": "选择文件夹",
+  "confirm": "确认选择",
+  "emptySelections": "尚未保存文件夹。请选择文件夹开始。",
+  "refresh": "刷新文件夹",
+  "openFiles": "浏览文件",
+  "revoke": "撤销",
+  "confirmRevoke": "确认撤销",
+  "revokeWarning": "撤销选择会拒绝新操作。已写入的数据仍会保留；取消请求不代表操作已停止。",
+  "loading": "正在加载…",
+  "emptyFolder": "此文件夹为空。",
+  "roots": "文件夹",
+  "back": "返回",
+  "select": "选择 {name}",
+  "open": "打开 {name}",
+  "selected": "已选择：{name}",
+  "cancel": "取消",
+  "close": "关闭",
+  "loadMore": "加载更多",
+  "inspect": "查看信息",
+  "read": "读取文件",
+  "readComplete": "文件读取完成。可在下方下载内容。",
+  "create": "创建文件夹",
+  "folderName": "新文件夹名称",
+  "upload": "上传",
+  "uploadFile": "选择本地文件",
+  "limit": "单文件读取和上传上限：512 KiB。上传会创建新文件，不会覆盖。",
+  "selectionAdded": "已保存文件夹选择。",
+  "revokedNotice": "已撤销选择。",
+  "created": "已创建文件夹。",
+  "uploaded": "已上传文件。",
+  "accountChanged": "账号或套件已变更。请关闭并重新打开窗口后继续。",
+  "errorSession": "DSM 会话已失效。请重新登录 DSM，再刷新文件夹。",
+  "errorDenied": "当前 DSM 权限或选择拒绝访问。请选择其他文件夹。",
+  "errorNotFound": "文件或文件夹已不存在。请刷新列表。",
+  "errorConflict": "已有同名文件或文件夹。请使用其他名称。",
+  "errorUncertain": "操作可能已完成。请刷新选择或目标文件夹并确认结果，再决定是否重新提交。",
+  "errorInvalid": "文件夹、文件名或请求无效。请检查输入后重试。",
+  "errorUnavailable": "File Station 不可用，或此套件未提供会话 adapter。请稍后刷新。",
+  "errorLimit": "请求超过单文件 512 KiB 或其他服务限制。请选择较小的文件。",
+  "errorCanceled": "请求已取消。请刷新后继续。",
+  "errorTimeout": "请求超时。请刷新列表后继续。",
+  "metadata": "信息",
+  "fileKind": "文件",
+  "directoryKind": "文件夹",
+  "download": "下载文件"
+}

package/templates/native-go-vue/frontend/src/nas/i18n/m2/zh-TW.json

@@ -0,0 +1,56 @@
+{
+  "title": "NAS 資料夾 — File Station",
+  "ownPermissions": "操作使用你自己的 DSM 工作階段與 File Station 即時權限。",
+  "consent": "儲存選取僅記錄你的同意，不會授予額外 DSM 權限。",
+  "writable": "允許建立資料夾與上傳檔案（仍須符合 DSM 權限）",
+  "readOnly": "唯讀",
+  "unsupported": "不支援背景工作、離線存取、串流與原子發布。",
+  "localOnly": "實驗功能：僅通過本機測試，DSM 相容性尚未驗證。",
+  "identityRisk": "以相同使用者名稱與 UID 重建帳號，可能保留既有選取。",
+  "pathRisk": "選取依路徑操作，不固定 inode，也不限制符號連結與重新命名。",
+  "choose": "選擇資料夾",
+  "confirm": "確認選取",
+  "emptySelections": "尚未儲存資料夾。請選擇資料夾開始。",
+  "refresh": "重新整理資料夾",
+  "openFiles": "瀏覽檔案",
+  "revoke": "撤銷",
+  "confirmRevoke": "確認撤銷",
+  "revokeWarning": "撤銷選取會拒絕新操作。已寫入資料仍會保留；取消請求不代表操作已停止。",
+  "loading": "載入中…",
+  "emptyFolder": "此資料夾是空的。",
+  "roots": "資料夾",
+  "back": "返回",
+  "select": "選取 {name}",
+  "open": "開啟 {name}",
+  "selected": "已選取：{name}",
+  "cancel": "取消",
+  "close": "關閉",
+  "loadMore": "載入更多",
+  "inspect": "檢視資訊",
+  "read": "讀取檔案",
+  "readComplete": "檔案讀取完成。可在下方下載內容。",
+  "create": "建立資料夾",
+  "folderName": "新資料夾名稱",
+  "upload": "上傳",
+  "uploadFile": "選擇本機檔案",
+  "limit": "單檔讀取與上傳上限：512 KiB。上傳會建立新檔案，不會覆寫。",
+  "selectionAdded": "已儲存資料夾選取。",
+  "revokedNotice": "已撤銷選取。",
+  "created": "已建立資料夾。",
+  "uploaded": "已上傳檔案。",
+  "accountChanged": "帳號或套件已變更。請關閉並重新開啟視窗後繼續。",
+  "errorSession": "DSM 工作階段已失效。請重新登入 DSM，再重新整理資料夾。",
+  "errorDenied": "目前的 DSM 權限或選取拒絕存取。請選擇其他資料夾。",
+  "errorNotFound": "檔案或資料夾已不存在。請重新整理清單。",
+  "errorConflict": "已有同名檔案或資料夾。請使用其他名稱。",
+  "errorUncertain": "操作可能已完成。請重新整理選取或目的資料夾並確認結果，再決定是否重新送出。",
+  "errorInvalid": "資料夾、檔名或請求無效。請檢查輸入後重試。",
+  "errorUnavailable": "File Station 無法使用，或此套件未提供工作階段 adapter。請稍後重新整理。",
+  "errorLimit": "請求超過單檔 512 KiB 或其他服務限制。請選擇較小的檔案。",
+  "errorCanceled": "請求已取消。請重新整理後繼續。",
+  "errorTimeout": "請求逾時。請重新整理清單後繼續。",
+  "metadata": "資訊",
+  "fileKind": "檔案",
+  "directoryKind": "資料夾",
+  "download": "下載檔案"
+}

package/templates/native-go-vue/frontend/src/nas/m2-contract.ts

@@ -0,0 +1,33 @@
+import type {InjectionKey} from 'vue'
+
+// File Station session selections are consent, not native helper grants.
+// Paths are display/routing data. Only the backend's authenticated DSM session
+// and current File Station ACL authorize an operation; writable is consent only.
+export const M2_MAX_BYTES = 512 * 1024
+export const M2_PAGE_SIZE = 100
+export type M2Code = 'session_required' | 'auth_unavailable' | 'denied' | 'not_found' |
+ 'conflict' | 'invalid-request' | 'unavailable' | 'unknown_method' | 'unsupported' |
+ 'commit-uncertain' | 'limit-exceeded' | 'canceled' | 'timeout'
+export interface M2Selection {grantId:string; folder:string; writable:boolean}
+export interface M2Entry {name:string; path:string; isDir:boolean; bytes?:number}
+// File picks consent to their containing folder, with one relative filename.
+export interface M2JobSource {selection:M2Selection;entry:M2Entry;segments:readonly string[]}
+export interface M2Page {entries:M2Entry[]; total:number; offset:number; nextOffset?:number}
+export interface M2Session {
+ mode:'filestation-session'; interactive:'session-required'; background:'unavailable'; validation:'local-only'
+}
+export interface M2Provider {
+ readonly mode:'filestation-session'
+ status(signal:AbortSignal):Promise<M2Session>
+ discovery(folder:string|undefined,offset:number,signal:AbortSignal):Promise<M2Page>
+ confirm(folder:string,writable:boolean,signal:AbortSignal):Promise<M2Selection>
+ selections(signal:AbortSignal):Promise<M2Selection[]>
+ revoke(grantId:string,signal:AbortSignal):Promise<void>
+ list(grantId:string,relative:string,offset:number,signal:AbortSignal):Promise<M2Page>
+ stat(grantId:string,relative:string,signal:AbortSignal):Promise<M2Entry>
+ read(grantId:string,relative:string,signal:AbortSignal):Promise<Uint8Array>
+ create(grantId:string,relative:string,name:string,signal:AbortSignal):Promise<void>
+ upload(grantId:string,relative:string,name:string,data:Uint8Array,signal:AbortSignal):Promise<void>
+ dispose():void
+}
+export const M2ProviderKey:InjectionKey<M2Provider> = Symbol('m2-filestation-session')

package/templates/native-go-vue/frontend/src/nas/m2-i18n.ts

@@ -0,0 +1,24 @@
+import type {UiLocale} from '@synopackageland/ui'
+import en from './i18n/m2/en.json'
+import zhTW from './i18n/m2/zh-TW.json'
+import zhCN from './i18n/m2/zh-CN.json'
+import ja from './i18n/m2/ja.json'
+import ko from './i18n/m2/ko.json'
+import de from './i18n/m2/de.json'
+import fr from './i18n/m2/fr.json'
+import es from './i18n/m2/es.json'
+import it from './i18n/m2/it.json'
+export type M2Copy=typeof en
+export const m2Catalogs:Record<string,M2Copy>={en,'zh-TW':zhTW,'zh-CN':zhCN,ja,ko,de,fr,es,it}
+const aliases:Record<string,string>={enu:'en',cht:'zh-TW',chs:'zh-CN',jpn:'ja',krn:'ko',ger:'de',fre:'fr',spn:'es',ita:'it'}
+/** The built-in UI locale (shared by these catalogs and the UI's own text) for a DSM or BCP-47 language tag. */
+export function uiLocale(locale:string):UiLocale{
+ const normalized=locale.replaceAll('_','-')
+ return ([aliases[normalized]??normalized,normalized.split('-')[0]!].find(key=>key in m2Catalogs)??'en') as UiLocale
+}
+export function m2Copy(locale:string):M2Copy{return m2Catalogs[uiLocale(locale)]!}
+export function m2ErrorCopy(error:unknown,copy:M2Copy):string{
+ const code=(error as {code?:string})?.code
+ const keys:Record<string,keyof M2Copy>={session_required:'errorSession',denied:'errorDenied',not_found:'errorNotFound',conflict:'errorConflict','commit-uncertain':'errorUncertain','invalid-request':'errorInvalid','limit-exceeded':'errorLimit',canceled:'errorCanceled',timeout:'errorTimeout',unsupported:'unsupported'}
+ return copy[keys[code??'']??'errorUnavailable']
+}

package/templates/native-go-vue/frontend/src/nas/m2-provider.ts

@@ -0,0 +1,104 @@
+import type {Context} from '../context'
+import {M2_MAX_BYTES,M2_PAGE_SIZE,type M2Code,type M2Entry,type M2Page,type M2Provider,type M2Selection,type M2Session} from './m2-contract'
+
+const codes=new Set<M2Code>(['session_required','auth_unavailable','denied','not_found','conflict','invalid-request','unavailable','unknown_method','unsupported','commit-uncertain','limit-exceeded','canceled','timeout'])
+function refuse(code:M2Code='invalid-request'):never{throw {code}}
+const record=(value:unknown):Record<string,unknown>=>{
+ if(!value||typeof value!=='object'||Array.isArray(value))return refuse('unavailable')
+ return value as Record<string,unknown>
+}
+const length=(s:string)=>new TextEncoder().encode(s).length
+const name=(s:unknown):s is string=>typeof s==='string'&&length(s)<=255&&s!==''&&s!=='.'&&s!=='..'&&!/[/\\\x00\r\n,"]/.test(s)
+const path=(s:unknown):s is string=>typeof s==='string'&&s.startsWith('/')&&length(s)<=4096&&s.slice(1).split('/').every(name)
+const relative=(s:string)=>s===''||(!s.startsWith('/')&&s.split('/').every(name))
+const id=(s:unknown):s is string=>typeof s==='string'&&/^[a-fA-F0-9]{64}$/.test(s)
+const integer=(v:unknown):v is number=>typeof v==='number'&&Number.isSafeInteger(v)&&v>=0
+function selection(value:unknown):M2Selection{
+ const v=record(value)
+ if(!id(v.grantId)||!path(v.folder)||typeof v.writable!=='boolean')refuse('unavailable')
+ return {grantId:v.grantId,folder:v.folder,writable:v.writable}
+}
+function entry(value:unknown):M2Entry{
+ const v=record(value),additional=record(v.additional??{})
+ if(!name(v.name)||!path(v.path)||typeof v.isdir!=='boolean'||(additional.size!==undefined&&!integer(additional.size)))refuse('unavailable')
+ return {name:v.name,path:v.path,isDir:v.isdir,...(additional.size===undefined?{}:{bytes:additional.size as number})}
+}
+function page(value:unknown,offset:number):M2Page{
+ const v=record(value)
+ if(!('files' in v)&&!('shares' in v))refuse('unavailable')
+ const raw=v.shares??v.files??[]
+ if(!Array.isArray(raw)||raw.length>M2_PAGE_SIZE||!integer(v.total)||v.offset!==offset||offset+raw.length>v.total)refuse('unavailable')
+ const entries=raw.map(entry),next=offset+entries.length
+ return {entries,total:v.total,offset,...(entries.length&&next<v.total&&next<=1000000?{nextOffset:next}:{})}
+}
+function encode(data:Uint8Array):string{
+ let raw=''
+ for(const byte of data)raw+=String.fromCharCode(byte)
+ return btoa(raw)
+}
+function bytes(value:unknown):Uint8Array{
+ const v=record(value)
+ if(!integer(v.bytes)||v.bytes>M2_MAX_BYTES||typeof v.data!=='string'||v.data.length>4*Math.ceil(M2_MAX_BYTES/3)||! /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(v.data))refuse('unavailable')
+ const raw=atob(v.data)
+ if(raw.length!==v.bytes||btoa(raw)!==v.data)refuse('unavailable')
+ return Uint8Array.from(raw,c=>c.charCodeAt(0))
+}
+export function createM2Provider(ctx:Pick<Context,'call'>):M2Provider{
+ let disposed=false
+ const life=new AbortController()
+ async function request(method:string,args:Record<string,unknown>,signal:AbortSignal,mutates=false):Promise<unknown>{
+  if(disposed||signal.aborted)refuse('canceled')
+  let cleanup=()=>{}
+  const stop=new Promise<never>((_,reject)=>{
+   const abort=()=>reject({code:mutates?'commit-uncertain':'canceled'})
+   const timer=setTimeout(()=>reject({code:mutates?'commit-uncertain':'timeout'}),22000)
+   signal.addEventListener('abort',abort,{once:true});life.signal.addEventListener('abort',abort,{once:true})
+   cleanup=()=>{clearTimeout(timer);signal.removeEventListener('abort',abort);life.signal.removeEventListener('abort',abort)}
+  })
+  try{
+   // ctx.call retains DSM's existing same-origin session and CSRF transport.
+   // It has no abort API: canceling local observation cannot prove rollback.
+   const value=await Promise.race([ctx.call(method,args),stop])
+   if(disposed||signal.aborted)refuse(mutates?'commit-uncertain':'canceled')
+   return value
+  }catch(e){
+   const code=(e as {code?:M2Code})?.code
+   if(mutates&&(!code||!codes.has(code)||['timeout','canceled'].includes(code)))refuse('commit-uncertain')
+   throw {code:code&&codes.has(code)?code:'unavailable'}
+  }finally{cleanup()}
+ }
+ function fileArgs(grantId:string,rel:string){if(!id(grantId)||!relative(rel))refuse();return {grantId,relative:rel}}
+ function offsetArgs(offset:number){if(!integer(offset)||offset>1000000)refuse();return {offset}}
+ function dispose(){if(disposed)return;disposed=true;life.abort();if(typeof window!=='undefined')window.removeEventListener('pagehide',dispose)}
+ if(typeof window!=='undefined')window.addEventListener('pagehide',dispose)
+ return {
+  mode:'filestation-session',
+  async status(signal){
+   const v=record(await request('nas.session.status',{},signal))
+   if(v.mode!=='filestation-session'||v.interactive!=='session-required'||v.background!=='unavailable'||v.validation!=='local-only')refuse('unavailable')
+   return {mode:v.mode,interactive:v.interactive,background:v.background,validation:v.validation} as M2Session
+  },
+  async discovery(folder,offset,signal){if(folder!==undefined&&!path(folder))refuse();return page(await request('nas.discovery',{...(folder?{folder}:{}),...offsetArgs(offset)},signal),offset)},
+  async confirm(folder,writable,signal){
+   if(!path(folder)||typeof writable!=='boolean')refuse()
+   const value=await request('nas.grants.confirm',{folder,writable},signal,true)
+   try{const s=selection(value);if(s.folder!==folder||s.writable!==writable)refuse();return s}catch{refuse('commit-uncertain')}
+  },
+  async selections(signal){const values=await request('nas.grants.list',{},signal);if(!Array.isArray(values)||values.length>256)refuse('unavailable');return values.map(selection)},
+  async revoke(grantId,signal){if(!id(grantId))refuse();const result=await request('nas.grants.revoke',{grantId},signal,true);if(!result||typeof result!=='object'||(result as {revoked?:unknown}).revoked!==true)refuse('commit-uncertain')},
+  async list(grantId,rel,offset,signal){return page(await request('nas.files.list',{...fileArgs(grantId,rel),...offsetArgs(offset)},signal),offset)},
+  async stat(grantId,rel,signal){return entry(await request('nas.files.stat',fileArgs(grantId,rel),signal))},
+  async read(grantId,rel,signal){if(!rel)refuse();return bytes(await request('nas.files.read',fileArgs(grantId,rel),signal))},
+  async create(grantId,rel,n,signal){
+   if(!name(n))refuse()
+   const v=await request('nas.files.create',{...fileArgs(grantId,rel),name:n},signal,true)
+   if(!v||typeof v!=='object'||(v as {created?:unknown}).created!==true)refuse('commit-uncertain')
+  },
+  async upload(grantId,rel,n,data,signal){
+   if(!name(n)||!(data instanceof Uint8Array))refuse()
+   if(data.byteLength>M2_MAX_BYTES)refuse('limit-exceeded')
+   const v=await request('nas.files.write',{...fileArgs(grantId,rel),name:n,data:encode(data)},signal,true)
+   if(!v||typeof v!=='object'||(v as {written?:unknown}).written!==true)refuse('commit-uncertain')
+  },dispose,
+ }
+}

package/templates/native-go-vue/frontend/src/nas/use-m2-request.ts

@@ -0,0 +1,18 @@
+import {onBeforeUnmount,ref} from 'vue'
+
+// The provider owns the 22 s bound (backend handlers are bounded to 20 s).
+// Local cancellation suppresses late display updates, never promises rollback.
+export function useM2Request(){
+ const busy=ref(false),error=ref<unknown>()
+ let disposed=false,generation=0,active:AbortController|undefined
+ function cancel(){generation++;active?.abort();active=undefined;busy.value=false;error.value=undefined}
+ async function run<T>(fn:(signal:AbortSignal)=>Promise<T>):Promise<T|undefined>{
+  if(disposed||busy.value)return
+  const version=++generation,controller=new AbortController();active=controller;busy.value=true;error.value=undefined
+  try{const value=await fn(controller.signal);return !disposed&&version===generation?value:undefined}
+  catch(e){if(!disposed&&version===generation)error.value=e;return undefined}
+  finally{if(!disposed&&version===generation){busy.value=false;active=undefined}}
+ }
+ onBeforeUnmount(()=>{disposed=true;cancel()})
+ return {busy,error,run,cancel}
+}

package/templates/native-go-vue/frontend/src/sdk-main.ts

@@ -0,0 +1,39 @@
+import {createApp} from 'vue'
+import App from './SDKApp.vue'
+import {JobsProviderKey,JobsAdminProviderKey} from './jobs/provider'
+import {createConnectedJobsProvider,createConnectedJobsAdminProvider} from './jobs/connected-provider'
+import type {Context} from './context'
+import {NasProviderKey, type NasProvider} from './nas/provider'
+import {M2ProviderKey} from './nas/m2-contract'
+import {createM2Provider} from './nas/m2-provider'
+import '@synopackageland/ui/themes/dsm7-embedded.css'
+import './style.css'
+import './m2-style.css'
+
+let mountSequence = 0
+export function mount(root: HTMLElement, ctx: Context, options: {nasProvider?: NasProvider} = {}) {
+ const app = createApp(App, {ctx})
+ const jobs=createConnectedJobsProvider(ctx)
+ const selections=createM2Provider(ctx)
+ app.provide(M2ProviderKey,selections)
+ app.provide(JobsProviderKey,jobs)
+ app.provide(JobsAdminProviderKey,createConnectedJobsAdminProvider(ctx))
+ // The shipped strict-S1 build never installs a NAS provider. Preview is dev/mock only.
+ if(import.meta.env.DEV && options.nasProvider?.mode === 'mock') app.provide(NasProviderKey, options.nasProvider)
+ // Include the generated package ID, an instance counter and randomness even
+ // across separately loaded bundles. getRandomValues also works on DSM HTTP.
+ app.config.idPrefix = `__PACKAGE__-${++mountSequence}-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`
+ const hadRootClass = root.classList.contains('dsmapp-vue-root')
+ root.classList.add('dsmapp-vue-root')
+ app.mount(root)
+ return {unmount() {app.unmount(); jobs.disconnect(); selections.dispose(); if(!hadRootClass) root.classList.remove('dsmapp-vue-root')}}
+}
+// Register with the existing per-package DSM window loader. Never share a
+// singleton app or user/session state between different mount calls.
+const script = document.currentScript as HTMLScriptElement | null
+const packageID = script?.getAttribute('data-package')
+const host = window as unknown as {DsmPackageApps: Record<string, {mount: typeof mount}>}
+if (packageID) {
+ host.DsmPackageApps = host.DsmPackageApps || {}
+ host.DsmPackageApps[packageID] = {mount}
+}

package/templates/native-go-vue/frontend/src/shell/AppShell.vue

@@ -0,0 +1,48 @@
+<script setup lang="ts">
+// DSM-style shell: a fixed left navigation and one right-hand page with a
+// header. Pages stay mounted (v-show) so provider leases and job polling keep
+// running while the user moves between them.
+import {computed, type Component} from 'vue'
+import {AppLayout, AppSidebar, PageContent, PageHeader, type AppSidebarGroup} from '@synopackageland/ui'
+import {FolderOpen, Info, KeyRound, ListChecks, MousePointerClick, NotebookPen, Shield, Timer} from '@lucide/vue'
+import {shellCopy} from './i18n'
+import type {ShellPage} from './pages'
+
+const props = defineProps<{
+  locale: string
+  modelValue: ShellPage
+  pages: readonly ShellPage[]
+  description?: string
+}>()
+const emit = defineEmits<{'update:modelValue': [value: ShellPage]}>()
+const copy = computed(() => shellCopy(props.locale))
+const icons: Record<ShellPage, Component> = {status:Info,sample:NotebookPen,nas:FolderOpen,interactive:MousePointerClick,background:Timer,admin:ListChecks,identity:KeyRound,folders:Shield}
+const groups = computed<AppSidebarGroup[]>(() => [{
+  items: props.pages.map(page => ({key:page,label:copy.value[page],icon:icons[page]})),
+}])
+const title = computed(() => copy.value[props.modelValue] ?? copy.value.status)
+</script>
+
+<template>
+  <AppLayout class="app-shell" min-height="0">
+    <template #sidebar>
+      <AppSidebar :model-value="modelValue" :groups="groups" @update:model-value="emit('update:modelValue', $event as ShellPage)" />
+    </template>
+    <PageContent class="app-page">
+      <PageHeader :title="title" :description="description">
+        <template #actions><slot name="actions" /></template>
+      </PageHeader>
+      <div class="app-page-content"><slot /></div>
+    </PageContent>
+  </AppLayout>
+</template>
+
+<style scoped>
+/* The library clips AppLayout at window height; the page body scrolls while
+   the sidebar keeps its own height. Modeled on syno-reclaim's AppShell. */
+.app-shell { height: 100%; min-width: 0; grid-template-rows: minmax(0, 1fr); }
+.app-shell :deep(> div) { min-height: 0; }
+.app-shell :deep(main) { display: flex; flex-direction: column; overflow: hidden; }
+.app-page { flex: 1 1 auto; min-height: 0; overflow-y: auto; }
+.app-page-content { padding-bottom: var(--ui-space-6, 24px); }
+</style>

package/templates/native-go-vue/frontend/src/shell/i18n/de.json

@@ -0,0 +1,10 @@
+{
+  "status": "Status",
+  "sample": "Meine Beispieldaten",
+  "nas": "NAS-Ordnerzugriff",
+  "interactive": "Interaktive Aufträge",
+  "background": "Hintergrundaufträge",
+  "admin": "Auftragsverwaltung",
+  "identity": "Optionale App-Identität",
+  "folders": "Ordnerauswahl"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/en.json

@@ -0,0 +1,10 @@
+{
+  "status": "Status",
+  "sample": "My sample data",
+  "nas": "NAS folder access",
+  "interactive": "Interactive jobs",
+  "background": "Background jobs",
+  "admin": "Job management",
+  "identity": "Optional app identity",
+  "folders": "Folder selections"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/es.json

@@ -0,0 +1,10 @@
+{
+  "status": "Estado",
+  "sample": "Mis datos de ejemplo",
+  "nas": "Acceso a carpetas NAS",
+  "interactive": "Tareas interactivas",
+  "background": "Tareas en segundo plano",
+  "admin": "Gestión de tareas",
+  "identity": "Identidad de aplicación opcional",
+  "folders": "Selección de carpetas"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/fr.json

@@ -0,0 +1,10 @@
+{
+  "status": "État",
+  "sample": "Mes données d'exemple",
+  "nas": "Accès aux dossiers NAS",
+  "interactive": "Tâches interactives",
+  "background": "Tâches en arrière-plan",
+  "admin": "Gestion des tâches",
+  "identity": "Identité d'application facultative",
+  "folders": "Sélection de dossiers"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/it.json

@@ -0,0 +1,10 @@
+{
+  "status": "Stato",
+  "sample": "I miei dati di esempio",
+  "nas": "Accesso alle cartelle NAS",
+  "interactive": "Attività interattive",
+  "background": "Attività in background",
+  "admin": "Gestione attività",
+  "identity": "Identità app opzionale",
+  "folders": "Selezione cartelle"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/ja.json

@@ -0,0 +1,10 @@
+{
+  "status": "ステータス",
+  "sample": "サンプルデータ",
+  "nas": "NAS フォルダーアクセス",
+  "interactive": "インタラクティブジョブ",
+  "background": "バックグラウンドジョブ",
+  "admin": "ジョブ管理",
+  "identity": "任意のアプリ ID",
+  "folders": "フォルダーの選択"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/ko.json

@@ -0,0 +1,10 @@
+{
+  "status": "상태",
+  "sample": "내 샘플 데이터",
+  "nas": "NAS 폴더 액세스",
+  "interactive": "대화형 작업",
+  "background": "백그라운드 작업",
+  "admin": "작업 관리",
+  "identity": "선택적 앱 ID",
+  "folders": "폴더 선택"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/zh-CN.json

@@ -0,0 +1,10 @@
+{
+  "status": "状态",
+  "sample": "我的示例数据",
+  "nas": "NAS 文件夹访问",
+  "interactive": "交互工作",
+  "background": "后台工作",
+  "admin": "工作管理",
+  "identity": "可选应用身份",
+  "folders": "文件夹选择"
+}

package/templates/native-go-vue/frontend/src/shell/i18n/zh-TW.json

@@ -0,0 +1,10 @@
+{
+  "status": "狀態",
+  "sample": "我的範例資料",
+  "nas": "NAS 資料夾存取",
+  "interactive": "互動工作",
+  "background": "背景工作",
+  "admin": "工作管理",
+  "identity": "選用應用程式身分",
+  "folders": "資料夾選取"
+}

package/templates/native-go-vue/frontend/src/shell/i18n.ts

@@ -0,0 +1,17 @@
+import en from './i18n/en.json'
+import zhTW from './i18n/zh-TW.json'
+import zhCN from './i18n/zh-CN.json'
+import ja from './i18n/ja.json'
+import ko from './i18n/ko.json'
+import de from './i18n/de.json'
+import fr from './i18n/fr.json'
+import es from './i18n/es.json'
+import it from './i18n/it.json'
+
+export type ShellCopy = typeof en
+export const shellCatalogs: Record<string, ShellCopy> = {en,'zh-TW':zhTW,'zh-CN':zhCN,ja,ko,de,fr,es,it}
+const aliases: Record<string,string> = {enu:'en',cht:'zh-TW',chs:'zh-CN',jpn:'ja',krn:'ko',ger:'de',fre:'fr',spn:'es',ita:'it'}
+export function shellCopy(locale: string): ShellCopy {
+  const normalized = locale.replaceAll('_','-')
+  return shellCatalogs[aliases[normalized] ?? normalized] ?? shellCatalogs[normalized.split('-')[0]!] ?? en
+}

package/templates/native-go-vue/frontend/src/shell/pages.ts

@@ -0,0 +1,34 @@
+// The DSM-style shell shows one sidebar entry per feature that this build
+// actually provides. The manifest is resolved at build time, so the entries
+// here are driven by runtime feature flags rather than by the YAML itself.
+export type ShellPage =
+  | 'status'
+  | 'sample'
+  | 'nas'
+  | 'interactive'
+  | 'background'
+  | 'admin'
+  | 'identity'
+  | 'folders'
+
+export interface ShellFeatureFlags {
+  sample?: boolean
+  nas?: boolean
+  interactive?: boolean
+  background?: boolean
+  admin?: boolean
+  identity?: boolean
+  folders?: boolean
+}
+
+/** 'status' is the integration/account page every Vue build has. */
+const ORDER: readonly ShellPage[] = ['status','sample','nas','interactive','background','admin','identity','folders']
+
+export function shellPages(features: ShellFeatureFlags): ShellPage[] {
+  return ORDER.filter(page => page === 'status' || features[page] === true)
+}
+
+/** Keeps a selection that still exists; otherwise the first page wins. */
+export function activePage(current: ShellPage | undefined, pages: readonly ShellPage[]): ShellPage {
+  return current !== undefined && pages.includes(current) ? current : (pages[0] ?? 'status')
+}

package/templates/native-go-vue/frontend/src/style.css

@@ -1,16 +1,12 @@
 .dsmapp-vue-root {height: 100%; min-height: 0; width: 100%; overflow: hidden;}
-[data-ui-app] .integration-app {padding: var(--ui-space-5, 20px); max-width: 72ch; color: var(--ui-text); font-family: var(--ui-font-sans); font-size: 13px; line-height: 1.5;}
-[data-ui-app] .integration-heading {display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 20px;}
-[data-ui-app] .integration-heading h1 {font-size: 20px; font-weight: 600; margin: 0;}
-[data-ui-app] .integration-heading p {color: var(--ui-text); margin: 4px 0 0;}
-[data-ui-app] .integration-app section {margin-top: 24px;}
+[data-ui-app] .integration-app {padding: 0 var(--ui-page-padding-x, 16px); color: var(--ui-text); font-family: var(--ui-font-sans); font-size: 13px; line-height: 1.5;}
+[data-ui-app] .integration-app section {margin-top: var(--ui-space-4, 16px);}
 [data-ui-app] .integration-status h2 {font-size: 15px; font-weight: 600; margin: 0;}
 [data-ui-app] .integration-status p {margin: 6px 0;}
 [data-ui-app] .integration-status dl {display: grid; grid-template-columns: max-content 1fr; gap: 4px 16px; margin: 12px 0;}
 [data-ui-app] .integration-status dt, [data-ui-app] .integration-help {color: var(--ui-text);}
 [data-ui-app] .integration-status dd {margin: 0;}
 [data-ui-app] .integration-actions {display: flex; flex-wrap: wrap; gap: 8px; margin-top: 16px;}
-[data-ui-app] .integration-field {display: grid; gap: 6px; margin: 12px 0;}
 [data-ui-app] .integration-notice {color: var(--ui-text);}
 [data-ui-app] .nas-summary {display: grid; grid-template-columns: minmax(6ch, max-content) minmax(0, 1fr); gap: var(--ui-space-2, 8px) var(--ui-space-4, 16px);}
 [data-ui-app] .nas-summary dd {margin: 0; overflow-wrap: anywhere;}