@ash-qw/dsh-theme-prts 1.0.6 → 1.1.1

package/src/server/emblems.js

@@ -0,0 +1,153 @@
+import { mkdir, readFile, writeFile, rename, readdir, unlink } from 'node:fs/promises'
+import { join } from 'node:path'
+import { randomUUID, createHash } from 'node:crypto'
+import { Worker } from 'node:worker_threads'
+import { defaultEmblemConfiguration, validEmblemConfiguration } from '../client/custom-emblem.js'
+
+export const EMBLEMS = [
+  ['rhodes-island','罗德岛'],['lungmen','龙门'],['penguin-logistics','企鹅物流'],['rhine-lab','莱茵生命'],['reunion','整合运动'],
+].map(([key,label])=>({key,label}))
+export const API = '/prts-theme-api/emblems'
+export const DEFAULT_PARAMS = Object.freeze({mode:'auto',threshold:128,zoom:.85,x:0,y:0})
+export function fault(status,message) { return Object.assign(new Error(message),{status}) }
+export function parameters(input = {}, base = DEFAULT_PARAMS) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) throw fault(400,'编辑参数无效')
+  const result = {...base,...input}
+  if (Object.keys(result).some(k=>!Object.hasOwn(DEFAULT_PARAMS,k)) || !['auto','alpha','dark','light'].includes(result.mode)
+    || !Number.isInteger(result.threshold) || result.threshold<1 || result.threshold>254
+    || !Number.isFinite(result.zoom) || result.zoom<.5 || result.zoom>2
+    || !Number.isFinite(result.x) || Math.abs(result.x)>.5 || !Number.isFinite(result.y) || Math.abs(result.y)>.5) throw fault(400,'编辑参数超出范围')
+  return result
+}
+export function processImage(bytes, params, signal) {
+  signal?.throwIfAborted()
+  return new Promise((resolve,reject)=>{
+    const worker = new Worker(new URL('./image-worker.js',import.meta.url), {workerData:{bytes,params},execArgv:[]})
+    let settled = false
+    const finish = async (error,value) => {
+      if(settled)return; settled=true;clearTimeout(timer);signal?.removeEventListener('abort',abort)
+      await worker.terminate()
+      if(error)reject(error);else resolve(value)
+    }
+    const abort = ()=>void finish(signal.reason || new Error('已取消'))
+    const timer = setTimeout(()=>void finish(fault(408,'图片处理超时，请缩小图片后重试')),15000)
+    signal?.addEventListener('abort',abort,{once:true})
+    worker.once('error',error=>void finish(error))
+    worker.once('exit',code=>{if(!settled)void finish(new Error(`图片处理进程提前退出 (${code})`))})
+    worker.once('message',result=>void finish(result.error?fault(400,result.error):null,result))
+    if(signal?.aborted)abort()
+  })
+}
+async function atomic(path,value) {
+  const temp = `${path}.${randomUUID()}.tmp`
+  await writeFile(temp,value,{mode:0o600});await rename(temp,path)
+}
+const idPattern = /^[a-zA-Z0-9-]{1,80}$/
+export function checkedId(id) { if(typeof id!=='string'||!idPattern.test(id))throw fault(400,'徽记标识无效');return id }
+
+export async function createEmblemService(directory) {
+  await mkdir(directory,{recursive:true,mode:0o700})
+  let state = {revision:0,configuration:defaultEmblemConfiguration(EMBLEMS)}
+  try {
+    const stored=JSON.parse(await readFile(join(directory,'configuration.json'),'utf8'))
+    if(!Number.isInteger(stored.revision)||!validEmblemConfiguration(stored.configuration,EMBLEMS))throw Error('已保存的徽记配置无效')
+    state=stored
+  } catch(error) { if(error.code!=='ENOENT')throw error }
+  let queue=Promise.resolve(), processing=false
+  const listeners=new Set()
+  const serialize=fn=>{const next=queue.then(fn);queue=next.catch(()=>{});return next}
+  const snapshot=()=>structuredClone(state)
+  const draft=async id=>{
+    try{return JSON.parse(await readFile(join(directory,`${checkedId(id)}.draft.json`),'utf8'))}
+    catch(error){if(error.code==='ENOENT')throw fault(404,'草稿不存在');throw error}
+  }
+  const save = (configuration,revision,signal)=>serialize(async()=>{
+    signal?.throwIfAborted()
+    if(revision!==state.revision)throw fault(409,'徽记设置已在其他会话或页面更新，请重新读取后再操作')
+    if(configuration?.version!==2 || !Array.isArray(configuration.conversation) || configuration.conversation.length<1 || configuration.conversation.length>12)throw fault(400,'徽记配置无效')
+    // Custom entries must be generated by this service; clients cannot inject arbitrary particle arrays.
+    const canonical=structuredClone({version:2,hero:configuration.hero,conversation:configuration.conversation})
+    const resolveEntry=async entry=>{
+      if(!entry || typeof entry!=='object')throw fault(400,'徽记配置无效')
+      if(entry.kind==='builtin')return {kind:'builtin',...EMBLEMS.find(e=>e.key===entry.key)}
+      if(entry.kind!=='custom')throw fault(400,'徽记类型无效')
+      const source=await draft(entry.draftId)
+      return {...source.value,kind:'custom',key:entry.key,label:entry.label,draftId:source.id}
+    }
+    if(canonical.hero)canonical.hero=await resolveEntry(canonical.hero)
+    canonical.conversation=await Promise.all(canonical.conversation.map(resolveEntry))
+    if(!validEmblemConfiguration(canonical,EMBLEMS))throw fault(400,'徽记配置无效')
+    const next={revision:state.revision+1,configuration:canonical}
+    signal?.throwIfAborted();await atomic(join(directory,'configuration.json'),JSON.stringify(next));state=next
+    for(const fn of listeners) {try{fn(state.revision)}catch{}}
+    return snapshot()
+  })
+  return {
+    snapshot,save,draft,
+    async exportAsset(id) {
+      const d=await draft(id)
+      const bytes=await readFile(join(directory,`${d.sourceId}.source`))
+      return {format:'prts-emblem',version:1,label:d.label,params:d.params,image:bytes.toString('base64')}
+    },
+    async importAsset(asset,signal) {
+      if(asset?.format!=='prts-emblem'||asset.version!==1)throw fault(400,'不支持的徽记素材包格式或版本')
+      if(typeof asset.label!=='string'||!asset.label.trim()||asset.label.length>100)throw fault(400,'徽记名称无效')
+      if(typeof asset.image!=='string'||!asset.image.length||asset.image.length>Math.ceil(8*1024*1024/3)*4
+        || !/^[A-Za-z0-9+/]+={0,2}$/.test(asset.image)||asset.image.length%4!==0)throw fault(400,'素材包图片编码或大小无效')
+      const bytes=Buffer.from(asset.image,'base64')
+      if(bytes.toString('base64')!==asset.image)throw fault(400,'素材包图片编码无效')
+      // Rebuild from the editable source; never trust particle arrays or filesystem paths in a package.
+      return this.preview({bytes,params:parameters(asset.params),label:asset.label},signal)
+    },
+    previewPath: id=>join(directory,`${checkedId(id)}.png`),
+    subscribe(fn){listeners.add(fn);return()=>listeners.delete(fn)},
+    async preview({bytes,params={},baseId,label},signal) {
+      if(processing)throw fault(409,'正在处理另一张徽记，请稍后重试')
+      processing=true
+      try {
+        const previous=baseId?await draft(baseId):null
+        const effective=parameters(params,previous?.params)
+        if(previous)bytes=await readFile(join(directory,`${previous.sourceId}.source`))
+        if(!bytes?.length || bytes.length>8*1024*1024)throw fault(400,'图片须为 8 MB 以内的 PNG、JPEG 或 WebP')
+        const drafts=(await readdir(directory)).filter(f=>f.endsWith('.draft.json'))
+        if(drafts.length>=200)await serialize(async()=>{
+          const protectedIds=new Set([previous?.id,state.configuration.hero?.draftId,...state.configuration.conversation.map(e=>e.draftId)])
+          const records=await Promise.all(drafts.map(file=>draft(file.slice(0,-11))))
+          const expired=records.filter(d=>!protectedIds.has(d.id)).sort((a,b)=>a.createdAt-b.createdAt).slice(0,drafts.length-199)
+          const expiredIds=new Set(expired.map(d=>d.id))
+          const retainedSources=new Set(records.filter(d=>!expiredIds.has(d.id)).map(d=>d.sourceId))
+          for(const d of expired){await unlink(join(directory,`${d.id}.draft.json`));await unlink(join(directory,`${d.id}.png`))}
+          for(const sourceId of new Set(expired.map(d=>d.sourceId)))if(!retainedSources.has(sourceId))await unlink(join(directory,`${sourceId}.source`))
+        })
+        const result=await processImage(bytes,effective,signal)
+        signal?.throwIfAborted()
+        const id=randomUUID(),sourceId=createHash('sha256').update(bytes).digest('hex')
+        const value={id,sourceId,params:effective,label:String(label||previous?.label||'自定义徽记').slice(0,100),createdAt:Date.now(),value:result.value}
+        await atomic(join(directory,`${sourceId}.source`),bytes)
+        await atomic(join(directory,`${id}.png`),result.preview)
+        await atomic(join(directory,`${id}.draft.json`),JSON.stringify(value))
+        return value
+      } finally {processing=false}
+    },
+    async image(id,source=false) {const d=await draft(id);return readFile(join(directory,source?`${d.sourceId}.source`:`${d.id}.png`))},
+    async apply({draftId,target,entryKey,revision},signal) {
+      const d=await draft(draftId),configuration=snapshot().configuration
+      const entry={...d.value,kind:'custom',key:randomUUID(),label:d.label,draftId:d.id}
+      if(target==='hero')configuration.hero=entry
+      else if(target==='add')configuration.conversation.push(entry)
+      else if(target==='replace') {
+        const index=configuration.conversation.findIndex(e=>e.key===entryKey)
+        if(index<0)throw fault(404,'要替换的正文徽记不存在')
+        configuration.conversation[index]=entry
+      } else throw fault(400,'应用位置无效')
+      return save(configuration,revision,signal)
+    },
+  }
+}
+export function draftView(d) {
+  return {draftId:d.id,label:d.label,params:d.params,particles:Object.fromEntries(Object.entries(d.value.targets).map(([k,v])=>[k,v.length])),previewUrl:`${API}/draft/${d.id}/preview.png`}
+}
+export function stateView(state) {
+  const entry=e=>e?{key:e.key,label:e.label,kind:e.kind,...(e.draftId?{draftId:e.draftId}:{})}:null
+  return {revision:state.revision,scope:'当前 DSH 实例，跨工作区和会话共享',hero:entry(state.configuration.hero),conversation:state.configuration.conversation.map(entry)}
+}

