[{"data":1,"prerenderedAt":1569},["ShallowReactive",2],{"navigation":3,"\u002Fessentials\u002Fperimeter-classes":173,"\u002Fessentials\u002Fperimeter-classes-surround":1564},[4,27,69,103,113,135],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":26},"Getting Started","i-heroicons-star","\u002Fgetting-started","1.getting-started",[10,14,18,22],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":19,"path":20,"stem":21},"Quick start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":23,"path":24,"stem":25},"Upgrade guide","\u002Fgetting-started\u002Fupgrade-guide","1.getting-started\u002F5.upgrade-guide",false,{"title":28,"icon":29,"path":30,"stem":31,"children":32,"page":26},"Essentials","i-heroicons-shield-check","\u002Fessentials","2.essentials",[33,37,41,45,49,53,57,61,65],{"title":34,"path":35,"stem":36},"Controls","\u002Fessentials\u002Fcontrols","2.essentials\u002F1.controls",{"title":38,"path":39,"stem":40},"Perimeters","\u002Fessentials\u002Fperimeters","2.essentials\u002F2.perimeters",{"title":42,"path":43,"stem":44},"Perimeter classes","\u002Fessentials\u002Fperimeter-classes","2.essentials\u002F3.perimeter-classes",{"title":46,"path":47,"stem":48},"Levels","\u002Fessentials\u002Flevels","2.essentials\u002F4.levels",{"title":50,"path":51,"stem":52},"Boundaries","\u002Fessentials\u002Fboundaries","2.essentials\u002F5.boundaries",{"title":54,"path":55,"stem":56},"Parents","\u002Fessentials\u002Fparents","2.essentials\u002F6.parents",{"title":58,"path":59,"stem":60},"Policies","\u002Fessentials\u002Fpolicies","2.essentials\u002F7.policies",{"title":62,"path":63,"stem":64},"Queries","\u002Fessentials\u002Fqueries","2.essentials\u002F8.queries",{"title":66,"path":67,"stem":68},"Readers","\u002Fessentials\u002Freaders","2.essentials\u002F9.readers",{"title":70,"icon":71,"path":72,"stem":73,"children":74,"page":26},"Search","i-heroicons-magnifying-glass","\u002Fsearch","3.search",[75,79,83,87,91,95,99],{"title":76,"path":77,"stem":78},"Search overview","\u002Fsearch\u002Foverview","3.search\u002F1.overview",{"title":80,"path":81,"stem":82},"Engines","\u002Fsearch\u002Fengines","3.search\u002F2.engines",{"title":84,"path":85,"stem":86},"Keeping the keys fresh","\u002Fsearch\u002Fkeeping-the-keys-fresh","3.search\u002F3.keeping-the-keys-fresh",{"title":88,"path":89,"stem":90},"Exceptions and dates","\u002Fsearch\u002Fexceptions-and-dates","3.search\u002F4.exceptions-and-dates",{"title":92,"path":93,"stem":94},"Searching through a parent","\u002Fsearch\u002Fthrough-a-parent","3.search\u002F5.through-a-parent",{"title":96,"path":97,"stem":98},"Search from the browser","\u002Fsearch\u002Ffrom-the-browser","3.search\u002F6.from-the-browser",{"title":100,"path":101,"stem":102},"Your own search client","\u002Fsearch\u002Fyour-own-client","3.search\u002F7.your-own-client",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":26},"Integrations","i-heroicons-puzzle-piece","\u002Fintegrations","4.integrations",[109],{"title":110,"path":111,"stem":112},"laravel-rest-api","\u002Fintegrations\u002Flaravel-rest-api","4.integrations\u002F1.laravel-rest-api",{"title":114,"icon":115,"path":116,"stem":117,"children":118,"page":26},"Testing and Tooling","i-heroicons-wrench-screwdriver","\u002Ftesting-and-tooling","5.testing-and-tooling",[119,123,127,131],{"title":120,"path":121,"stem":122},"Testing","\u002Ftesting-and-tooling\u002Ftesting","5.testing-and-tooling\u002F1.testing",{"title":124,"path":125,"stem":126},"access:check","\u002Ftesting-and-tooling\u002Faccess-check","5.testing-and-tooling\u002F2.access-check",{"title":128,"path":129,"stem":130},"Cache and about","\u002Ftesting-and-tooling\u002Fcache-and-about","5.testing-and-tooling\u002F3.cache-and-about",{"title":132,"path":133,"stem":134},"Generators","\u002Ftesting-and-tooling\u002Fgenerators","5.testing-and-tooling\u002F4.generators",{"title":136,"icon":137,"path":138,"stem":139,"children":140,"page":26},"Digging Deeper","i-heroicons-list-bullet","\u002Fdigging-deeper","6.digging-deeper",[141,145,149,153,157,161,165,169],{"title":142,"path":143,"stem":144},"Abilities","\u002Fdigging-deeper\u002Fabilities","6.digging-deeper\u002F1.abilities",{"title":146,"path":147,"stem":148},"Kept decisions","\u002Fdigging-deeper\u002Fdecisions","6.digging-deeper\u002F2.decisions",{"title":150,"path":151,"stem":152},"Batched decisions","\u002Fdigging-deeper\u002Fbatched-decisions","6.digging-deeper\u002F3.batched-decisions",{"title":154,"path":155,"stem":156},"Row checks","\u002Fdigging-deeper\u002Frow-checks","6.digging-deeper\u002F4.row-checks",{"title":158,"path":159,"stem":160},"Several brands","\u002Fdigging-deeper\u002Fseveral-brands","6.digging-deeper\u002F5.several-brands",{"title":162,"path":163,"stem":164},"Row context","\u002Fdigging-deeper\u002Frow-context","6.digging-deeper\u002F6.row-context",{"title":166,"path":167,"stem":168},"What is public in 1.x","\u002Fdigging-deeper\u002Fpublic-api","6.digging-deeper\u002F7.public-api",{"title":170,"path":171,"stem":172},"Use with AI","\u002Fdigging-deeper\u002Fuse-with-ai","6.digging-deeper\u002F8.use-with-ai",{"id":174,"title":42,"body":175,"description":1556,"extension":1557,"links":1558,"meta":1559,"navigation":262,"path":43,"seo":1560,"sitemap":1561,"stem":44,"updatedAt":1562,"__hash__":1563},"docs\u002F2.essentials\u002F3.perimeter-classes.md",{"type":176,"value":177,"toc":1551},"minimark",[178,183,192,220,227,313,335,339,342,361,897,950,1019,1023,1030,1431,1521,1547],[179,180,182],"h2",{"id":181},"generating-a-perimeter-class","Generating a perimeter class",[184,185,186,187,191],"p",{},"A perimeter is an instance of a class that extends ",[188,189,190],"code",{},"Lomkit\\Access\\Perimeters\\Perimeter",":",[193,194,199],"pre",{"className":195,"code":196,"language":197,"meta":198,"style":198},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","php artisan make:perimeter ClientPerimeter\n","bash","",[188,200,201],{"__ignoreMap":198},[202,203,206,210,214,217],"span",{"class":204,"line":205},"line",1,[202,207,209],{"class":208},"sBMFI","php",[202,211,213],{"class":212},"sfazB"," artisan",[202,215,216],{"class":212}," make:perimeter",[202,218,219],{"class":212}," ClientPerimeter\n",[184,221,222,223,226],{},"The class lands in ",[188,224,225],{},"app\u002FAccess\u002FPerimeters",", empty:",[193,228,232],{"className":229,"code":230,"filename":231,"language":209,"meta":198,"style":198},"language-php shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","namespace App\\Access\\Perimeters;\n\nuse Lomkit\\Access\\Perimeters\\Perimeter;\n\nclass ClientPerimeter extends Perimeter {}\n","app\u002FAccess\u002FPerimeters\u002FClientPerimeter.php",[188,233,234,257,264,289,294],{"__ignoreMap":198},[202,235,236,240,243,247,250,252,254],{"class":204,"line":205},[202,237,239],{"class":238},"sbssI","namespace",[202,241,242],{"class":208}," App",[202,244,246],{"class":245},"sMK4o","\\",[202,248,249],{"class":208},"Access",[202,251,246],{"class":245},[202,253,38],{"class":208},[202,255,256],{"class":245},";\n",[202,258,260],{"class":204,"line":259},2,[202,261,263],{"emptyLinePlaceholder":262},true,"\n",[202,265,267,270,274,276,278,280,282,284,287],{"class":204,"line":266},3,[202,268,269],{"class":238},"use",[202,271,273],{"class":272},"sTEyZ"," Lomkit",[202,275,246],{"class":245},[202,277,249],{"class":272},[202,279,246],{"class":245},[202,281,38],{"class":272},[202,283,246],{"class":245},[202,285,286],{"class":272},"Perimeter",[202,288,256],{"class":245},[202,290,292],{"class":204,"line":291},4,[202,293,263],{"emptyLinePlaceholder":262},[202,295,297,301,304,307,310],{"class":204,"line":296},5,[202,298,300],{"class":299},"spNyl","class",[202,302,303],{"class":208}," ClientPerimeter",[202,305,306],{"class":299}," extends",[202,308,309],{"class":208}," Perimeter",[202,311,312],{"class":245}," {}\n",[184,314,315,316,319,320,323,324,327,328,331,332,334],{},"Its rules are the callbacks that the control declares, ",[188,317,318],{},"allowed()",", ",[188,321,322],{},"should()"," and ",[188,325,326],{},"query()",", as ",[329,330,38],"a",{"href":39}," shows. The class names the rule, in ",[188,333,124],{}," and in the errors.",[179,336,338],{"id":337},"rules-in-the-class","Rules in the class",[184,340,341],{},"A rule shared by several controls can live in the class instead, in three protected hooks:",[193,343,345],{"className":195,"code":344,"language":197,"meta":198,"style":198},"php artisan make:perimeter EditorialPerimeter --hooks\n",[188,346,347],{"__ignoreMap":198},[202,348,349,351,353,355,358],{"class":204,"line":205},[202,350,209],{"class":208},[202,352,213],{"class":212},[202,354,216],{"class":212},[202,356,357],{"class":212}," EditorialPerimeter",[202,359,360],{"class":212}," --hooks\n",[193,362,365],{"className":229,"code":363,"filename":364,"language":209,"meta":198,"style":198},"namespace App\\Access\\Perimeters;\n\nuse App\\Models\\User;\nuse Illuminate\\Database\\Eloquent\\Builder;\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Lomkit\\Access\\AccessContext;\nuse Lomkit\\Access\\Perimeters\\Perimeter;\n\nclass EditorialPerimeter extends Perimeter\n{\n    protected function allows(AccessContext $context): bool\n    {\n        $reader = $context->reader();\n\n        return $reader instanceof User\n            && $reader->client_id !== null\n            && $reader->can(\"{$context->ability()} editorial posts\");\n    }\n\n    protected function includes(Model $row, AccessContext $context): bool\n    {\n        $reader = $context->reader();\n\n        return $reader instanceof User && $row->client_id === $reader->client_id;\n    }\n\n    protected function scope(Builder $query, AccessContext $context): void\n    {\n        $reader = $context->reader();\n\n        $query->where('client_id', $reader instanceof User ? $reader->client_id : 0);\n    }\n}\n","app\u002FAccess\u002FPerimeters\u002FEditorialPerimeter.php",[188,366,367,383,387,405,429,450,468,489,494,506,512,542,548,573,578,595,616,654,660,665,698,703,722,727,766,771,776,808,813,832,837,886,891],{"__ignoreMap":198},[202,368,369,371,373,375,377,379,381],{"class":204,"line":205},[202,370,239],{"class":238},[202,372,242],{"class":208},[202,374,246],{"class":245},[202,376,249],{"class":208},[202,378,246],{"class":245},[202,380,38],{"class":208},[202,382,256],{"class":245},[202,384,385],{"class":204,"line":259},[202,386,263],{"emptyLinePlaceholder":262},[202,388,389,391,393,395,398,400,403],{"class":204,"line":266},[202,390,269],{"class":238},[202,392,242],{"class":272},[202,394,246],{"class":245},[202,396,397],{"class":272},"Models",[202,399,246],{"class":245},[202,401,402],{"class":272},"User",[202,404,256],{"class":245},[202,406,407,409,412,414,417,419,422,424,427],{"class":204,"line":291},[202,408,269],{"class":238},[202,410,411],{"class":272}," Illuminate",[202,413,246],{"class":245},[202,415,416],{"class":272},"Database",[202,418,246],{"class":245},[202,420,421],{"class":272},"Eloquent",[202,423,246],{"class":245},[202,425,426],{"class":272},"Builder",[202,428,256],{"class":245},[202,430,431,433,435,437,439,441,443,445,448],{"class":204,"line":296},[202,432,269],{"class":238},[202,434,411],{"class":272},[202,436,246],{"class":245},[202,438,416],{"class":272},[202,440,246],{"class":245},[202,442,421],{"class":272},[202,444,246],{"class":245},[202,446,447],{"class":272},"Model",[202,449,256],{"class":245},[202,451,453,455,457,459,461,463,466],{"class":204,"line":452},6,[202,454,269],{"class":238},[202,456,273],{"class":272},[202,458,246],{"class":245},[202,460,249],{"class":272},[202,462,246],{"class":245},[202,464,465],{"class":272},"AccessContext",[202,467,256],{"class":245},[202,469,471,473,475,477,479,481,483,485,487],{"class":204,"line":470},7,[202,472,269],{"class":238},[202,474,273],{"class":272},[202,476,246],{"class":245},[202,478,249],{"class":272},[202,480,246],{"class":245},[202,482,38],{"class":272},[202,484,246],{"class":245},[202,486,286],{"class":272},[202,488,256],{"class":245},[202,490,492],{"class":204,"line":491},8,[202,493,263],{"emptyLinePlaceholder":262},[202,495,497,499,501,503],{"class":204,"line":496},9,[202,498,300],{"class":299},[202,500,357],{"class":208},[202,502,306],{"class":299},[202,504,505],{"class":208}," Perimeter\n",[202,507,509],{"class":204,"line":508},10,[202,510,511],{"class":245},"{\n",[202,513,515,518,521,525,528,530,533,536,539],{"class":204,"line":514},11,[202,516,517],{"class":299},"    protected",[202,519,520],{"class":299}," function",[202,522,524],{"class":523},"s2Zo4"," allows",[202,526,527],{"class":245},"(",[202,529,465],{"class":208},[202,531,532],{"class":245}," $",[202,534,535],{"class":272},"context",[202,537,538],{"class":245},"):",[202,540,541],{"class":238}," bool\n",[202,543,545],{"class":204,"line":544},12,[202,546,547],{"class":245},"    {\n",[202,549,551,554,557,560,562,564,567,570],{"class":204,"line":550},13,[202,552,553],{"class":245},"        $",[202,555,556],{"class":272},"reader ",[202,558,559],{"class":245},"=",[202,561,532],{"class":245},[202,563,535],{"class":272},[202,565,566],{"class":245},"->",[202,568,569],{"class":523},"reader",[202,571,572],{"class":245},"();\n",[202,574,576],{"class":204,"line":575},14,[202,577,263],{"emptyLinePlaceholder":262},[202,579,581,585,587,589,592],{"class":204,"line":580},15,[202,582,584],{"class":583},"s7zQu","        return",[202,586,532],{"class":245},[202,588,556],{"class":272},[202,590,591],{"class":245},"instanceof",[202,593,594],{"class":208}," User\n",[202,596,598,601,603,605,607,610,613],{"class":204,"line":597},16,[202,599,600],{"class":245},"            &&",[202,602,532],{"class":245},[202,604,569],{"class":272},[202,606,566],{"class":245},[202,608,609],{"class":272},"client_id ",[202,611,612],{"class":245},"!==",[202,614,615],{"class":245}," null\n",[202,617,619,621,623,625,627,630,632,635,637,639,642,645,648,651],{"class":204,"line":618},17,[202,620,600],{"class":245},[202,622,532],{"class":245},[202,624,569],{"class":272},[202,626,566],{"class":245},[202,628,629],{"class":523},"can",[202,631,527],{"class":245},[202,633,634],{"class":245},"\"{$",[202,636,535],{"class":272},[202,638,566],{"class":245},[202,640,641],{"class":523},"ability",[202,643,644],{"class":245},"()}",[202,646,647],{"class":212}," editorial posts",[202,649,650],{"class":245},"\"",[202,652,653],{"class":245},");\n",[202,655,657],{"class":204,"line":656},18,[202,658,659],{"class":245},"    }\n",[202,661,663],{"class":204,"line":662},19,[202,664,263],{"emptyLinePlaceholder":262},[202,666,668,670,672,675,677,679,681,684,687,690,692,694,696],{"class":204,"line":667},20,[202,669,517],{"class":299},[202,671,520],{"class":299},[202,673,674],{"class":523}," includes",[202,676,527],{"class":245},[202,678,447],{"class":208},[202,680,532],{"class":245},[202,682,683],{"class":272},"row",[202,685,686],{"class":245},",",[202,688,689],{"class":208}," AccessContext",[202,691,532],{"class":245},[202,693,535],{"class":272},[202,695,538],{"class":245},[202,697,541],{"class":238},[202,699,701],{"class":204,"line":700},21,[202,702,547],{"class":245},[202,704,706,708,710,712,714,716,718,720],{"class":204,"line":705},22,[202,707,553],{"class":245},[202,709,556],{"class":272},[202,711,559],{"class":245},[202,713,532],{"class":245},[202,715,535],{"class":272},[202,717,566],{"class":245},[202,719,569],{"class":523},[202,721,572],{"class":245},[202,723,725],{"class":204,"line":724},23,[202,726,263],{"emptyLinePlaceholder":262},[202,728,730,732,734,736,738,741,744,746,748,750,752,755,757,759,761,764],{"class":204,"line":729},24,[202,731,584],{"class":583},[202,733,532],{"class":245},[202,735,556],{"class":272},[202,737,591],{"class":245},[202,739,740],{"class":208}," User",[202,742,743],{"class":245}," &&",[202,745,532],{"class":245},[202,747,683],{"class":272},[202,749,566],{"class":245},[202,751,609],{"class":272},[202,753,754],{"class":245},"===",[202,756,532],{"class":245},[202,758,569],{"class":272},[202,760,566],{"class":245},[202,762,763],{"class":272},"client_id",[202,765,256],{"class":245},[202,767,769],{"class":204,"line":768},25,[202,770,659],{"class":245},[202,772,774],{"class":204,"line":773},26,[202,775,263],{"emptyLinePlaceholder":262},[202,777,779,781,783,786,788,790,792,795,797,799,801,803,805],{"class":204,"line":778},27,[202,780,517],{"class":299},[202,782,520],{"class":299},[202,784,785],{"class":523}," scope",[202,787,527],{"class":245},[202,789,426],{"class":208},[202,791,532],{"class":245},[202,793,794],{"class":272},"query",[202,796,686],{"class":245},[202,798,689],{"class":208},[202,800,532],{"class":245},[202,802,535],{"class":272},[202,804,538],{"class":245},[202,806,807],{"class":238}," void\n",[202,809,811],{"class":204,"line":810},28,[202,812,547],{"class":245},[202,814,816,818,820,822,824,826,828,830],{"class":204,"line":815},29,[202,817,553],{"class":245},[202,819,556],{"class":272},[202,821,559],{"class":245},[202,823,532],{"class":245},[202,825,535],{"class":272},[202,827,566],{"class":245},[202,829,569],{"class":523},[202,831,572],{"class":245},[202,833,835],{"class":204,"line":834},30,[202,836,263],{"emptyLinePlaceholder":262},[202,838,840,842,844,846,849,851,854,856,858,860,862,864,866,868,871,873,875,877,879,881,884],{"class":204,"line":839},31,[202,841,553],{"class":245},[202,843,794],{"class":272},[202,845,566],{"class":245},[202,847,848],{"class":523},"where",[202,850,527],{"class":245},[202,852,853],{"class":245},"'",[202,855,763],{"class":212},[202,857,853],{"class":245},[202,859,686],{"class":245},[202,861,532],{"class":245},[202,863,556],{"class":272},[202,865,591],{"class":245},[202,867,740],{"class":208},[202,869,870],{"class":245}," ?",[202,872,532],{"class":245},[202,874,569],{"class":272},[202,876,566],{"class":245},[202,878,609],{"class":272},[202,880,191],{"class":245},[202,882,883],{"class":238}," 0",[202,885,653],{"class":245},[202,887,889],{"class":204,"line":888},32,[202,890,659],{"class":245},[202,892,894],{"class":204,"line":893},33,[202,895,896],{"class":245},"}\n",[898,899,900,913],"table",{},[901,902,903],"thead",{},[904,905,906,910],"tr",{},[907,908,909],"th",{},"Hook",[907,911,912],{},"Callback it replaces",[914,915,916,928,939],"tbody",{},[904,917,918,924],{},[919,920,921],"td",{},[188,922,923],{},"allows(AccessContext $context): bool",[919,925,926],{},[188,927,318],{},[904,929,930,935],{},[919,931,932],{},[188,933,934],{},"includes(Model $row, AccessContext $context): bool",[919,936,937],{},[188,938,322],{},[904,940,941,946],{},[919,942,943],{},[188,944,945],{},"scope(Builder $query, AccessContext $context): void",[919,947,948],{},[188,949,326],{},[951,952,953,974,991,1000,1007],"ul",{},[954,955,956,957,959,960,963,964,966,967,969,970,973],"li",{},"Each hook receives an ",[188,958,465],{},": ",[188,961,962],{},"reader()"," gives the reader, typed ",[188,965,447],{},", so check its class with ",[188,968,591],{},"; ",[188,971,972],{},"ability()"," gives the ability.",[954,975,976,979,980,323,983,986,987,990],{},[188,977,978],{},"allows()"," refuses a reader without a client, so that ",[188,981,982],{},"includes()",[188,984,985],{},"scope()"," never compare with a ",[188,988,989],{},"null"," client.",[954,992,993,996,997,999],{},[188,994,995],{},"--hooks"," generates the three hooks, which refuse everything until you write them. Remove ",[188,998,982],{}," to check the rows in SQL.",[954,1001,1002,1003,1006],{},"A rule is written once: declaring in the control the callback of a hook that the class overrides throws ",[188,1004,1005],{},"OverriddenPerimeterHookException",".",[954,1008,1009,1010,1013,1014,1016,1017,1006],{},"The control lists the class with ",[188,1011,1012],{},"EditorialPerimeter::new()",", and may still add ",[188,1015,318],{}," when the class does not override ",[188,1018,978],{},[179,1020,1022],{"id":1021},"variants-of-a-class","Variants of a class",[184,1024,1025,1026,1029],{},"A class that needs a value for each use, such as the kind of document, keeps it as private state that every hook reads. A required value goes in a constructor with ",[188,1027,1028],{},"readonly"," promoted properties, behind a named static constructor:",[193,1031,1034],{"className":229,"code":1032,"filename":1033,"language":209,"meta":198,"style":198},"namespace App\\Access\\Perimeters;\n\nuse Illuminate\\Database\\Eloquent\\Builder;\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Lomkit\\Access\\AccessContext;\nuse Lomkit\\Access\\Perimeters\\Perimeter;\n\nfinal class OwnedDocuments extends Perimeter\n{\n    private function __construct(private readonly string $kind) {}\n\n    public static function ofKind(string $kind): self\n    {\n        return new self($kind);\n    }\n\n    protected function includes(Model $row, AccessContext $context): bool\n    {\n        return $row->kind === $this->kind && $row->owner_id === $context->reader()->getKey();\n    }\n\n    protected function scope(Builder $query, AccessContext $context): void\n    {\n        $query->where('kind', $this->kind)->where('owner_id', $context->reader()->getKey());\n    }\n}\n","app\u002FAccess\u002FPerimeters\u002FOwnedDocuments.php",[188,1035,1036,1052,1056,1076,1096,1112,1132,1136,1151,1155,1186,1190,1217,1221,1238,1242,1246,1274,1278,1328,1332,1336,1364,1368,1423,1427],{"__ignoreMap":198},[202,1037,1038,1040,1042,1044,1046,1048,1050],{"class":204,"line":205},[202,1039,239],{"class":238},[202,1041,242],{"class":208},[202,1043,246],{"class":245},[202,1045,249],{"class":208},[202,1047,246],{"class":245},[202,1049,38],{"class":208},[202,1051,256],{"class":245},[202,1053,1054],{"class":204,"line":259},[202,1055,263],{"emptyLinePlaceholder":262},[202,1057,1058,1060,1062,1064,1066,1068,1070,1072,1074],{"class":204,"line":266},[202,1059,269],{"class":238},[202,1061,411],{"class":272},[202,1063,246],{"class":245},[202,1065,416],{"class":272},[202,1067,246],{"class":245},[202,1069,421],{"class":272},[202,1071,246],{"class":245},[202,1073,426],{"class":272},[202,1075,256],{"class":245},[202,1077,1078,1080,1082,1084,1086,1088,1090,1092,1094],{"class":204,"line":291},[202,1079,269],{"class":238},[202,1081,411],{"class":272},[202,1083,246],{"class":245},[202,1085,416],{"class":272},[202,1087,246],{"class":245},[202,1089,421],{"class":272},[202,1091,246],{"class":245},[202,1093,447],{"class":272},[202,1095,256],{"class":245},[202,1097,1098,1100,1102,1104,1106,1108,1110],{"class":204,"line":296},[202,1099,269],{"class":238},[202,1101,273],{"class":272},[202,1103,246],{"class":245},[202,1105,249],{"class":272},[202,1107,246],{"class":245},[202,1109,465],{"class":272},[202,1111,256],{"class":245},[202,1113,1114,1116,1118,1120,1122,1124,1126,1128,1130],{"class":204,"line":452},[202,1115,269],{"class":238},[202,1117,273],{"class":272},[202,1119,246],{"class":245},[202,1121,249],{"class":272},[202,1123,246],{"class":245},[202,1125,38],{"class":272},[202,1127,246],{"class":245},[202,1129,286],{"class":272},[202,1131,256],{"class":245},[202,1133,1134],{"class":204,"line":470},[202,1135,263],{"emptyLinePlaceholder":262},[202,1137,1138,1141,1144,1147,1149],{"class":204,"line":491},[202,1139,1140],{"class":299},"final",[202,1142,1143],{"class":299}," class",[202,1145,1146],{"class":208}," OwnedDocuments",[202,1148,306],{"class":299},[202,1150,505],{"class":208},[202,1152,1153],{"class":204,"line":496},[202,1154,511],{"class":245},[202,1156,1157,1160,1162,1165,1167,1170,1173,1176,1178,1181,1184],{"class":204,"line":508},[202,1158,1159],{"class":299},"    private",[202,1161,520],{"class":299},[202,1163,1164],{"class":523}," __construct",[202,1166,527],{"class":245},[202,1168,1169],{"class":299},"private",[202,1171,1172],{"class":299}," readonly",[202,1174,1175],{"class":238}," string",[202,1177,532],{"class":245},[202,1179,1180],{"class":272},"kind",[202,1182,1183],{"class":245},")",[202,1185,312],{"class":245},[202,1187,1188],{"class":204,"line":514},[202,1189,263],{"emptyLinePlaceholder":262},[202,1191,1192,1195,1198,1200,1203,1205,1208,1210,1212,1214],{"class":204,"line":544},[202,1193,1194],{"class":299},"    public",[202,1196,1197],{"class":299}," static",[202,1199,520],{"class":299},[202,1201,1202],{"class":523}," ofKind",[202,1204,527],{"class":245},[202,1206,1207],{"class":238},"string",[202,1209,532],{"class":245},[202,1211,1180],{"class":272},[202,1213,538],{"class":245},[202,1215,1216],{"class":299}," self\n",[202,1218,1219],{"class":204,"line":550},[202,1220,547],{"class":245},[202,1222,1223,1225,1228,1231,1234,1236],{"class":204,"line":575},[202,1224,584],{"class":583},[202,1226,1227],{"class":238}," new",[202,1229,1230],{"class":299}," self",[202,1232,1233],{"class":245},"($",[202,1235,1180],{"class":272},[202,1237,653],{"class":245},[202,1239,1240],{"class":204,"line":580},[202,1241,659],{"class":245},[202,1243,1244],{"class":204,"line":597},[202,1245,263],{"emptyLinePlaceholder":262},[202,1247,1248,1250,1252,1254,1256,1258,1260,1262,1264,1266,1268,1270,1272],{"class":204,"line":618},[202,1249,517],{"class":299},[202,1251,520],{"class":299},[202,1253,674],{"class":523},[202,1255,527],{"class":245},[202,1257,447],{"class":208},[202,1259,532],{"class":245},[202,1261,683],{"class":272},[202,1263,686],{"class":245},[202,1265,689],{"class":208},[202,1267,532],{"class":245},[202,1269,535],{"class":272},[202,1271,538],{"class":245},[202,1273,541],{"class":238},[202,1275,1276],{"class":204,"line":656},[202,1277,547],{"class":245},[202,1279,1280,1282,1284,1286,1288,1291,1293,1296,1298,1301,1303,1305,1307,1310,1312,1314,1316,1318,1320,1323,1326],{"class":204,"line":662},[202,1281,584],{"class":583},[202,1283,532],{"class":245},[202,1285,683],{"class":272},[202,1287,566],{"class":245},[202,1289,1290],{"class":272},"kind ",[202,1292,754],{"class":245},[202,1294,1295],{"class":245}," $this->",[202,1297,1290],{"class":272},[202,1299,1300],{"class":245},"&&",[202,1302,532],{"class":245},[202,1304,683],{"class":272},[202,1306,566],{"class":245},[202,1308,1309],{"class":272},"owner_id ",[202,1311,754],{"class":245},[202,1313,532],{"class":245},[202,1315,535],{"class":272},[202,1317,566],{"class":245},[202,1319,569],{"class":523},[202,1321,1322],{"class":245},"()->",[202,1324,1325],{"class":523},"getKey",[202,1327,572],{"class":245},[202,1329,1330],{"class":204,"line":667},[202,1331,659],{"class":245},[202,1333,1334],{"class":204,"line":700},[202,1335,263],{"emptyLinePlaceholder":262},[202,1337,1338,1340,1342,1344,1346,1348,1350,1352,1354,1356,1358,1360,1362],{"class":204,"line":705},[202,1339,517],{"class":299},[202,1341,520],{"class":299},[202,1343,785],{"class":523},[202,1345,527],{"class":245},[202,1347,426],{"class":208},[202,1349,532],{"class":245},[202,1351,794],{"class":272},[202,1353,686],{"class":245},[202,1355,689],{"class":208},[202,1357,532],{"class":245},[202,1359,535],{"class":272},[202,1361,538],{"class":245},[202,1363,807],{"class":238},[202,1365,1366],{"class":204,"line":724},[202,1367,547],{"class":245},[202,1369,1370,1372,1374,1376,1378,1380,1382,1384,1386,1388,1390,1392,1395,1397,1399,1401,1404,1406,1408,1410,1412,1414,1416,1418,1420],{"class":204,"line":729},[202,1371,553],{"class":245},[202,1373,794],{"class":272},[202,1375,566],{"class":245},[202,1377,848],{"class":523},[202,1379,527],{"class":245},[202,1381,853],{"class":245},[202,1383,1180],{"class":212},[202,1385,853],{"class":245},[202,1387,686],{"class":245},[202,1389,1295],{"class":245},[202,1391,1180],{"class":272},[202,1393,1394],{"class":245},")->",[202,1396,848],{"class":523},[202,1398,527],{"class":245},[202,1400,853],{"class":245},[202,1402,1403],{"class":212},"owner_id",[202,1405,853],{"class":245},[202,1407,686],{"class":245},[202,1409,532],{"class":245},[202,1411,535],{"class":272},[202,1413,566],{"class":245},[202,1415,569],{"class":523},[202,1417,1322],{"class":245},[202,1419,1325],{"class":523},[202,1421,1422],{"class":245},"());\n",[202,1424,1425],{"class":204,"line":768},[202,1426,659],{"class":245},[202,1428,1429],{"class":204,"line":773},[202,1430,896],{"class":245},[193,1432,1434],{"className":229,"code":1433,"language":209,"meta":198,"style":198},"OwnedDocuments::ofKind('invoice')\n    ->allowed(fn (User $user, Ability $ability) => $user->can(\"{$ability} own invoices\"));\n",[188,1435,1436,1459],{"__ignoreMap":198},[202,1437,1438,1441,1444,1447,1449,1451,1454,1456],{"class":204,"line":205},[202,1439,1440],{"class":208},"OwnedDocuments",[202,1442,1443],{"class":245},"::",[202,1445,1446],{"class":523},"ofKind",[202,1448,527],{"class":245},[202,1450,853],{"class":245},[202,1452,1453],{"class":212},"invoice",[202,1455,853],{"class":245},[202,1457,1458],{"class":245},")\n",[202,1460,1461,1464,1467,1469,1472,1475,1477,1479,1482,1484,1487,1489,1491,1493,1496,1498,1500,1502,1504,1506,1508,1510,1513,1516,1518],{"class":204,"line":259},[202,1462,1463],{"class":245},"    ->",[202,1465,1466],{"class":523},"allowed",[202,1468,527],{"class":245},[202,1470,1471],{"class":299},"fn",[202,1473,1474],{"class":245}," (",[202,1476,402],{"class":208},[202,1478,532],{"class":245},[202,1480,1481],{"class":272},"user",[202,1483,686],{"class":245},[202,1485,1486],{"class":208}," Ability",[202,1488,532],{"class":245},[202,1490,641],{"class":272},[202,1492,1183],{"class":245},[202,1494,1495],{"class":245}," =>",[202,1497,532],{"class":245},[202,1499,1481],{"class":272},[202,1501,566],{"class":245},[202,1503,629],{"class":523},[202,1505,527],{"class":245},[202,1507,634],{"class":245},[202,1509,641],{"class":272},[202,1511,1512],{"class":245},"}",[202,1514,1515],{"class":212}," own invoices",[202,1517,650],{"class":245},[202,1519,1520],{"class":245},"));\n",[951,1522,1523,1526,1535,1541],{},[954,1524,1525],{},"Call the named constructor first: the fluent methods clone the perimeter and keep its state.",[954,1527,1528,1531,1532,1006],{},[188,1529,1530],{},"X::new()"," on a class whose constructor requires arguments, or is not public, throws ",[188,1533,1534],{},"UnbuildablePerimeterException",[954,1536,1537,1538,1006],{},"Build the state from constants, never from the request or the user: the control keeps its perimeters for the whole process. See ",[329,1539,34],{"href":1540},"\u002Fessentials\u002Fcontrols#pure-perimeter-lists",[954,1542,1543,1544,1546],{},"Never narrow a class with a second ",[188,1545,326],{},", or by wrapping it in another perimeter: the package reads only what each perimeter of the list declares.",[1548,1549,1550],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}",{"title":198,"searchDepth":205,"depth":259,"links":1552},[1553,1554,1555],{"id":181,"depth":259,"text":182},{"id":337,"depth":259,"text":338},{"id":1021,"depth":259,"text":1022},"Every perimeter is a class of your application. Keep its rules as callbacks in the control, or write them once in the class, with protected hooks and variants.","md",null,{},{"title":42,"description":1556},{"loc":43,"lastmod":1562},"2026-11-21T15:24:08+01:00","CCqlAiCjLEbAUi3Z9RVjMYnxGoTcmuT8p8DzvNFxUfM",[1565,1567],{"title":38,"path":39,"stem":40,"description":1566,"children":-1},"A perimeter is one access rule of a control. allowed() is the permission, query() gives the rows for the lists, should() checks one row.",{"title":46,"path":47,"stem":48,"description":1568,"children":-1},"Levels::of() declares a hierarchy of perimeters, widest first, where only the highest level a user reaches applies. Perimeters outside a group add up.",1795277181228]