[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBEZABA41H1A08Y4A8DCJM":3,"skill-same:01M6CBEZABA41H1A08Y4A8DCJM":50},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":27,"frontMatter":28,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":13,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M6CBEZABA41H1A08Y4A8DCJM","10-canvas-panel",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F23-ui-package\u002F14-ui-page-system\u002F10-canvas-panel\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[23,24],"canvas","10 canvas panel","2026-11-10 10:12:30",false,"# 14-page-system — Canvas & Panel\n\nStatus: ACTIVE\nAppliesTo: v11\n\n---\n\n## Overview\n\nPage 시스템은 `UIBasePageCanvas`가 host 역할을 하고,\npage는 아래 4개 base로 분리된다.\n\n- `UIBasePagePanel : UIBasePanel`\n- `UIBasePageMain : UIBasePagePanel`\n- `UIBasePageSub : UIBasePagePanel`\n\n`UIBasePageCanvas.ShowPage()`는 main만 전환한다.\nsub는 각자 `Show()\u002FHide()`를 호출하지만 실제 owner 검증과 current 상태 관리는 canvas가 맡는다.\n\n---\n\n## Terms\n\n| Term | Definition |\n|------|------------|\n| **UIBasePageCanvas** | `currentMain\u002FcurrentSub`를 관리하는 page host |\n| **UIBasePageMain** | 좌우 transition을 갖는 navigation 대상 main page |\n| **UIBasePageSub** | 특정 main에 종속된 sub page |\n| **UIBasePagePanel** | main\u002Fsub 공통 `pageIndex` + `ownerCanvas` bridge |\n| **UIPageState** | `Hidden`, `Entering`, `Visible`, `Exiting` |\n| **UIPageTransitionDirection** | `None`, `Left`, `Right` |\n\n---\n\n## Policy\n\n### Main\n\n- `ShowPage()`는 `UIBasePageMain`만 대상으로 동작한다.\n- `currentMain`은 안정 상태에서 최대 1개다.\n- `pageIndex`가 작은 main이 left, 큰 main이 right다.\n- left 이동 규칙: enter from right, exit to left\n- right 이동 규칙: enter from left, exit to right\n\n### Sub\n\n- `UIBasePageSub.pageIndex`는 자신이 종속되는 main의 index다.\n- `sub.Show()`는 현재 main과 같은 `pageIndex`일 때만 유효하다.\n- sub show 시 current main은 즉시 숨겨진다. 애니메이션 없음.\n- sub hide 완료 후 current main은 즉시 복구된다. 애니메이션 없음.\n- 동시에 visible한 sub는 최대 1개다.\n\n### Main Switch\n\n- main 전환 전 current sub는 즉시 닫힌다.\n- sub 때문에 숨겨져 있던 old main은 전환 직전에 즉시 복구되어 exit transition에 참여한다.\n\n### Lifecycle\n\n- `UIBasePageCanvas`는 `onInitComplete()`에서 page 수집과 초기 정규화를 수행한다.\n- subclass가 `onInitComplete()`를 override하면 `base.onInitComplete()`를 호출해야 한다.\n- `initialPageIndex`는 main page 기준으로만 해석한다.\n\n---\n\n## Public API\n\n### UIBasePageCanvas\n\n```csharp\npublic abstract class UIBasePageCanvas : UIBaseCanvas\n{\n    public int initialPageIndex { get; }\n    public UIBasePageMain currentMain { get; }\n    public UIBasePageSub currentSub { get; }\n    public bool isTransitioningMain { get; }\n\n    public void ShowPage(int pageIndex, bool animated = true);\n    public void ShowPage(UIBasePageMain page, bool animated = true);\n    public bool TryGetMainPage(int pageIndex, out UIBasePageMain page);\n}\n```\n\n### UIBasePagePanel\n\n```csharp\npublic abstract class UIBasePagePanel : UIBasePanel\n{\n    public int pageIndex { get; }\n    public UIBasePageCanvas ownerCanvas { get; }\n}\n```\n\n### UIBasePageMain\n\n```csharp\n[RequireComponent(typeof(UITransitionPlayer))]\npublic abstract class UIBasePageMain : UIBasePagePanel\n{\n    public bool isCurrentMain { get; }\n    public UIPageState pageState { get; }\n}\n```\n\n### UIBasePageSub\n\n```csharp\n[RequireComponent(typeof(UITransitionPlayer))]\npublic abstract class UIBasePageSub : UIBasePagePanel\n{\n    public bool isCurrentSub { get; }\n\n    public new void Show();\n    public new void Hide();\n}\n```\n\n---\n\n## Sequence\n\n### Main Show\n\n```text\nShowPage(targetMain)\n├── currentSub 즉시 close\n├── old main 복구 (sub가 열려 있었던 경우)\n├── currentMain == null → target 즉시 표시\n└── old\u002Fnew main directional transition\n```\n\n### Sub Show\n\n```text\nsub.Show()\n├── ownerCanvas\u002FcurrentMain 검사\n├── pageIndex 일치 검사\n├── 기존 currentSub 즉시 close\n├── currentMain 즉시 hide\n└── sub show transition\n```\n\n---\n\n## Validation\n\n- main `pageIndex` 중복 금지\n- sub `pageIndex`는 대응 main이 반드시 존재해야 한다\n- main\u002Fsub는 same-GO `UITransitionPlayer`가 있어야 한다\n- `initialPageIndex >= 0`이면 대응 main이 존재해야 한다\n\n---\n\n## File Map\n\n```text\nAssets\u002FSamples\u002FDevian Foundation\u002F0.1.0\u002FUIPackage\u002FRuntime\u002FPage\u002F\n├── UIBasePageCanvas.cs\n├── UIBasePagePanel.cs\n├── UIBasePageMain.cs\n└── UIBasePageSub.cs\n```\n\n---\n\n## DoD\n\n- [ ] `ShowPage()`가 main만 전환한다\n- [ ] sub show\u002Fhide가 main hide\u002Frestore 규칙을 만족한다\n- [ ] main switch 시 old sub가 즉시 닫힌다\n- [ ] compile error가 0개다\n\n---\n\n## Reference\n\n- Overview: `..\u002F00-overview\u002FSKILL.md`\n- Design Note: `\u002FUsers\u002Fmaoshy\u002FDocuments\u002FProjects\u002Fdevian\u002Fdocs\u002Fui-base-page-design.md`\n- Base Canvas System: `..\u002F..\u002F10-base-system\u002F11-ui-canvas-system\u002FSKILL.md`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F23-ui-package\u002F14-ui-page-system\u002F10-canvas-panel","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add devwinsoft\u002Fdevian --skill 10-canvas-panel",{"tool":42,"command":43},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-canvas-panel",{"tool":45,"command":46},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-canvas-panel","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F23-ui-package\u002F14-ui-page-system\u002F10-canvas-panel\u002FSKILL.md",true,[],[51,57,65,73,82,89],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":25},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[53],{"skillNo":58,"name":59,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":25},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[63,64],"archive","90 project archive",{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":25},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[71,72],"management","30 env management",{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":25},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[79,80,81],"push","page","19 page push send",{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":25},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[80,88],"18 page savedata",{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":25},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[80,95],"17 page deobfuscate"]