package/src/server/image-worker.js

@@ -0,0 +1,32 @@
+import { parentPort, workerData } from 'node:worker_threads'
+import sharp from 'sharp'
+import { processCustomEmblemPixels } from '../client/custom-emblem.js'
+
+try {
+  const { bytes, params } = workerData
+  const image = sharp(Buffer.from(bytes), { limitInputPixels: 16000000, failOn: 'error' }).rotate()
+  const metadata = await image.metadata()
+  if (!['png','jpeg','webp'].includes(metadata.format)) throw new Error('仅支持 PNG、JPEG、WebP 图片')
+  const { data, info } = await image.ensureAlpha().raw().toBuffer({ resolveWithObject: true })
+  let mode = params.mode
+  if (mode === 'auto') {
+    mode = 'dark'
+    for (let i = 3; i < data.length; i += 4) if (data[i] < 128) { mode = 'alpha'; break }
+  }
+  const scale = 320 / Math.max(info.width, info.height) * params.zoom
+  const width = Math.max(1, Math.round(info.width * scale)), height = Math.max(1, Math.round(info.height * scale))
+  const resized = await sharp(data, { raw: info }).resize(width, height).raw().toBuffer()
+  const rgba = new Uint8ClampedArray(320 * 320 * 4)
+  const left = Math.round((320-width)/2 + params.x*320), top = Math.round((320-height)/2 + params.y*320)
+  for (let y = Math.max(0,top); y < Math.min(320,top+height); y++) {
+    const x = Math.max(0,left), end = Math.min(320,left+width)
+    if (end > x) rgba.set(resized.subarray(((y-top)*width+x-left)*4,((y-top)*width+end-left)*4),(y*320+x)*4)
+  }
+  const value = processCustomEmblemPixels(rgba,320,mode,params.threshold)
+  const dots = value.targets.standard.map(p => {
+    const r = p.kind === 'skeleton' ? 1.2 : .9
+    return `<circle cx="${192+p.x*350}" cy="${192+p.y*350}" r="${r}"/>`
+  }).join('')
+  const preview = await sharp(Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="384" height="384"><rect width="384" height="384" fill="#0d1114"/><g fill="#edf1f2">${dots}</g></svg>`)).png().toBuffer()
+  parentPort.postMessage({ value, preview })
+} catch (error) { parentPort.postMessage({ error: error.message }) }

package/src/server/tools.js

@@ -0,0 +1,67 @@
+import { draftView, stateView, fault } from './emblems.js'
+
+export function sessionImages(agent) {
+  if(!agent?.session)throw fault(400,'请在 DSH 会话中调用此工具')
+  const images=new Map()
+  for(const event of agent.session.snapshotEvents()) {
+    if(event.type!=='user/message')continue
+    for(const part of event.data.content ?? [])if(part.attachment && (part.type==='image' || part.type==='file' && /\.(png|jpe?g|webp)$/i.test(part.attachment.name || '')))images.set(part.attachment.attachmentId,{...part.attachment,attachmentKind:part.type})
+  }
+  return [...images.values()]
+}
+export function emblemTools(service,attachments) {
+  const output={schema:{type:'object'},render:(_args,value)=>[{type:'text',text:JSON.stringify(value)},...(value.previewImage&&value.imageForModel?[{type:'image',attachment:value.previewImage}]:[])]}
+  return [{
+    name:'prts_emblem_inspect',
+    description:'查看 PRTS 主题的新会话徽记、正文轮换列表、配置版本，以及当前会话已上传的图片。仅当用户要求查看或调整主题徽记时使用。徽记设置跨工作区和会话共享；工具不会修改设置。',
+    parameters:{type:'object',properties:{},additionalProperties:false},output,isConcurrencySafe:()=>true,
+    async execute(_args,exec){return JSON.parse(JSON.stringify({...stateView(service.snapshot()),images:sessionImages(exec.agent)}))}
+  },{
+    name:'prts_emblem_preview',
+    description:'将当前会话上传的图片制作成 PRTS 粒子徽记草稿，或继续调整已有草稿。传 attachmentId（来自 inspect）或 draftId，二选一。调整已有正式徽记可使用 inspect 返回的 draftId。仅生成预览，不应用。优先原样使用返回的 previewMarkdown 展示给用户；没有此字段时，告知用户可展开工具卡片查看。不要将 previewUrl 当成本地图片路径。标准密度预览不是原图。用户满意后使用 apply。不要声称已看到预览，除非实际通过视觉工具查看。',
+    parameters:{type:'object',additionalProperties:false,properties:{
+      attachmentId:{type:'string'},draftId:{type:'string'},label:{type:'string',maxLength:100},
+      params:{type:'object',additionalProperties:false,properties:{mode:{type:'string',enum:['auto','alpha','dark','light']},threshold:{type:'integer',minimum:1,maximum:254},zoom:{type:'number',minimum:.5,maximum:2},x:{type:'number',minimum:-.5,maximum:.5},y:{type:'number',minimum:-.5,maximum:.5}}},
+    }},output,isConcurrencySafe:()=>false,
+    async execute(args,exec){
+      const images=sessionImages(exec.agent)
+      if(Boolean(args.attachmentId)===Boolean(args.draftId))throw fault(400,'请选择一张会话图片或一个已有草稿')
+      let bytes,label=args.label
+      if(args.attachmentId) {
+        const ref=images.find(e=>e.attachmentId===args.attachmentId)
+        if(!ref)throw fault(404,'当前会话没有这张图片，请先上传图片或重新读取图片列表')
+        if(ref.bytes>8*1024*1024)throw fault(400,'图片超过 8 MB')
+        const {attachmentKind,...attachment}=ref
+        if(attachmentKind==='file') {
+          const chunks=[];let total=0
+          for await(const chunk of attachments.readFileStream(attachment,exec.signal)) {
+            total+=chunk.length;if(total>8*1024*1024)throw fault(400,'图片超过 8 MB');chunks.push(chunk)
+          }
+          bytes=Buffer.concat(chunks)
+        } else bytes=(await attachments.readImage(attachment,exec.signal)).data
+        label ||= ref.name
+      }
+      const d=await service.preview({bytes,baseId:args.draftId,params:args.params,label},exec.signal)
+      const hostPath=service.previewPath(d.id)
+      const fs=exec.agent.ctx?.get?.('fs')
+      const previewPath=fs?.processPathFromHostPath(hostPath)
+      let previewImage, imageForModel=false
+      const llm=exec.agent.ctx?.get?.('llm')
+      const routed=exec.agent.session.requestHeader?.()?.config
+      const provider=routed?.provider ?? exec.agent.options?.provider, model=routed?.model ?? exec.agent.options?.model
+      if(llm && provider && model) {
+        const info=await llm.resolveModelInfo(provider,model,exec.signal)
+        imageForModel=info.inputModalities?.includes('image') === true
+      }
+      if(imageForModel)previewImage=await attachments.saveImage({data:await service.image(d.id),mediaType:'image/png',name:`prts-preview-${d.id}.png`})
+      return JSON.parse(JSON.stringify({...draftView(d),applied:false,revision:service.snapshot().revision,
+        ...(previewPath?{previewPath,previewMarkdown:`![粒子徽记预览](<${previewPath}>)`}:{}),
+        imageForModel,...(previewImage?{previewImage}:{})}))
+    },
+  },{
+    name:'prts_emblem_apply',
+    description:'按用户要求应用 PRTS 粒子徽记草稿。hero 替换新会话徽记；add 添加正文轮换徽记；replace 替换 entryKey 对应的正文徽记。先 inspect 取得 revision；版本冲突时重新读取并核对，不能盲目重试覆盖。只有用户明确要求应用时才调用，讨论或预览不等于应用。',
+    parameters:{type:'object',additionalProperties:false,properties:{draftId:{type:'string'},target:{type:'string',enum:['hero','add','replace']},entryKey:{type:'string'},revision:{type:'integer',minimum:0}},required:['draftId','target','revision']},output,isConcurrencySafe:()=>false,
+    async execute(args,exec){sessionImages(exec.agent);return {applied:true,...stateView(await service.apply(args,exec.signal))}},
+  }]
+}

package/src/styles/cursor.css

@@ -15,7 +15,13 @@
   html[data-dsh-prts][data-prts-cursor="prts"] :is(textarea, input:not([type]), input[type="text"], input[type="search"], input[type="email"], input[type="url"], input[type="password"], input[type="number"], input[type="tel"], [contenteditable=""], [contenteditable="true"], [contenteditable="plaintext-only"]) {
     cursor: var(--prts-text-cursor), text;
   }
+  html[data-dsh-prts][data-prts-cursor="prts"] :is(.dsh-partner-pendant-hit, .dsh-partner-pendant-anchor, [data-prts-emblem-reorder]):enabled {
+    cursor: url("__PRTS_GRAB__") 22 19, grab;
+  }
+  html[data-dsh-prts][data-prts-cursor="prts"] :is(.dsh-partner-pendant-hit, .dsh-partner-pendant-anchor, [data-prts-emblem-reorder]):enabled:active {
+    cursor: url("__PRTS_GRABBING__") 22 19, grabbing;
+  }
   html[data-dsh-prts][data-prts-cursor="prts"] :is(:disabled, [aria-disabled="true"]) {
-    cursor: not-allowed !important;
+    cursor: url("__PRTS_NOT_ALLOWED__") 7 7, not-allowed !important;
   }
 }

package/src/styles/prts.css

@@ -1461,14 +1461,6 @@ html[data-dsh-prts] [data-prts-particle-layer] {
   transition: opacity 120ms ease-out;
 }
 
-/* Keep the host frame measurable while pruning the expensive operation subtree
-   during a viewport resize burst. Navigation and the native sessions sidebar
-   remain rendered; the shield is removed after the viewport settles. */
-html[data-dsh-prts] [data-prts-resize-shield] {
-  content-visibility: hidden !important;
-  contain-intrinsic-size: auto 800px;
-}
-
 /* Resize state lives on the small visual surfaces that need it, never on the root tree. */
 html[data-dsh-prts] [data-prts-particle-layer][data-prts-resizing] {
   opacity: .78;

package/src/styles/refinement.css

@@ -203,8 +203,8 @@ html[data-dsh-prts] [data-prts-composer-fallback]::after {
     calc(100% - 2px) 0, 100% 2px, 100% calc(100% - 2px), calc(100% - 2px) 100%,
     2px 100%, 0 calc(100% - 2px), 0 2px
   );
-  backdrop-filter: var(--prts-active-glass-filter);
-  -webkit-backdrop-filter: var(--prts-active-glass-filter);
+  backdrop-filter: none;
+  -webkit-backdrop-filter: none;
   pointer-events: none;
 }
 

package/src/styles/theme-settings-workbench.css

@@ -187,7 +187,7 @@ html[data-dsh-prts] [data-prts-settings-common] > header {
 
 html[data-dsh-prts] [data-prts-settings-presets] > header span,
 html[data-dsh-prts] [data-prts-settings-common] > header span,
-html[data-dsh-prts] [data-prts-settings-advanced] summary > span {
+html[data-dsh-prts] [data-prts-settings-advanced] > [data-prts-section-heading] > span {
   display: flex;
   align-items: baseline;
   gap: 9px;
@@ -195,7 +195,7 @@ html[data-dsh-prts] [data-prts-settings-advanced] summary > span {
 
 html[data-dsh-prts] [data-prts-settings-presets] > header strong,
 html[data-dsh-prts] [data-prts-settings-common] > header strong,
-html[data-dsh-prts] [data-prts-settings-advanced] summary strong {
+html[data-dsh-prts] [data-prts-settings-advanced] > [data-prts-section-heading] strong {
   font: 800 13px/1 var(--prts-display);
   letter-spacing: .05em;
 }
@@ -459,31 +459,16 @@ html[data-dsh-prts] [data-prts-theme-settings] input:focus-visible {
   outline-offset: 2px;
 }
 
-html[data-dsh-prts] [data-prts-settings-advanced] summary {
+html[data-dsh-prts] [data-prts-settings-advanced] > [data-prts-section-heading] {
   min-height: 52px;
   display: flex;
   align-items: center;
   justify-content: space-between;
   gap: 12px;
   padding: 11px;
-  cursor: pointer;
   list-style: none;
 }
 
-html[data-dsh-prts] [data-prts-settings-advanced] summary::-webkit-details-marker { display: none; }
-html[data-dsh-prts] [data-prts-settings-advanced] summary::after {
-  content: "+";
-  width: 24px;
-  height: 24px;
-  display: grid;
-  place-items: center;
-  margin-left: 2px;
-  border: 1px solid var(--prts-line);
-  color: var(--prts-cyan);
-  font: 800 13px/1 var(--prts-mono);
-}
-
-html[data-dsh-prts] [data-prts-settings-advanced][open] summary::after { content: "−"; }
 html[data-dsh-prts] [data-prts-settings-advanced-content] {
   display: grid;
   grid-template-columns: minmax(0, 1fr);
@@ -559,39 +544,6 @@ html[data-dsh-prts] [data-prts-setting-range-row] input[type="range"] {
   flex: 1;
 }
 html[data-dsh-prts] [data-prts-setting-range] { accent-color: var(--prts-cyan); }
-html[data-dsh-prts] [data-prts-settings-actions] {
-  min-height: 58px;
-  display: block;
-  padding: 0;
-  border-bottom: 1px solid var(--prts-line-strong);
-}
-
-html[data-dsh-prts] [data-prts-persistence-error],
-html[data-dsh-prts] [data-prts-reset-zone] {
-  min-height: 58px;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 9px 11px;
-}
-
-html[data-dsh-prts] [data-prts-persistence-error] { border-bottom: 1px solid var(--prts-yellow); background: color-mix(in srgb, var(--prts-yellow) 7%, transparent); }
-html[data-dsh-prts] [data-prts-persistence-error] > span,
-html[data-dsh-prts] [data-prts-reset-zone] > span { display: grid; gap: 4px; }
-html[data-dsh-prts] [data-prts-persistence-error] strong { color: var(--prts-yellow); }
-html[data-dsh-prts] [data-prts-reset-visual],
-html[data-dsh-prts] [data-prts-reset-confirm-action] { color: var(--prts-yellow); box-shadow: inset 0 0 0 1px var(--prts-yellow); }
-
-html[data-dsh-prts] [data-prts-reset-confirm] {
-  display: flex;
-  align-items: center;
-  justify-content: flex-end;
-  gap: 5px;
-  color: var(--prts-yellow);
-  font: 700 8px/1.3 var(--prts-mono);
-}
-
 html[data-dsh-prts] [hidden] { display: none !important; }
 
 /* Readable settings typography: information never drops below 12px. */
@@ -615,7 +567,7 @@ html[data-dsh-prts] :is(
 html[data-dsh-prts] :is(
   [data-prts-settings-presets] > header strong,
   [data-prts-settings-common] > header strong,
-  [data-prts-settings-advanced] summary strong,
+  [data-prts-settings-advanced] > [data-prts-section-heading] strong,
   [data-prts-preset-card] strong,
   [data-prts-settings-common] [data-prts-setting-row] > span > strong,
   [data-prts-settings-advanced-content] section > header strong,
@@ -812,7 +764,7 @@ html[data-dsh-prts] [data-prts-theme-settings] :is([data-prts-settings-presets],
   border: 0;
 }
 html[data-dsh-prts] [data-prts-theme-settings] :is([data-prts-settings-presets], [data-prts-settings-common]) > header strong,
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced] summary strong {
+html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced] > [data-prts-section-heading] strong {
   font: 650 16px/1.5 var(--prts-body);
   letter-spacing: 0;
 }
@@ -869,16 +821,31 @@ html[data-dsh-prts] [data-prts-theme-settings] button[data-prts-setting-key].is-
   border-color: color-mix(in srgb, var(--prts-yellow) 70%, transparent);
   color: var(--prts-ink);
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-setting-row="sessionFlowPalette"] > div { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-setting-row="sessionFlowColors"] { grid-template-columns: minmax(0, 1fr); }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced] { border-top: 1px solid var(--prts-line); }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced] summary { padding: 22px 0; }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced] summary::after { border: 0; color: var(--prts-muted); }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced-content] { border: 0; }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced-content] > section { padding: 0 0 20px; }
-html[data-dsh-prts] [data-prts-theme-settings] :is([data-prts-advanced-summary], [data-prts-session-flow-speed-output], [data-prts-particle-traversal-output]) { color: var(--prts-muted); font-size: 12px; font-weight: 400; }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-actions] { padding-top: 24px; border-top: 1px solid var(--prts-line); }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-reset-zone] { padding: 0; }
+html[data-dsh-prts] [data-prts-theme-settings] {
+& [data-prts-setting-row="sessionFlowPalette"] > div { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); }
+& [data-prts-setting-row="sessionFlowColors"] { grid-template-columns: minmax(0, 1fr); }
+& [data-prts-settings-advanced] { border-top: 1px solid var(--prts-line); }
+& [data-prts-settings-advanced] > [data-prts-section-heading] { padding: 22px 0; }
+& [data-prts-settings-section][hidden] { display: none !important; }
+& [data-prts-settings-advanced-content] { border: 0; }
+& [data-prts-settings-advanced-content] > section { padding: 0 0 20px; }
+& :is([data-prts-advanced-summary], [data-prts-session-flow-speed-output], [data-prts-particle-traversal-output]) { color: var(--prts-muted); font-size: 12px; font-weight: 400; }
+& [data-prts-settings-sidebar] { display:flex; flex-direction:column; min-height:0; position:relative; border-right:1px solid var(--prts-line); }
+& [data-prts-settings-nav] { border:0; background:none; }
+& [data-prts-settings-actions] { margin:auto 0 0; padding:14px; border:0; min-height:0; }
+& [data-prts-reset-zone] { min-height:0; }
+& [data-prts-reset-visual] { color:var(--prts-muted); box-shadow:none; background:none; font-size:12px; }
+& [data-prts-reset-confirm], & [data-prts-persistence-error] { display:flex; gap:8px; align-items:center; position:absolute; left:12px; bottom:52px; width:270px; padding:16px; border:1px solid var(--prts-line); border-radius:6px; background:var(--prts-panel-raised); box-shadow:0 8px 24px #0004; z-index:5; flex-wrap:wrap; font:400 12px/1.6 var(--prts-body); }
+& [data-prts-reset-confirm] > span { flex-basis:100%; }
+@media(max-width:720px) {
+& [data-prts-settings-sidebar] { flex-direction:row; border:0; border-bottom:1px solid var(--prts-line); }
+& [data-prts-settings-nav] { flex:1; padding:8px 4px; border:0; }
+& [data-prts-settings-jump] { padding:10px 8px; }
+& [data-prts-settings-actions] { margin:0; padding:8px 4px; align-self:center; }
+& [data-prts-reset-confirm], & [data-prts-persistence-error] { left:auto; right:8px; top:100%; bottom:auto; max-width:calc(100vw - 32px); }
+}
+& [data-prts-reset-zone] { padding: 0; }
+}
 @media (max-width: 720px) {
   html[data-dsh-prts] [data-prts-theme-settings] { width: 100vw; height: 100dvh; max-height: none; }
   html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-frame] { border-radius: 0; }
@@ -894,12 +861,13 @@ html[data-dsh-prts] [data-prts-theme-settings] [data-prts-reset-zone] { padding:
   html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-common] [data-prts-setting-row]:has(> [data-prts-setting-switch]) { grid-template-columns: minmax(0, 1fr) auto; gap: 20px; }
 }
 
+html[data-dsh-prts] [data-prts-theme-settings] {
 /* Four navigation destinations, each with one continuous settings surface. */
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-theme-settings-scroll] {
+& [data-prts-theme-settings-scroll] {
   padding: 20px 24px 28px;
   background: var(--prts-canvas);
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] {
+& [data-prts-settings-section] {
   margin: 0 0 28px;
   padding: 0 20px 8px;
   border: 1px solid var(--prts-line);
@@ -907,7 +875,7 @@ html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] {
   background: var(--prts-panel);
   scroll-margin-top: 16px;
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [data-prts-section-heading] {
+& [data-prts-settings-section] > [data-prts-section-heading] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -920,44 +888,73 @@ html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [d
   border-radius: 5px 5px 0 0;
   background: var(--prts-panel-raised);
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [data-prts-section-heading] > span {
+& [data-prts-settings-section] > [data-prts-section-heading] > span {
   display: grid;
   gap: 5px;
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [data-prts-section-heading] strong {
+& [data-prts-settings-section] > [data-prts-section-heading] strong {
   font: 650 18px/1.4 var(--prts-body);
   letter-spacing: 0;
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [data-prts-section-heading] small {
+& [data-prts-settings-section] > [data-prts-section-heading] small {
   color: var(--prts-muted);
   font: 400 12px/1.5 var(--prts-body);
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section="appearance"] > section {
+& [data-prts-settings-section="appearance"] > section {
   margin-bottom: 8px;
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section="appearance"] > section > header {
+& [data-prts-settings-section="appearance"] > section > header {
   padding: 16px 0 10px;
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section="appearance"] > section > header strong {
+& [data-prts-settings-section="appearance"] > section > header strong {
   font-size: 13px;
   color: var(--prts-muted);
 }
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced]:not([open]) {
-  padding-bottom: 0;
-}
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-advanced]:not([open]) > summary {
-  margin-bottom: 0;
-  border-bottom: 0;
-  border-radius: 5px;
-}
-html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-jump][aria-current="location"] {
+& [data-prts-settings-jump][aria-selected="true"] {
   color: var(--prts-ink);
   background: var(--prts-panel-raised);
   box-shadow: inset 3px 0 var(--prts-yellow);
 }
 @media (max-width: 720px) {
-  html[data-dsh-prts] [data-prts-theme-settings] [data-prts-theme-settings-scroll] { padding: 16px 12px 24px; }
-  html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] { padding-inline: 14px; margin-bottom: 24px; }
-  html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-section] > [data-prts-section-heading] { margin-inline: -14px; padding-inline: 14px; flex-wrap: wrap; gap: 4px 12px; }
-  html[data-dsh-prts] [data-prts-theme-settings] [data-prts-settings-jump][aria-current="location"] { box-shadow: inset 0 -3px var(--prts-yellow); }
+  & [data-prts-theme-settings-scroll] { padding: 16px 12px 24px; }
+  & [data-prts-settings-section] { padding-inline: 14px; margin-bottom: 24px; }
+  & [data-prts-settings-section] > [data-prts-section-heading] { margin-inline: -14px; padding-inline: 14px; flex-wrap: wrap; gap: 4px 12px; }
+  & [data-prts-settings-jump][aria-selected="true"] { box-shadow: inset 0 -3px var(--prts-yellow); }
+}
+
+& [data-prts-custom-emblem] {
+  display: grid;
+  gap: 14px;
+  padding-block: 16px 24px;
+  border-bottom: 1px solid var(--prts-line);
+  margin-bottom: 20px;
+}
+& [data-prts-custom-emblem] header { display: grid; gap: 6px; }
+& [data-prts-custom-emblem] :is(small, p) { font: 400 12px/1.6 var(--prts-body); color: var(--prts-muted); margin: 0; }
+& [data-prts-custom-emblem] label { display: grid; grid-template-columns: 110px minmax(0, 1fr); align-items: center; gap: 12px; font-size: 13px; }
+& [data-prts-emblem-editor] { display: grid; gap: 14px; }
+& [data-prts-custom-emblem] :is(input,select) { min-width: 0; max-width: 100%; }
+& [data-prts-custom-emblem] select { padding: 8px; background: var(--prts-panel-raised); color: var(--prts-ink); border: 1px solid var(--prts-line); }
+& [data-prts-emblem-preview] { width: min(100%, 280px); height: auto; justify-self: center; border: 1px solid var(--prts-line); border-radius: 4px; }
+& [data-prts-emblem-actions] { display: flex; flex-wrap: wrap; gap: 10px; }
+& [data-prts-emblem-actions] button { padding: 10px 14px; border: 1px solid var(--prts-line); border-radius: 4px; color: var(--prts-ink); background: var(--prts-panel-raised); }
+& [data-prts-emblem-actions] button:disabled { opacity: .45; }
+& [data-prts-custom-emblem] h4 { margin: 8px 0 12px; font: 600 14px/1.5 var(--prts-body); }
+& [data-prts-emblem-list] { display: grid; gap: 10px; list-style: none; padding: 0; margin: 14px 0; }
+& :is([data-prts-emblem-list] > li, [data-prts-emblem-hero-row]) { display: flex; align-items: center; flex-wrap: wrap; gap: 10px; padding: 12px; border: 1px solid var(--prts-line); border-radius: 4px; }
+& :is([data-prts-emblem-list], [data-prts-emblem-hero-row]) canvas { width: 48px; height: 48px; flex: none; border-radius: 3px; }
+& :is([data-prts-emblem-list] > li, [data-prts-emblem-hero-row]) > span { flex: 1; min-width: 100px; overflow-wrap: anywhere; font-size: 13px; }
+& [data-emblem-action] { padding: 7px 10px; border: 1px solid var(--prts-line); border-radius: 4px; background: var(--prts-panel-raised); color: var(--prts-ink); }
+& [data-emblem-action]:disabled { opacity: .4; }
+& [data-prts-emblem-reorder] { padding: 0; border: 0; background: transparent; cursor: grab; }
+& [data-emblem-key] {user-select:none;-webkit-touch-callout:none}
+& [data-prts-emblem-reorder]:focus-visible { outline: 2px solid var(--prts-ink); outline-offset: 3px; }
+& [data-prts-emblem-sorting] { user-select: none; }
+& [data-prts-emblem-dragging] { opacity: .35; border-style: dashed !important; }
+& [data-prts-emblem-drag-ghost] { background: var(--prts-panel-raised); box-shadow: 0 8px 28px #0005; opacity: .95; }
+& [data-prts-emblem-workspace] { display: grid; gap: 14px; padding: 16px 0; border-top: 1px solid var(--prts-line); }
+@media (max-width:720px) {
+  & [data-prts-emblem-list] [data-prts-emblem-actions] { flex-basis: 100%; gap: 5px; }
+}
+
 }

package/src/client/resize-shield-adapter.js

@@ -1,69 +0,0 @@
-const RESIZE_SHIELD_ATTRIBUTE = 'data-prts-resize-shield'
-const DEFAULT_SETTLE_DELAY = 180
-
-export function createResizeShieldAdapter({
-  window,
-  settleDelay = DEFAULT_SETTLE_DELAY,
-} = {}) {
-  let targets = []
-  let settleTimer
-  let started = false
-
-  function setActive(active) {
-    for (const node of targets) {
-      if (!node || node.hasAttribute?.(RESIZE_SHIELD_ATTRIBUTE) === active) continue
-      node.toggleAttribute?.(RESIZE_SHIELD_ATTRIBUTE, active)
-    }
-  }
-
-  function clearTimer() {
-    if (settleTimer === undefined) return
-    window?.clearTimeout?.(settleTimer)
-    settleTimer = undefined
-  }
-
-  function settle() {
-    settleTimer = undefined
-    setActive(false)
-  }
-
-  function onResize() {
-    if (!started) return
-    if (Number(window?.innerWidth) <= 640) {
-      clearTimer()
-      setActive(false)
-      return
-    }
-    setActive(true)
-    clearTimer()
-    settleTimer = window?.setTimeout?.(settle, settleDelay)
-  }
-
-  function dispose() {
-    clearTimer()
-    window?.removeEventListener?.('resize', onResize)
-    setActive(false)
-    targets = []
-    started = false
-  }
-
-  return {
-    start(nextTargets = []) {
-      const resolved = [...new Set(nextTargets)].filter(Boolean)
-      if (!window || !resolved.length) {
-        dispose()
-        return false
-      }
-      if (started) {
-        clearTimer()
-        setActive(false)
-        window.removeEventListener?.('resize', onResize)
-      }
-      targets = resolved
-      started = true
-      window.addEventListener?.('resize', onResize, { passive: true })
-      return true
-    },
-    dispose,
-  }
-}