@h-ai/cli 0.1.0-alpha9 → 1.0.0-beta.2

package/templates/apps/fullstack/packages/{{projectName}}-shared/messages/ja-JP.json.hbs

@@ -0,0 +1,164 @@
+{{! @skipIfEmpty }}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "settings_title": "個人設定",
+  "settings_language": "言語",
+  "settings_theme": "テーマ",
+  "theme_high_contrast": "ハイコントラスト",
+  "theme_formal": "ビジネス（角丸なし）",
+  "home_refresh": "更新",
+  "home_loading": "読み込み中…",
+  "home_error": "APIサービスに接続できません",
+  "business_settings_title": "業務基本設定",
+  "business_notice_label": "公開業務のお知らせ",
+  "business_notice_hint": "すべてのユーザーに表示されます。機密情報を入力しないでください。",
+  "security_sensitive_operations": "重要操作",
+  "security_action_cancelled": "重要な操作をキャンセルしました。",
+  "account_type": "アカウント種別",
+  "account_permanent": "長期",
+  "account_temporary": "一時",
+  "account_state": "アカウント状態",
+  "account_active": "有効",
+  "account_dormant": "休眠",
+  "account_closed": "閉鎖",
+  "account_expires": "有効期限",
+  "account_last_login": "最終ログイン",
+  "invitation_title": "パスワード設定へ招待",
+  "invitation_hint": "初期パスワードを表示・共有せず、一度限りの設定リンクを送信します。",
+  "invitation_send": "招待を送信",
+  "invitation_check_existing": "再試行の前にユーザー一覧と送信記録を確認してください。アカウントが作成済みの場合があります。",
+  "invitation_default_role": "既定の業務操作者",
+  "invitation_phone": "電話番号",
+  "audit_category": "イベント分類",
+  "audit_outcome": "処理結果",
+  "audit_severity": "レベル",
+  "audit_category_system": "システムイベント",
+  "audit_category_business": "業務イベント",
+  "audit_success": "成功",
+  "audit_failure": "失敗",
+  "audit_denied": "拒否",
+  "audit_info": "情報",
+  "audit_warning": "警告",
+  "audit_error": "エラー",
+  "audit_critical": "重大",
+  "audit_all": "すべて",
+  "audit_backup_run": "監査を手動バックアップ",
+  "audit_backup_private_hint": "サーバーの非公開ストレージに保存しました。アーカイブキーで取得し検証できます。",
+  "audit_backup_retry_hint": "再試行では同じアーカイブIDを検証します。異なるIDで重複実行しないでください。",
+  "audit_stats_hint": "過去7日間を分類、結果、レベル、リソースで絞り込み、操作別に集計します。",
+  "audit_advanced_filters": "分類・並び替え・統計",
+  "audit_sort_direction": "並び順",
+  "audit_request_id": "リクエストID",
+  "audit_trace_id": "追跡ID",
+  "audit_scope": "業務範囲",
+  "audit_actor_snapshot": "イベント時の本人情報",
+  "audit_asc": "昇順",
+  "audit_desc": "降順",
+  "audit_sort": "並び替え項目",
+  "nav_users": "ユーザー",
+  "nav_roles": "ロール",
+  "nav_audit": "監査ログ",
+  "nav_feedback": "問題フィードバック",
+  "feedback_logs": "ログとリクエスト",
+  "feedback_export_pending": "問題パッケージを生成中です。しばらくしてから再試行してください。",
+  "navigation": "メインナビゲーション",
+  "open_menu": "ナビゲーションを開く",
+  "close_menu": "ナビゲーションを閉じる",
+  "logout": "ログアウト",
+  "login_title": "ログイン",
+  "login_description": "ログインしてアカウントとワークスペースを管理します",
+  "login_invalid": "アカウントまたはパスワードが正しくありません。再試行してください。",
+  "session_expired": "セッションの有効期限が切れています。再度ログインしてください。",
+  "saved": "変更を保存しました",
+  "save": "保存",
+  "edit": "編集",
+  "delete": "削除",
+  "cancel": "キャンセル",
+  "search": "検索",
+  "details": "詳細",
+  "created_at": "作成日時",
+  "all_statuses": "すべての状態",
+  "operation_failed": "操作を完了できませんでした。再試行してください。",
+  "network_error": "接続に失敗しました。ネットワークを確認して再試行してください。",
+  "forbidden": "この操作を行う権限がありません。",
+  "conflict": "このアカウントは既に存在するか、変更が現在のデータと競合しています。",
+  "validation_failed": "入力内容を確認して再試行してください。",
+  "settings_description": "プロフィール、環境設定、アカウントのセキュリティを管理します",
+  "profile_title": "プロフィール",
+  "preferences_title": "環境設定",
+  "preferences_description": "言語と外観の設定は、端末にかかわらずアカウントに適用されます。",
+  "password_title": "パスワードを変更",
+  "password_rules": "現在と異なるパスワードを選んでください。",
+  "password_changed": "パスワードを更新しました。新しいパスワードでログインしてください。",
+  "password_current_required": "変更する前に現在のパスワードを入力してください。",
+  "password_confirmation_mismatch": "新しいパスワードが一致しません。同じパスワードを再入力してください。",
+  "avatar_hint": "PNG、JPEG、WebPの画像をアップロードしてください。最大512KBです。",
+  "avatar_invalid": "512KB以下のPNG、JPEG、WebP画像を選択してください。",
+  "avatar_saved": "アバターを更新しました",
+  "avatar_upload": "アバターをアップロード",
+  "users_description": "アカウントの作成、ロールの割り当て、アクセスを管理します",
+  "users_search": "ユーザー名、名前、メールアドレスを検索",
+  "user_account": "アカウント",
+  "user_username": "ユーザー名",
+  "user_display_name": "表示名",
+  "user_email": "メールアドレス",
+  "user_password": "初期パスワード",
+  "user_role": "ロール",
+  "user_create": "ユーザーを追加",
+  "initial_password_rules": "{min}文字以上で入力してください。",
+  "users_empty": "一致するアカウントがありません。検索条件を変更するか、ユーザーを作成してください。",
+  "user_edit": "ユーザーを編集",
+  "user_deleted": "ユーザーを削除しました",
+  "user_delete_title": "ユーザーを削除",
+  "user_delete_confirm": "{name}を削除しますか？アカウントとアクセス権は完全に削除されます。",
+  "roles_description": "職責ごとに権限を分離します。ロールはユーザー管理から割り当ててください。",
+  "role_admin": "システム管理者",
+  "role_audit": "監査管理者",
+  "role_config": "設定管理者",
+  "role_audit_capabilities": "監査記録の参照、集計とバックアップを行い、アカウントと業務設定は管理しません。",
+  "role_config_capabilities": "業務基本設定のみ管理し、アカウントと監査は管理しません。",
+  "role_operator": "業務担当者",
+  "role_operator_capabilities": "業務処理を利用し、アカウント、監査、設定管理の権限は持ちません。",
+  "role_user": "一般ユーザー",
+  "role_admin_capabilities": "システムアカウントとロールを管理し、監査と業務設定の権限は持ちません。",
+  "role_user_capabilities": "プロフィール、アバター、言語、外観、パスワードを更新できます。",
+  "role_members": "メンバー{count}人",
+  "role_edit": "説明を編集",
+  "role_description": "説明",
+  "audit_description": "アカウントと管理操作の履歴を確認します",
+  "audit_actor": "実行者",
+  "audit_action": "操作",
+  "audit_resource": "リソース",
+  "audit_resource_id": "リソースID",
+  "audit_ip": "IPアドレス",
+  "audit_start": "開始",
+  "audit_end": "終了",
+  "audit_action_placeholder": "すべての操作",
+  "audit_resource_placeholder": "すべてのリソース",
+  "audit_system": "システム",
+  "audit_details": "監査ログの詳細",
+  "audit_date_invalid": "終了日は開始日以降にしてください。",
+  "api_not_configured": "サービスへの接続が設定されていません。管理者にお問い合わせください。",
+  "guide_overview_title": "管理ワークスペースを見てみましょう",
+  "guide_overview_description": "簡単な手順でワークスペース、個人設定、ヘルプを紹介します。いつでも終了でき、ヘルプセンターから再開できます。",
+  "guide_content_title": "ワークスペース",
+  "guide_content_description": "現在のページがここに表示されます。ナビゲーションで機能を切り替えます。利用できる操作は権限に応じて変わります。",
+  "guide_theme_title": "外観",
+  "guide_theme_description": "ライトとダークの表示を切り替えます。設定でさらに多くのテーマを選択できます。",
+  "guide_profile_title": "プロフィール",
+  "guide_profile_description": "アバターからプロフィールや設定を開き、個人情報やパスワードを管理できます。",
+  "guide_help_title": "ヘルプセンター",
+  "guide_help_description": "困ったときは、ここで説明を検索したり、製品ツアーを再生したりできます。",
+  "guide_profile_tour_title": "プロフィールを設定",
+  "guide_profile_tour_description": "個人情報、環境設定、パスワード設定の場所を紹介します。ツアーでは変更を送信しません。",
+  "guide_profile_form_description": "プロフィールの表示や編集、アバターの選択、変更の保存ができます。アップロードするファイルは、画面に表示された形式とサイズの条件を満たす必要があります。",
+  "guide_preferences_description": "言語とテーマの設定を保存します。画面とヘルプの言語は選択に従います。",
+  "guide_password_title": "パスワードを変更",
+  "guide_password_description": "現在のパスワード、新しいパスワード、確認用パスワードを入力します。送信前にパスワードのルールを確認してください。",
+  "guide_overview_article": "## はじめに\n\n- ナビゲーションから各機能を開きます。メニューと操作は現在の権限に応じて変わります。\n- ワークスペースには一覧、詳細、設定が表示されます。画面の説明に従い、送信前に入力内容を確認してください。\n- アバターからプロフィールと設定を開きます。\n- ヘルプボタンで説明を検索したり、ツアーを再生したりできます。\n\n## 初回ツアー\n\n「後で通知」を選ぶと1日間通知を停止します。「今後通知しない」は設定を保存します。完了したツアーは自動で表示されなくなりますが、手動で再生できます。",
+  "guide_profile_article": "## プロフィールと環境設定\n\nプロフィールを開くと個人情報やアバターを確認・更新できます。ファイルの条件を確認し、変更を保存して結果のメッセージを確認してください。外観と言語は設定で変更できます。\n\n## パスワード\n\nパスワードの変更には、現在のパスワード、新しいパスワード、確認用パスワードが必要です。画面のルールに従い、送信後に結果を確認してください。\n\n「ツアーを開始」で関連するページを開きます。ツアーが自動でフォームを保存したり、アカウントを変更したりすることはありません。",
+  "user_password_reset": "パスワードをリセット",
+  "user_password_reset_hint": "{name} の新しいパスワードを設定します。既存のセッションは無効になり、アカウント状態は変わりません。安全な方法で新しいパスワードを本人に伝えてください。",
+  "user_password_reset_done": "パスワードをリセットし、既存のセッションを無効にしました。安全な方法で新しいパスワードを本人に伝えてください。",
+  "user_password_reset_initial_hint": "初回変更が必須です。次回ログイン時に本人がパスワードを変更する必要があります。"
+}

