{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.magic-keyboard","code":"thing-q24451476","url":"https://ver.cy/models/thing/q24451476/","name":"Magic Keyboard","alternateNames":[],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"thing","plane":"PHY","domain":["PHY.OBJ"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"Magic Keyboard is Apple's product-family name for standalone wireless keyboards, with features and connectivity that vary by version.","purpose":"Enable an AI agent to identify a standalone Apple Magic Keyboard variant, assess its compatibility and condition, and determine appropriate setup, use and care actions.","scope":{"in":["Standalone Magic Keyboard family, generation, model identifier and regional key layout are included.","Variant-specific host compatibility and communication requirements are included.","Typing controls, numeric keypads and variant-dependent Touch ID capabilities are included.","Power delivery, charging arrangements and operational readiness are included.","Physical condition, functional faults and appropriate care actions are included."],"out":["Generic keyboard principles are owned by a broader keyboard model.","The host Mac or iPad as a complete computing device is outside this model.","Apple's corporate identity and the history of its product portfolio are outside this model.","Other Apple keyboards and third-party keyboard accessories are outside this model.","Magic Keyboard accessories that attach to an iPad are outside this model.","Keyboards integrated into Mac notebooks are outside this model.","User credentials, biometric templates and application content are outside this model."],"boundaries":[]},"distinguishingFeatures":["Product markings and model identifiers must support identification as an Apple Magic Keyboard; an Apple-style key layout alone is insufficient.","The referent is a standalone wireless keyboard, distinct from an iPad-attaching Magic Keyboard accessory.","The Magic Keyboard name on a standalone keyboard must be distinguished from its use for a keyboard integrated into a Mac notebook.","Touch ID and a numeric keypad must each be established for the identified variant rather than inferred from the family name.","Supported host models and feature compatibility must be checked for the identified standalone keyboard variant."],"structure":{"bundles":[{"id":"family-and-variant-identity","name":"Family and variant identity","description":"Establish which Magic Keyboard is being described before assigning capabilities.","layers":[{"id":"registry-referent","name":"Registry referent","description":"Resolve the boundary between the registered concept and neighbouring uses of the name.","findings":[{"id":"magic-keyboard-name-boundary","name":"Magic Keyboard name boundary","description":"The draft must preserve uncertainty about whether this registry entry denotes standalone keyboards, iPad accessories or a broader family.","questions":[{"text":"Which originating registry record or external identifier establishes the intended meaning of Magic Keyboard?","id":"magic-keyboard-name-boundary-q01","kind":"provenance"},{"text":"Does the entry include iPad accessories and notebook-integrated keyboards, or do those belong to separate registered concepts?","id":"magic-keyboard-name-boundary-q02","kind":"boundary"}]}]},{"id":"variant-identification","name":"Variant identification","description":"Identify a product variant without confusing it with an individual physical unit.","findings":[{"id":"markings-and-layout-evidence","name":"Markings and layout evidence","description":"Model markings and documented physical features should jointly support variant identification; a unit's serial number serves a different purpose.","questions":[{"text":"Which model identifier and product documentation establish this variant and generation?","id":"markings-and-layout-evidence-q01","kind":"provenance"},{"text":"Which observed key layout, connector and accessory features corroborate that identification?","id":"markings-and-layout-evidence-q02","kind":"definition"}]}]}]},{"id":"host-fit-and-connection","name":"Host fit and connection","description":"Determine whether the keyboard can attach, communicate and provide the requested functions on a particular host.","layers":[{"id":"host-compatibility","name":"Host compatibility","description":"Relate the identified keyboard variant to documented host requirements.","findings":[{"id":"feature-specific-host-support","name":"Feature-specific host support","description":"Compatibility should be assessed separately for typing, Touch ID, trackpad operation and any other supported feature.","questions":[{"text":"Which host models and operating-system versions are documented as supporting this exact Magic Keyboard variant?","id":"feature-specific-host-support-q01","kind":"provenance"},{"text":"Does the proposed host satisfy the additional requirements of every feature the user intends to use?","id":"feature-specific-host-support-q02","kind":"action"}]}]},{"id":"attachment-and-link","name":"Attachment and link","description":"Distinguish standalone communication from the physical and electrical interface of an iPad accessory.","findings":[{"id":"branch-specific-connection","name":"Branch-specific connection","description":"Setup must follow the identified variant's communication and attachment arrangement rather than assume that every Magic Keyboard uses Bluetooth pairing.","questions":[{"text":"Which documented interface carries keyboard input, and what pairing or attachment steps does it require?","id":"branch-specific-connection-q01","kind":"definition"},{"text":"For an iPad accessory, do the supported host designation, attachment geometry and connector alignment all match?","id":"branch-specific-connection-q02","kind":"boundary"}]}]}]},{"id":"typing-and-optional-controls","name":"Typing and optional controls","description":"Describe the input actions offered by the specific keyboard and their configuration dependencies.","layers":[{"id":"keys-and-mapping","name":"Keys and mapping","description":"Connect the physical key arrangement to the host's interpretation of input.","findings":[{"id":"physical-and-configured-layout","name":"Physical and configured layout","description":"Printed legends, physical layout and the host-selected input source are distinct observations needed to interpret unexpected characters or shortcuts.","questions":[{"text":"What regional layout, language legends and numeric-keypad arrangement does this variant have?","id":"physical-and-configured-layout-q01","kind":"definition"},{"text":"Which host input-source and modifier settings should be checked when typed output differs from key legends?","id":"physical-and-configured-layout-q02","kind":"action"}]}]},{"id":"optional-input-features","name":"Optional input features","description":"Establish the presence and readiness of controls that are not universal across the family.","findings":[{"id":"touch-id-trackpad-and-lighting","name":"Touch ID, trackpad and lighting","description":"Each optional feature needs separate evidence of physical presence, host support and operational state; biometric information belongs outside this model.","questions":[{"text":"Which of Touch ID, a trackpad, backlighting and dedicated control keys are documented for this variant?","id":"touch-id-trackpad-and-lighting-q01","kind":"provenance"},{"text":"How can each present feature be tested through supported host controls without recording credentials or biometric templates?","id":"touch-id-trackpad-and-lighting-q02","kind":"action"}]}]}]},{"id":"power-and-readiness","name":"Power and readiness","description":"Establish how the keyboard receives power and what evidence demonstrates that it is ready for use.","layers":[{"id":"power-path","name":"Power path","description":"Record the actual role of batteries, host contacts and external ports.","findings":[{"id":"battery-and-port-roles","name":"Battery and port roles","description":"A connector's appearance does not establish whether it charges the keyboard, provides pass-through charging to an iPad or carries input data.","questions":[{"text":"Does this variant contain a rechargeable battery or obtain operating power from its host?","id":"battery-and-port-roles-q01","kind":"definition"},{"text":"What charging, power-delivery and data roles are explicitly documented for each connector?","id":"battery-and-port-roles-q02","kind":"provenance"}]}]},{"id":"readiness-evidence","name":"Readiness evidence","description":"Separate available power, an established connection and successful input.","findings":[{"id":"observable-operating-state","name":"Observable operating state","description":"Readiness requires observable evidence appropriate to the variant, such as host-reported charge, connection status and a successful typing check.","questions":[{"text":"What charge reading or host-power evidence is available, and when was it observed?","id":"observable-operating-state-q01","kind":"measurement"},{"text":"Which supported checks distinguish absent power, an unestablished link and connected-but-failing input?","id":"observable-operating-state-q02","kind":"action"}]}]}]},{"id":"condition-care-and-service","name":"Condition, care and service","description":"Relate Magic Keyboard condition observations to suitable troubleshooting, cleaning and service decisions.","layers":[{"id":"fault-localisation","name":"Fault localisation","description":"Locate a malfunction within keys, optional controls, communication or accessory attachment.","findings":[{"id":"input-and-attachment-symptoms","name":"Input and attachment symptoms","description":"Record specific symptoms and test conditions before attributing a fault to the keyboard rather than the host or its settings.","questions":[{"text":"Which keys or optional controls fail, and is the failure repeatable under the same host and connection conditions?","id":"input-and-attachment-symptoms-q01","kind":"measurement"},{"text":"For an iPad accessory, is there visible damage, contact obstruction or unstable attachment that could explain the symptom?","id":"input-and-attachment-symptoms-q02","kind":"measurement"}]}]},{"id":"care-and-service-boundaries","name":"Care and service boundaries","description":"Choose care actions using instructions for the identified variant and its observed condition.","findings":[{"id":"documented-maintenance-actions","name":"Documented maintenance actions","description":"Cleaning, battery handling and work on keys or attachment mechanisms require variant-specific guidance rather than assumptions about generic keyboards.","questions":[{"text":"Which manufacturer instructions govern cleaning, disconnection and handling for this exact variant?","id":"documented-maintenance-actions-q01","kind":"provenance"},{"text":"Which observed conditions require stopping use or seeking service instead of further pairing, charging or cleaning attempts?","id":"documented-maintenance-actions-q02","kind":"action"}]}]}]},{"id":"evidence-and-external-alignment","name":"Evidence and external alignment","description":"What the world already says about this thing, gathered so the model can be checked against it.","layers":[{"id":"reported-evidence","name":"Reported evidence","description":"Findings from the breadth pass, kept separate from the structural claims.","findings":[{"id":"evidence-confidence-notes","name":"Check these first","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these check these first hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-confidence-notes-q01","kind":"provenance"}]},{"id":"evidence-kinds","name":"Kinds and varieties","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these kinds and varieties hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-kinds-q01","kind":"provenance"}]},{"id":"evidence-identifiers","name":"Identifiers and schemes","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these identifiers and schemes hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-identifiers-q01","kind":"provenance"}]},{"id":"evidence-standards-and-regulation","name":"Standards and regulation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these standards and regulation hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-standards-and-regulation-q01","kind":"provenance"}]},{"id":"evidence-real-world-use","name":"Real-world use","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these real-world use hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-real-world-use-q01","kind":"provenance"}]},{"id":"evidence-failure-modes-and-hazards","name":"Failure modes and hazards","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these failure modes and hazards hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-failure-modes-and-hazards-q01","kind":"provenance"}]},{"id":"evidence-regional-variation","name":"Regional variation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these regional variation hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-regional-variation-q01","kind":"provenance"}]},{"id":"evidence-neighbours","name":"Neighbouring kinds and how to tell them apart","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these neighbouring kinds and how to tell them apart hold for the sense of Magic Keyboard this model covers, and on what evidence?","id":"evidence-neighbours-q01","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Help a user pair, configure and troubleshoot their own keyboard.","Report battery level and connection state when the user asks."],"mustNot":["Log keystrokes or capture typed text without the user's knowledge.","Pair the keyboard with another device without the user's consent.","Present compatibility with a device model it does not support."],"requiresHuman":["Resetting or unpairing a keyboard used by someone else, such as at work."]},"ethics":{"considerations":["What people type includes passwords and private messages.","Accessibility features matter to users who rely on keyboard input."],"affectedParties":["Users","People whose messages are typed"]},"owners":{"steward":"The person who owns and uses it.","roles":[],"masterSystems":[]},"relations":[{"target":"Q1474507","type":"parent","note":"registry parent class"},{"target":"Q99936036","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.magic-keyboard","Wikidata: Q24451476 (https://www.wikidata.org/wiki/Q24451476)"]},"properties":{"applicability":"required","items":["Product branch: standalone keyboard | iPad keyboard accessory | unresolved","Model and generation identity: observed model identifier, documented product designation and generation; unknown where unverified","Supported host configuration: documented host models, processor requirements where applicable, and operating-system requirements","Physical key layout: regional layout, printed language, numeric-keypad presence and function-row arrangement","Input capabilities: variant-verified presence or absence of Touch ID, trackpad, backlighting and dedicated controls","Connection and attachment arrangement: documented Bluetooth, wired or Smart Connector arrangement; freestanding or model-specific iPad attachment","Power arrangement: internal rechargeable battery | host-supplied power | unresolved; connector role recorded separately","Battery charge: % when reported for a battery-equipped variant; otherwise not applicable or unknown","Operational state: unpowered | awaiting connection | connected | typing operational | partially functional | faulted | unknown","Physical integrity: observations of keys, enclosure, connectors and variant-dependent hinge, attachment surface or trackpad"]},"recognition":{"applicability":"required","items":["A standalone Magic Keyboard is a thin, low-profile keyboard with an aluminium enclosure.","Key layout and the presence of a numeric keypad or Touch ID vary by model.","A charging or connection cable may be present even though the keyboard supports wireless use."]},"capabilities":{"applicability":"required","items":["Identify a Magic Keyboard variant from markings, layout and verified documentation.","Check whether a proposed host supports typing and each requested special feature.","Guide variant-appropriate pairing, cable connection or iPad attachment.","Configure and test key mapping and supported trackpad, backlighting or Touch ID functions.","Diagnose failures by separating power, connection, host configuration and physical-condition evidence.","Select documented cleaning, charging, disconnection and service actions."]},"hazards":{"applicability":"required","items":["Damaged lithium batteries can swell or overheat.","Wireless links can be a route for eavesdropping if not secured."]},"interfaces":{"applicability":"required","items":["The Radio Equipment Directive 2014/53/EU, adopted by the European Parliament and the Council of the European Union, applies to wireless keyboard versions placed on the European Union market.","The RoHS Directive 2011/65/EU, adopted by the European Parliament and the Council of the European Union, restricts specified hazardous substances in electrical and electronic equipment within its scope."]},"context":{"applicability":"required","items":["This wireless keyboard is used for text entry, navigation, and shortcuts on compatible computers or tablets.","It is encountered in desktop and mobile workspaces where the particular version determines connectivity, charging, and supported functions."]}},"sources":[{"title":"Wikidata item Q24451476: Magic Keyboard","url":"https://www.wikidata.org/wiki/Q24451476","note":"identity and sense of the item"},{"title":"Wikipedia: Magic Keyboard (Mac)","url":"https://en.wikipedia.org/wiki/Magic_Keyboard_%28Mac%29","note":"general description of the item"}],"openQuestions":["What source record defines vr.tr.magic-keyboard, and which uses of the Magic Keyboard name does it actually include?","Does an existing Vercy world model already own this concept or a branch that should be linked rather than duplicated?","Which authoritative model-by-model references establish host compatibility, connection modes, optional controls and port roles?","Which dimensions, mass, battery specifications and operating limits should be recorded for each included variant, with units and source dates?","Which variant-specific care instructions, service boundaries and jurisdiction-specific conformity records have been verified?"],"resources":{"spec":"/models/things/publications/thing-q24451476/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q24451476/spec.json"],"providers":["Codex"],"researchStatus":"unreviewed","generatedAt":"2026-09-12T11:07:07Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:31+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}