package/templates/apps/fullstack/packages/{{projectName}}-shared/messages/zh-CN.json.hbs

@@ -0,0 +1,164 @@
+{{! @skipIfEmpty }}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "settings_title": "个人设置",
+  "settings_language": "语言",
+  "settings_theme": "主题",
+  "theme_high_contrast": "高对比",
+  "theme_formal": "简洁商务",
+  "home_refresh": "刷新",
+  "home_loading": "加载中…",
+  "home_error": "无法连接到 API 服务",
+  "business_settings_title": "业务基础配置",
+  "business_notice_label": "公共业务公告",
+  "business_notice_hint": "公告对所有用户可见，请勿填写敏感信息。",
+  "security_sensitive_operations": "敏感操作",
+  "security_action_cancelled": "已取消敏感操作。",
+  "account_type": "账号类型",
+  "account_permanent": "长期账号",
+  "account_temporary": "临时账号",
+  "account_state": "账号状态",
+  "account_active": "激活",
+  "account_dormant": "休眠",
+  "account_closed": "注销",
+  "account_expires": "到期时间",
+  "account_last_login": "最后登录时间",
+  "invitation_title": "发送设密邀请",
+  "invitation_hint": "向收件人发送一次性设密链接，不显示或传递初始密码。",
+  "invitation_send": "发送邀请",
+  "invitation_check_existing": "先检查用户列表和投递记录，再决定是否重试；账号可能已创建。",
+  "invitation_default_role": "默认业务操作员",
+  "invitation_phone": "手机号",
+  "audit_category": "事件分类",
+  "audit_outcome": "处理结果",
+  "audit_severity": "等级",
+  "audit_category_system": "系统事件",
+  "audit_category_business": "业务事件",
+  "audit_success": "成功",
+  "audit_failure": "失败",
+  "audit_denied": "拒绝",
+  "audit_info": "信息",
+  "audit_warning": "警告",
+  "audit_error": "错误",
+  "audit_critical": "严重",
+  "audit_all": "全部",
+  "audit_backup_run": "手动备份审计",
+  "audit_backup_private_hint": "归档已保存到服务端私有存储，可按归档键获取并验证。",
+  "audit_backup_retry_hint": "重试将核对同一归档编号，请勿重复发起不同编号的任务。",
+  "audit_stats_hint": "近7天按分类、结果、等级和资源统计。",
+  "audit_advanced_filters": "分类、排序与统计",
+  "audit_sort_direction": "排序方向",
+  "audit_request_id": "请求编号",
+  "audit_trace_id": "追踪编号",
+  "audit_scope": "业务范围",
+  "audit_actor_snapshot": "事件时身份",
+  "audit_asc": "升序",
+  "audit_desc": "降序",
+  "audit_sort": "排序字段",
+  "nav_users": "用户管理",
+  "nav_roles": "角色管理",
+  "nav_audit": "审计日志",
+  "nav_feedback": "问题反馈",
+  "feedback_logs": "日志与请求",
+  "feedback_export_pending": "问题包仍在生成，请稍后重试。",
+  "navigation": "主导航",
+  "open_menu": "打开导航",
+  "close_menu": "关闭导航",
+  "logout": "退出登录",
+  "login_title": "登录",
+  "login_description": "登录后管理个人账户与工作空间",
+  "login_invalid": "账号或密码不正确，请重试。",
+  "session_expired": "登录已过期，请重新登录。",
+  "saved": "已保存修改",
+  "save": "保存",
+  "edit": "编辑",
+  "delete": "删除",
+  "cancel": "取消",
+  "search": "查询",
+  "details": "详情",
+  "created_at": "创建时间",
+  "all_statuses": "全部状态",
+  "operation_failed": "操作未完成，请重试。",
+  "network_error": "连接失败，请检查网络后重试。",
+  "forbidden": "没有执行此操作的权限。",
+  "conflict": "账户已存在，或修改与当前数据冲突。",
+  "validation_failed": "请检查填写的信息后重试。",
+  "settings_description": "管理个人资料、偏好与账户安全",
+  "profile_title": "个人资料",
+  "preferences_title": "偏好设置",
+  "preferences_description": "语言与界面风格保存到个人账户，在不同设备上保持一致。",
+  "password_title": "修改密码",
+  "password_rules": "请使用与旧密码不同的新密码。",
+  "password_changed": "密码已修改，请使用新密码重新登录。",
+  "password_current_required": "请输入当前密码后再修改。",
+  "password_confirmation_mismatch": "两次输入的新密码不一致，请重新确认。",
+  "avatar_hint": "支持 PNG、JPEG 和 WebP 图片，大小不超过 512 KB。",
+  "avatar_invalid": "请选择不超过 512 KB 的 PNG、JPEG 或 WebP 图片。",
+  "avatar_saved": "头像已更新",
+  "avatar_upload": "上传头像",
+  "users_description": "创建账户、分配角色并管理访问权限",
+  "users_search": "搜索用户名、姓名或邮箱",
+  "user_account": "账户",
+  "user_username": "用户名",
+  "user_display_name": "显示名称",
+  "user_email": "邮箱",
+  "user_password": "初始密码",
+  "user_role": "角色",
+  "user_create": "新增用户",
+  "initial_password_rules": "密码至少 {min} 个字符。",
+  "users_empty": "没有匹配的账户，请调整查询条件或新增用户。",
+  "user_edit": "编辑用户",
+  "user_deleted": "用户已删除",
+  "user_delete_title": "删除用户",
+  "user_delete_confirm": "确认删除 {name}？此操作将永久删除账户及其访问权限。",
+  "roles_description": "按职责分离管理权限，在用户管理中分配角色。",
+  "role_admin": "系统管理员",
+  "role_audit": "审计管理员",
+  "role_config": "配置管理员",
+  "role_audit_capabilities": "查看、统计和备份审计记录，不管理账号或业务配置。",
+  "role_config_capabilities": "仅管理业务基础配置，不管理账号或审计。",
+  "role_operator": "业务操作员",
+  "role_operator_capabilities": "使用业务处理功能，不具有账号、审计或配置管理权限。",
+  "role_user": "普通用户",
+  "role_admin_capabilities": "管理系统账号与角色，不包含审计或业务配置权限。",
+  "role_user_capabilities": "修改个人资料、头像、语言、界面风格与密码。",
+  "role_members": "{count} 名成员",
+  "role_edit": "编辑说明",
+  "role_description": "角色说明",
+  "audit_description": "查看账户与管理操作的审计记录",
+  "audit_actor": "操作用户",
+  "audit_action": "操作",
+  "audit_resource": "资源",
+  "audit_resource_id": "资源 ID",
+  "audit_ip": "IP 地址",
+  "audit_start": "开始日期",
+  "audit_end": "结束日期",
+  "audit_action_placeholder": "全部操作",
+  "audit_resource_placeholder": "全部资源",
+  "audit_system": "系统",
+  "audit_details": "审计日志详情",
+  "audit_date_invalid": "结束日期不能早于开始日期。",
+  "api_not_configured": "尚未配置服务连接，请联系应用管理员。",
+  "guide_overview_title": "快速认识管理后台",
+  "guide_overview_description": "用几个简短步骤了解工作区、个人设置和帮助入口。你可以随时退出，也可以从帮助中心重新查看。",
+  "guide_content_title": "工作区",
+  "guide_content_description": "这里展示当前页面的内容。通过导航菜单切换功能，页面会根据你的权限提供可用操作。",
+  "guide_theme_title": "外观切换",
+  "guide_theme_description": "点击这里快速切换亮色与暗色外观。更多主题可以在设置页面中选择。",
+  "guide_profile_title": "个人资料",
+  "guide_profile_description": "点击头像打开个人资料和设置入口，管理头像、个人信息与密码。",
+  "guide_help_title": "帮助中心",
+  "guide_help_description": "遇到问题时从这里搜索使用说明，或重新开始任意操作导览。",
+  "guide_profile_tour_title": "完善个人资料",
+  "guide_profile_tour_description": "了解个人信息、偏好和密码设置的位置。引导只说明操作，不会自动提交修改。",
+  "guide_profile_form_description": "在这里查看或编辑个人资料，选择头像并保存修改。上传文件需符合页面显示的格式与大小要求。",
+  "guide_preferences_description": "选择语言和主题后保存，界面与帮助内容会使用所选语言和外观。",
+  "guide_password_title": "修改密码",
+  "guide_password_description": "输入当前密码、新密码和确认密码，按页面提示提交。修改前请确认新密码符合密码规则。",
+  "guide_overview_article": "## 从哪里开始\n\n- 使用导航菜单打开需要的功能。可见菜单和操作由当前权限决定。\n- 工作区显示列表、详情或设置内容。按页面提示完成操作，提交前确认信息。\n- 点击头像访问个人资料与设置。\n- 点击帮助入口搜索说明或重新查看导览。\n\n## 首次引导\n\n选择“稍后提醒”会暂缓一天；选择“不再提醒”会保留你的选择。完成导览后不会重复提示，仍可手动重看。",
+  "guide_profile_article": "## 个人资料与偏好\n\n打开个人资料页面，查看或修改个人信息与头像。头像需符合页面显示的文件要求，保存后查看结果提示。外观和语言可在设置中调整。\n\n## 密码\n\n修改密码需要当前密码、新密码和确认密码。按页面显示的密码规则填写，提交后查看结果。\n\n点击“开始引导”可以直接进入对应页面。导览不会自动保存表单或修改账户。",
+  "user_password_reset": "重置密码",
+  "user_password_reset_hint": "为 {name} 设置新密码。重置后原会话失效，账号状态保持不变。请通过安全渠道交付新密码。",
+  "user_password_reset_done": "密码已重置，原会话已失效。请向用户安全交付新密码。",
+  "user_password_reset_initial_hint": "已启用初始密码更换要求：用户下次登录时必须设置自己的密码。"
+}

package/templates/apps/fullstack/packages/{{projectName}}-shared/package.json.hbs

@@ -0,0 +1,55 @@
+{
+  "engines": { "node": "^22.23.4 || ^24.22.1 || ^26.12.1" },
+  "name": "{{fullstack.sharedPackageName}}",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Shared frontend code (AppShell / theme / i18n / API) for {{projectName}} web/app/desktop/mini.",
+  "exports": {
+    ".": "./src/index.ts",
+    "./components/*": "./src/lib/components/*",
+    "./stores/*": "./src/lib/stores/*",
+    "./api": "./src/lib/api/api-client.ts",
+    "./project.inlang/settings.json": "./project.inlang/settings.json",
+    "./messages/*": "./messages/*",
+    "./paraglide/messages": "./src/lib/paraglide/messages.js",
+    "./paraglide/runtime": "./src/lib/paraglide/runtime.js"
+  },
+  "files": [
+    "src",
+    "project.inlang",
+    "messages"
+  ],
+  "scripts": {
+    "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+    "paraglide:watch": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide --watch",
+    "prepare": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+    "check": "pnpm typecheck",
+    "typecheck": "pnpm paraglide:compile && svelte-check --tsconfig ./tsconfig.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rimraf .turbo src/lib/paraglide"
+  },
+  "dependencies": {
+    "@h-ai/api-client": "{{haiPackageSpecifier}}",
+    "@h-ai/api-contract": "{{haiPackageSpecifier}}",
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+    "@h-ai/crypto": "{{haiPackageSpecifier}}",
+{{#if features.feedback}}
+    "@h-ai/feedback": "{{haiPackageSpecifier}}",
+{{/if}}
+    "@h-ai/ui": "{{haiPackageSpecifier}}",
+    "{{fullstack.contractPackageName}}": "workspace:*"
+  },
+  "devDependencies": {
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.packageSpecifiers.sveltePlugin}}",
+    "@inlang/paraglide-js": "{{fullstack.packageSpecifiers.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{fullstack.packageSpecifiers.inlangMessageFormat}}",
+    "svelte": "{{fullstack.packageSpecifiers.svelte}}",
+    "svelte-check": "{{fullstack.packageSpecifiers.svelteCheck}}",
+    "typescript": "{{fullstack.packageSpecifiers.typescript}}",
+    "vite": "{{fullstack.packageSpecifiers.vite}}",
+    "vitest": "{{fullstack.packageSpecifiers.vitest}}"
+  }
+}

package/templates/apps/fullstack/packages/{{projectName}}-shared/project.inlang/settings.json.hbs

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "{{fullstack.i18n.baseLocale}}",
+  "locales": [{{#each fullstack.i18n.locales}}"{{this}}"{{#unless @last}}, {{/unless}}{{/each}}],
+  "modules": [
+    "../../node_modules/@inlang/plugin-message-format/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/index.ts.hbs

@@ -0,0 +1,7 @@
+export { default as AppShell } from './lib/components/AppShell.svelte'
+export { default as AdminWorkspace } from './lib/components/AdminWorkspace.svelte'
+export { AVAILABLE_THEMES, themeStore } from './lib/stores/theme-store.svelte.js'
+export type { AppInfo, ManagementApiOptions } from './lib/api/api-client.js'
+export { initializeManagementApi, managementApi } from './lib/api/api-client.js'
+export * as messages from './lib/paraglide/messages.js'
+export { getLocale, locales, setLocale } from './lib/paraglide/runtime.js'

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/api/api-client.ts.hbs

@@ -0,0 +1,94 @@
+import type { TokenStorage } from '@h-ai/api-client'
+import type { AppInfoOutputData } from '{{fullstack.contractPackageName}}'
+import { apiClient, HaiApiClientError } from '@h-ai/api-client'
+import { err } from '@h-ai/core'
+import { crypto } from '@h-ai/crypto'
+import { {{fullstack.contractExportName}} } from '{{fullstack.contractPackageName}}'
+
+import { sessionRecovery } from './session-recovery.svelte.js'
+
+export type AppInfo = AppInfoOutputData
+export const managementApi = apiClient.create({{fullstack.contractExportName}})
+
+const DEFAULT_API_ORIGIN = 'http://127.0.0.1:3000'
+
+export interface ManagementApiOptions {
+  fetchFn?: typeof fetch
+  baseUrl?: string
+  clientName?: string
+  terminalType?: 'web' | 'app' | 'desktop'
+  tokenStorage?: TokenStorage
+  headers?: Record<string, string>
+  requireApiBase?: boolean
+  onSessionExpired?: () => void
+}
+
+/** 所有业务请求由 api-client 统一完成 Token 注入、刷新和双向加密。 */
+export async function initializeManagementApi(options: ManagementApiOptions = {}) {
+  if (options.requireApiBase && !options.baseUrl && !resolveRuntimeApiOrigin() && !import.meta.env.PUBLIC_API_BASE)
+    return err(HaiApiClientError.CONFIG_ERROR, 'Native applications require a configured API origin')
+  if (managementApi.isInitialized)
+    await managementApi.close()
+  if (!crypto.isInitialized) {
+    const result = await crypto.init()
+    if (!result.success)
+      return result
+  }
+
+  return managementApi.init({
+    baseUrl: normalizeApiBaseUrl(options.baseUrl ?? resolveDefaultApiOrigin()),
+    clientName: options.clientName ?? '{{fullstack.sharedPackageName}}',
+    fetch: createCredentialedFetch(options.fetchFn),
+    headers: options.headers,
+    auth: { recoverSession: sessionRecovery.recover, terminalType: options.terminalType ?? 'web', storage: options.tokenStorage, onRefreshFailed: options.onSessionExpired },
+    transport: { crypto },
+  })
+}
+
+/** 头像仅允许服务端约定资源路径，并统一指向当前可信 API origin。 */
+export function resolveAvatarUrl(value: string | undefined): string | undefined {
+  if (!value)
+    return undefined
+  try {
+    const origin = managementApi.config?.baseUrl ?? normalizeApiBaseUrl(resolveDefaultApiOrigin())
+    const parsed = new URL(value, origin)
+    const prefix = `${new URL(origin).pathname.replace(/\/+$/, '')}/assets/avatars/`
+    if (!parsed.pathname.startsWith(prefix) || !/^[\w-]+\/[\w-]+\.(?:png|jpg|webp)$/.test(parsed.pathname.slice(prefix.length)))
+      return undefined
+    return new URL(parsed.pathname, origin).toString()
+  }
+  catch {
+    return undefined
+  }
+}
+
+function resolveDefaultApiOrigin(): string {
+  return resolveRuntimeApiOrigin()
+    || import.meta.env.PUBLIC_API_BASE
+    || (typeof globalThis.location === 'undefined' ? DEFAULT_API_ORIGIN : globalThis.location.origin)
+}
+
+/** 跨端浏览器请求携带服务端管理的 httpOnly refresh Cookie。 */
+function createCredentialedFetch(fetchFn: typeof fetch = globalThis.fetch.bind(globalThis)): typeof fetch {
+  return (input, init) => {
+    const request = new Request(input, init)
+    return fetchFn(new Request(request, { credentials: 'include' }))
+  }
+}
+
+function resolveRuntimeApiOrigin(): string | undefined {
+  const runtimeConfig = (globalThis as typeof globalThis & {
+    __HAI_PUBLIC_CONFIG__?: { apiBase?: string }
+  }).__HAI_PUBLIC_CONFIG__
+  return runtimeConfig?.apiBase
+}
+
+function normalizeApiBaseUrl(value: string): string {
+  const url = new URL(value.trim())
+  if (url.pathname === '/')
+    url.pathname = '/api/v1'
+  return url.toString().replace(/\/+$/, '')
+}
+
+/** 标准 IAM 表单动作，平台安全 TokenStorage 由原有初始化配置决定。 */
+export const managementAuthActions = apiClient.createAuthActions(managementApi)

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/api/feedback-client.ts.hbs

@@ -0,0 +1,36 @@
+{{! @skipIfEmpty }}
+{{#if features.feedback}}
+import { createFeedbackClient, createFeedbackReview, saveFeedbackFile } from '@h-ai/feedback/client'
+import { managementApi } from './api-client.js'
+
+/** 仅装配共享采集器，不复制采集、脱敏、上传或离线打包逻辑。 */
+export const browserFeedback = createFeedbackClient()
+export const feedbackReview = createFeedbackReview(managementApi.feedback.reports)
+export { feedbackDataBytes } from '@h-ai/feedback/client'
+
+export async function initializeBrowserFeedback(metadata: { appVersion: string, buildId: string, commit: string }): Promise<void> {
+  const result = await browserFeedback.init({
+    appId: '{{projectName}}',
+    ...metadata,
+    screenshot: true,
+    replay: true,
+    persistDraft: false,
+    actions: {
+      policy: () => managementApi.feedback.reports.policy({}),
+      submit: input => managementApi.feedback.reports.submit(input),
+      appendEvidence: input => managementApi.feedback.reports.appendEvidence(input),
+      completeCollection: input => managementApi.feedback.reports.completeCollection(input),
+      upload: input => managementApi.feedback.attachments.upload(input),
+    },
+  })
+  if (!result.success)
+    throw new Error(result.error.message, { cause: result.error })
+}
+
+/** 下载的内容来自受权 API 或本地采集器；对象 URL 在发起后释放。 */
+export async function downloadFeedback(bytes: Uint8Array, name: string, contentType = 'application/zip'): Promise<void> {
+  const result = await saveFeedbackFile(bytes, name, contentType)
+  if (!result.success)
+    throw new Error(result.error.message, { cause: result.error })
+}
+{{/if}}

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/api/sensitive-actions.svelte.ts.hbs

@@ -0,0 +1,16 @@
+/** 再鉴别只保存当前页面待确认动作；密码与单次凭据不进入持久存储。 */
+import type { HaiResult } from '@h-ai/core'
+import { err } from '@h-ai/core'
+import { createSensitiveActions } from '@h-ai/ui/components/scenes/iam/index'
+import * as m from '../paraglide/messages.js'
+import { managementAuthActions as authActions } from './api-client.js'
+
+export const sensitiveActions = createSensitiveActions(authActions)
+
+/** 用途凭据只传给本次 typed client 调用，不使用共享 header。 */
+export async function requestSensitive<T>(operation: string, run: (options: { context: { reauthentication?: string, reauthorize: () => Promise<string | null | undefined> } }) => Promise<HaiResult<T>>): Promise<HaiResult<T>> {
+  const ticket = await sensitiveActions.authorize(operation)
+  if (ticket === null)
+    return err({ code: 'app:cancelled', httpStatus: 400, message: m.security_action_cancelled() })
+  return run({ context: { ...(ticket ? { reauthentication: ticket } : {}), reauthorize: () => sensitiveActions.authorize(operation) } })
+}

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/api/session-recovery.svelte.ts.hbs

@@ -0,0 +1,4 @@
+/** 页面级恢复交互由UI模块统一提供，不复制认证表单或请求队列。 */
+import { createSessionRecovery } from '@h-ai/ui/components/scenes/iam/index'
+
+export const sessionRecovery = createSessionRecovery()